AWS cli high security documentation change
Summary
Added documentation for C2PA manifest generation, certificate management via Secrets Manager, and KMS key usage for signing. Added FrameControl parameter for video passthrough clipping.
Security assessment
The changes introduce C2PA manifest signing capabilities using AWS KMS and Secrets Manager, which are security features for content authenticity verification. The CertificateSecret parameter handles sensitive certificate storage, and SigningKmsKey enforces cryptographic signing - both critical for ensuring media integrity and preventing tampering.
Diff
diff --git a/cli/latest/reference/mediaconvert/create-preset.md b/cli/latest/reference/mediaconvert/create-preset.md index 8a68c1ff1..e2fd6cea4 100644 --- a//cli/latest/reference/mediaconvert/create-preset.md +++ b//cli/latest/reference/mediaconvert/create-preset.md @@ -15 +15 @@ - * [AWS CLI 2.31.35 Command Reference](../../index.html) » + * [AWS CLI 2.31.37 Command Reference](../../index.html) » @@ -2738,0 +2739,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_\/_+=.@-]*$` +>>>> + @@ -2804,0 +2828,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}$` +>>>> + @@ -3853,0 +3888,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` +>>>> + @@ -3864,0 +3910,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_\/_+=.@-]*$` +>>>> + @@ -3908,0 +3966,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}$` +>>>> + @@ -6064,0 +6133,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` +>>>>> + @@ -8432,0 +8512,2 @@ JSON Syntax: + "C2paManifest": "INCLUDE"|"EXCLUDE", + "CertificateSecret": "string", @@ -8438,0 +8520 @@ JSON Syntax: + "SigningKmsKey": "string", @@ -8550,0 +8633 @@ JSON Syntax: + "C2paManifest": "INCLUDE"|"EXCLUDE", @@ -8551,0 +8635 @@ JSON Syntax: + "CertificateSecret": "string", @@ -8555,0 +8640 @@ JSON Syntax: + "SigningKmsKey": "string", @@ -8768,0 +8854 @@ JSON Syntax: + "FrameControl": "NEAREST_IDRFRAME"|"NEAREST_IFRAME", @@ -11819,0 +11906,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_\/_+=.@-]*$` +>>>>> + @@ -11885,0 +11995,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}$` +>>>>> + @@ -12934,0 +13055,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` +>>>>> + @@ -12945,0 +13077,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_\/_+=.@-]*$` +>>>>> + @@ -12989,0 +13133,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}$` +>>>>> + @@ -15145,0 +15300,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` +>>>>>> + @@ -17275 +17440 @@ Preset -> (structure) - * [AWS CLI 2.31.35 Command Reference](../../index.html) » + * [AWS CLI 2.31.37 Command Reference](../../index.html) »