Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comment autoriser ou interdire les types de localisation de saisie

AWS Elemental MediaConvert prend en charge les types d'emplacement d'entrée Amazon S3, HTTPS et HTTP pour vos supports et fichiers d'entrée. Vous pouvez autoriser ou interdire l'accès à un ou plusieurs de ces types d'emplacements d'entrée à l'aide d'une MediaConvert politique.

Par défaut, chaque région de votre AWS compte n'a pas de politique et MediaConvert autorise tous les types de localisation de saisie pris en charge. Vous n'avez besoin de créer une politique de saisie que si vous souhaitez interdire l'accès à un ou plusieurs de ces types d'emplacements d'entrée.

Pour empêcher l'exécution de tâches avec un type d'emplacement de saisie non autorisé, créez une politique de MediaConvert saisie.

En outre, pour empêcher la soumission de tâches à l' MediaConvert API si aucune politique d'entrée n'est en place, créez une politique IAM à l'aide de clés de condition. Vous pouvez appliquer ces politiques IAM aux rôles IAM au sein de votre organisation.

Les sections suivantes décrivent comment créer une politique d'entrée et comment utiliser les clés de condition IAM pour autoriser ou interdire les types d'emplacement d'entrée.

Comment autoriser ou interdire les types d'emplacement de saisie à l'aide d'une politique de saisie

Pour créer ou modifier une politique, soumettez une put-policy commande à l'aide de l'API, du SDK ou de l'interface de ligne de commande (CLI) et incluez la politique au format JSON. Consultez la référence des MediaConvert API pour en savoir plus sur les commandes de politique prises en charge et les codes de réponse attendus.

L'exemple suivant montre comment soumettre une politique à l'aide de l'interface de ligne de commande. Cet exemple autorise les tâches avec des entrées Amazon S3 et HTTPS, et interdit les tâches avec des entrées HTTP :

aws mediaconvert put-policy --policy '{"S3Inputs":"ALLOWED", "HttpsInputs":"ALLOWED", "HttpInputs":"DISALLOWED"}'

Si vous ne spécifiez pas d'emplacement d'entrée dans la politique JSON, l'emplacement d'entrée MediaConvert sera traité comme AUTORISÉ. Voici un autre exemple qui autorise les tâches avec des entrées Amazon S3 et HTTPS, et interdit les tâches avec des entrées HTTP :

aws mediaconvert put-policy --policy '{"HttpInputs":"DISALLOWED"}'

Notez que la commande put-policy remplace toute politique existante dans la région.

Récupérez la politique actuelle

Pour récupérer la politique actuelle au format JSON, envoyez une get-policy commande :

aws mediaconvert get-policy

Supprimer la politique actuelle

Pour supprimer la politique actuelle et autoriser toutes les entrées (en revenant au comportement par défaut), envoyez une delete-policy commande :

aws mediaconvert delete-policy

Que se passe-t-il lorsque vous essayez de soumettre une offre avec un emplacement de saisie non autorisé ?

Si vous tentez de soumettre une tâche qui spécifie un emplacement d'entrée interdit par votre politique, une erreur HTTP 400 (BadRequestException) MediaConvert sera renvoyée à la place. Le message d'erreur sera le suivant : Vous avez spécifié un emplacement de saisie interdit par votre politique. Spécifiez un emplacement de saisie autorisé et soumettez à nouveau votre travail. Comme cela MediaConvert empêche la soumission de ces offres, elles n'apparaîtront pas dans votre historique des offres d'emploi.

Si vous soumettez une tâche qui spécifie un emplacement de saisie autorisé, mais que la tâche nécessite l'accès à un autre emplacement de saisie non autorisé, votre tâche échouera. Par exemple, cela peut se produire si vous spécifiez un manifeste Apple HLS sur un emplacement Amazon S3 autorisé qui fait référence à d'autres fichiers de segments d'entrée sur un emplacement HTTP non autorisé. Le code d'erreur d'échec de la tâche sera 3457 et le message sera le suivant : Vous avez spécifié un emplacement de saisie interdit par votre politique. Spécifiez un emplacement de saisie autorisé et soumettez à nouveau votre travail.

Comment utiliser les clés de condition IAM avec les politiques d'entrée

Lorsque vous incluez une clé de condition dans votre politique IAM que vous utilisez pour soumettre des demandes de création de tâches, IAM vérifie si la politique d'entrée de votre compte correspond à cette condition. La condition que vous spécifiez doit correspondre à la politique d'entrée de votre compte pour que la demande d'API soit autorisée. Vous pouvez utiliser l'une des clés de condition booléennes suivantes :

Lorsque vous utilisez des clés de condition, considérez les scénarios suivants :

Si la condition et la politique de saisie correspondent, par exemple si vous définissez HTTPInputsAllowed sur true et que la politique d'entrée de votre compte autorise les entrées HTTP, votre demande de création de tâche sera soumise à l' MediaConvert API.

Si la condition et la politique de saisie ne correspondent pas, par exemple si vous définissez HTTPInputsAllowed sur false et que la politique d'entrée de votre compte autorise les entrées HTTP, votre demande de création de tâche ne sera pas soumise à l' MediaConvert API. Vous recevrez à la place le message d'erreur suivant : « message » : « L'utilisateur : arn:aws:iam : :111122223333 : n'user/User est pas autorisé à exécuter : mediaconvert : on resource : arn:aws:mediaconvert:us-west- 2:111122223333 : » CreateJob queues/Default

Si la condition et la politique de saisie correspondent, par exemple si vous définissez HTTPInputsAllowed sur false et que la politique d'entrée de votre compte les interdit, votre demande de création de tâche sera soumise à l' MediaConvert API. Cependant, l'API renverra alors une erreur HTTP 400 (BadRequestException). Le message d'erreur sera le suivant : Vous avez spécifié un emplacement de saisie interdit par votre politique. Spécifiez un emplacement de saisie autorisé et soumettez à nouveau votre travail.

Pour plus d'informations sur l'utilisation des clés de condition IAM, consultez la section Éléments de politique JSON IAM : Condition dans le guide de l'utilisateur IAM.

Le JSON suivant est un exemple de politique IAM utilisant des clés de MediaConvert condition qui vérifie si votre compte possède une politique d'entrée qui interdit les entrées HTTP :

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "BlockHTTPInputsExample",
            "Effect": "Allow",
            "Action": "mediaconvert:CreateJob",
            "Resource": "*",
            "Condition": {
                "BoolIfExists": {
                    "mediaconvert:HttpInputsAllowed": false
                }
            }
        }
    ]
}

Pour plus d'informations sur la prise en charge des clés MediaConvert conditionnelles, consultezComment ? AWS Elemental MediaConvert fonctionne avec IAM.