AWS cli high security documentation change
Summary
Added documentation for C2PA manifest generation, CertificateSecret parameter for Secrets Manager integration, and SigningKmsKey parameter for KMS-based signing of C2PA manifests
Security assessment
The changes introduce security-related parameters for digital content authenticity (C2PA compliance), certificate management through AWS Secrets Manager, and cryptographic signing using AWS KMS. These features directly relate to content integrity verification and secure cryptographic operations, which are security controls.
Diff
diff --git a/cli/latest/reference/mediaconvert/update-preset.md b/cli/latest/reference/mediaconvert/update-preset.md index 7af712d9a..33b21156e 100644 --- a//cli/latest/reference/mediaconvert/update-preset.md +++ b//cli/latest/reference/mediaconvert/update-preset.md @@ -15 +15 @@ - * [AWS CLI 2.31.35 Command Reference](../../index.html) » + * [AWS CLI 2.31.37 Command Reference](../../index.html) » @@ -2737,0 +2738,23 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/mediac +>>> +>>> C2paManifest -> (string) +>>> +>>>> When enabled, a C2PA compliant manifest will be generated, signed and embeded in the output. For more information on C2PA, see <https://c2pa.org/specifications/specifications/2.1/index.html> +>>>> +>>>> Possible values: +>>>> +>>>> * `INCLUDE` +>>>> * `EXCLUDE` +>>>> + +>>> +>>> CertificateSecret -> (string) +>>> +>>>> Specify the name or ARN of the AWS Secrets Manager secret that contains your C2PA public certificate chain in PEM format. Provide a valid secret name or ARN. Note that your MediaConvert service role must allow access to this secret. The public certificate chain is added to the COSE header (x5chain) for signature validation. Include the signer’s certificate and all intermediate certificates. Do not include the root certificate. For details on COSE, see: <https://opensource.contentauthenticity.org/docs/manifest/signing-manifests> +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `2048` +>>>> * pattern: `^(arn:[a-z-]+:secretsmanager:[\w-]+:\d{12}:secret:)?[a-zA-Z0-9_\/_+=.@-]*$` +>>>> + @@ -2803,0 +2827,11 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/mediac +>>> +>>> SigningKmsKey -> (string) +>>> +>>>> Specify the ID or ARN of the AWS KMS key used to sign the C2PA manifest in your MP4 output. Provide a valid KMS key ARN. Note that your MediaConvert service role must allow access to this key. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * pattern: `^(arn:aws(-us-gov|-cn)?:kms:[a-z-]{2,6}-(east|west|central|((north|south)(east|west)?))-[1-9]{1,2}:\d{12}:key/)?[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}|mrk-[a-fA-F0-9]{32}$` +>>>> + @@ -3852,0 +3887,11 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/mediac +>>> +>>> C2paManifest -> (string) +>>> +>>>> When enabled, a C2PA compliant manifest will be generated, signed and embeded in the output. For more information on C2PA, see <https://c2pa.org/specifications/specifications/2.1/index.html> +>>>> +>>>> Possible values: +>>>> +>>>> * `INCLUDE` +>>>> * `EXCLUDE` +>>>> + @@ -3863,0 +3909,12 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/mediac +>>> +>>> CertificateSecret -> (string) +>>> +>>>> Specify the name or ARN of the AWS Secrets Manager secret that contains your C2PA public certificate chain in PEM format. Provide a valid secret name or ARN. Note that your MediaConvert service role must allow access to this secret. The public certificate chain is added to the COSE header (x5chain) for signature validation. Include the signer’s certificate and all intermediate certificates. Do not include the root certificate. For details on COSE, see: <https://opensource.contentauthenticity.org/docs/manifest/signing-manifests> +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `2048` +>>>> * pattern: `^(arn:[a-z-]+:secretsmanager:[\w-]+:\d{12}:secret:)?[a-zA-Z0-9_\/_+=.@-]*$` +>>>> + @@ -3907,0 +3965,11 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/mediac +>>> +>>> SigningKmsKey -> (string) +>>> +>>>> Specify the ID or ARN of the AWS KMS key used to sign the C2PA manifest in your MP4 output. Provide a valid KMS key ARN. Note that your MediaConvert service role must allow access to this key. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * pattern: `^(arn:aws(-us-gov|-cn)?:kms:[a-z-]{2,6}-(east|west|central|((north|south)(east|west)?))-[1-9]{1,2}:\d{12}:key/)?[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}|mrk-[a-fA-F0-9]{32}$` +>>>> + @@ -6063,0 +6132,11 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/mediac +>>>> +>>>> FrameControl -> (string) +>>>> +>>>>> Choose how MediaConvert handles start and end times for input clipping with video passthrough. Your input video codec must be H.264 or H.265 to use IFRAME. To clip at the nearest IDR-frame: Choose Nearest IDR. If an IDR-frame is not found at the frame that you specify, MediaConvert uses the next compatible IDR-frame. Note that your output may be shorter than your input clip duration. To clip at the nearest I-frame: Choose Nearest I-frame. If an I-frame is not found at the frame that you specify, MediaConvert uses the next compatible I-frame. Note that your output may be shorter than your input clip duration. We only recommend this setting for special workflows, and when you choose this setting your output may not be compatible with most players. +>>>>> +>>>>> Possible values: +>>>>> +>>>>> * `NEAREST_IDRFRAME` +>>>>> * `NEAREST_IFRAME` +>>>>> + @@ -8431,0 +8511,2 @@ JSON Syntax: + "C2paManifest": "INCLUDE"|"EXCLUDE", + "CertificateSecret": "string", @@ -8437,0 +8519 @@ JSON Syntax: + "SigningKmsKey": "string", @@ -8549,0 +8632 @@ JSON Syntax: + "C2paManifest": "INCLUDE"|"EXCLUDE", @@ -8550,0 +8634 @@ JSON Syntax: + "CertificateSecret": "string", @@ -8554,0 +8639 @@ JSON Syntax: + "SigningKmsKey": "string", @@ -8767,0 +8853 @@ JSON Syntax: + "FrameControl": "NEAREST_IDRFRAME"|"NEAREST_IFRAME", @@ -11816,0 +11903,23 @@ Preset -> (structure) +>>>> +>>>> C2paManifest -> (string) +>>>> +>>>>> When enabled, a C2PA compliant manifest will be generated, signed and embeded in the output. For more information on C2PA, see <https://c2pa.org/specifications/specifications/2.1/index.html> +>>>>> +>>>>> Possible values: +>>>>> +>>>>> * `INCLUDE` +>>>>> * `EXCLUDE` +>>>>> + +>>>> +>>>> CertificateSecret -> (string) +>>>> +>>>>> Specify the name or ARN of the AWS Secrets Manager secret that contains your C2PA public certificate chain in PEM format. Provide a valid secret name or ARN. Note that your MediaConvert service role must allow access to this secret. The public certificate chain is added to the COSE header (x5chain) for signature validation. Include the signer’s certificate and all intermediate certificates. Do not include the root certificate. For details on COSE, see: <https://opensource.contentauthenticity.org/docs/manifest/signing-manifests> +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `1` +>>>>> * max: `2048` +>>>>> * pattern: `^(arn:[a-z-]+:secretsmanager:[\w-]+:\d{12}:secret:)?[a-zA-Z0-9_\/_+=.@-]*$` +>>>>> + @@ -11882,0 +11992,11 @@ Preset -> (structure) +>>>> +>>>> SigningKmsKey -> (string) +>>>> +>>>>> Specify the ID or ARN of the AWS KMS key used to sign the C2PA manifest in your MP4 output. Provide a valid KMS key ARN. Note that your MediaConvert service role must allow access to this key. +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `1` +>>>>> * pattern: `^(arn:aws(-us-gov|-cn)?:kms:[a-z-]{2,6}-(east|west|central|((north|south)(east|west)?))-[1-9]{1,2}:\d{12}:key/)?[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}|mrk-[a-fA-F0-9]{32}$` +>>>>> + @@ -12931,0 +13052,11 @@ Preset -> (structure) +>>>> +>>>> C2paManifest -> (string) +>>>> +>>>>> When enabled, a C2PA compliant manifest will be generated, signed and embeded in the output. For more information on C2PA, see <https://c2pa.org/specifications/specifications/2.1/index.html> +>>>>> +>>>>> Possible values: +>>>>> +>>>>> * `INCLUDE` +>>>>> * `EXCLUDE` +>>>>> + @@ -12942,0 +13074,12 @@ Preset -> (structure) +>>>> +>>>> CertificateSecret -> (string) +>>>> +>>>>> Specify the name or ARN of the AWS Secrets Manager secret that contains your C2PA public certificate chain in PEM format. Provide a valid secret name or ARN. Note that your MediaConvert service role must allow access to this secret. The public certificate chain is added to the COSE header (x5chain) for signature validation. Include the signer’s certificate and all intermediate certificates. Do not include the root certificate. For details on COSE, see: <https://opensource.contentauthenticity.org/docs/manifest/signing-manifests> +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `1` +>>>>> * max: `2048` +>>>>> * pattern: `^(arn:[a-z-]+:secretsmanager:[\w-]+:\d{12}:secret:)?[a-zA-Z0-9_\/_+=.@-]*$` +>>>>> + @@ -12986,0 +13130,11 @@ Preset -> (structure) +>>>> +>>>> SigningKmsKey -> (string) +>>>> +>>>>> Specify the ID or ARN of the AWS KMS key used to sign the C2PA manifest in your MP4 output. Provide a valid KMS key ARN. Note that your MediaConvert service role must allow access to this key. +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `1` +>>>>> * pattern: `^(arn:aws(-us-gov|-cn)?:kms:[a-z-]{2,6}-(east|west|central|((north|south)(east|west)?))-[1-9]{1,2}:\d{12}:key/)?[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}|mrk-[a-fA-F0-9]{32}$` +>>>>> + @@ -15142,0 +15297,11 @@ Preset -> (structure) +>>>>> +>>>>> FrameControl -> (string) +>>>>> +>>>>>> Choose how MediaConvert handles start and end times for input clipping with video passthrough. Your input video codec must be H.264 or H.265 to use IFRAME. To clip at the nearest IDR-frame: Choose Nearest IDR. If an IDR-frame is not found at the frame that you specify, MediaConvert uses the next compatible IDR-frame. Note that your output may be shorter than your input clip duration. To clip at the nearest I-frame: Choose Nearest I-frame. If an I-frame is not found at the frame that you specify, MediaConvert uses the next compatible I-frame. Note that your output may be shorter than your input clip duration. We only recommend this setting for special workflows, and when you choose this setting your output may not be compatible with most players. +>>>>>> +>>>>>> Possible values: +>>>>>> +>>>>>> * `NEAREST_IDRFRAME` +>>>>>> * `NEAREST_IFRAME` +>>>>>> + @@ -17272 +17437 @@ Preset -> (structure) - * [AWS CLI 2.31.35 Command Reference](../../index.html) » + * [AWS CLI 2.31.37 Command Reference](../../index.html) »