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.
Prérequis pour la configuration AWS Config avec le AWS CLI
Avant de configurer AWS avec le AWS CLI, vous devez créer un compartiment Amazon S3, une rubrique Amazon SNS et un rôle IAM avec des politiques associées comme prérequis. Vous pouvez ensuite utiliser le AWS CLI pour spécifier le compartiment, le sujet et le rôle de AWS Config. Suivez cette procédure pour configurer les conditions préalables pour AWS Config.
Rubriques
Étape 1 : Création d'un compartiment Amazon S3
Si vous avez déjà un compartiment Amazon S3 dans votre compte et si vous voulez l'utiliser, ignorez cette étape et passez à l'étape Étape 2 : Création d'une rubrique Amazon SNS.
Pour créer un compartiment
Ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/
. -
Choisissez Créer un compartiment.
-
Dans Nom du compartiment, entrez un DNS-compliant nom de votre seau.
Le nom du compartiment doit présenter les caractéristiques suivantes :
-
Il doit être unique sur l'ensemble d'Amazon S3.
-
Il doit comporter entre 3 et 63 caractères.
-
Ne contient pas de majuscules.
-
Il doit commencer par une minuscule ou un chiffre.
Une fois le compartiment créé, vous ne pouvez pas changer son nom. Vérifiez que le nom de compartiment que vous choisissez n'existe pas déjà parmi tous les noms de compartiment existant dans Amazon S3. Pour plus d'informations sur les règles et les conventions de dénomination de compartiment, consultez Limites et restrictions applicables aux compartiments dans le Guide de l'utilisateur Amazon Simple Storage Service.
ImportantÉvitez d'inclure des informations sensibles dans le nom du bucket. Le nom de compartiment est visible dans les URL qui pointent vers les objets du compartiment.
-
-
Dans Région, choisissez le AWS Région dans laquelle vous souhaitez placer le bucket.
Choisissez une Région proche de vous afin de limiter la latence et les coûts, et répondre aux exigences légales. Les objets stockés dans une Région ne la quittent jamais, sauf si vous les transférez explicitement vers une autre Région. Pour obtenir la liste d'Amazon S3 AWS Régions, voir AWS points de terminaison de service dans le Référence générale d'Amazon Web Services.
-
Dans Paramètres de compartiment pour Bloquer l'accès public, choisissez les paramètres de blocage de l'accès public que vous souhaitez appliquer au compartiment.
Nous vous recommandons de laisser tous les paramètres activés, sauf si vous savez que vous devez en désactiver un ou plusieurs d'entre eux pour votre cas d'utilisation, par exemple pour héberger un site web public. Les paramètres de blocage de l’accès public que vous activez pour le compartiment seront également activés pour tous les points d'accès que vous créez dans le compartiment. Pour plus d'informations sur le blocage de l'accès public, consultez Utilisation de la fonctionnalité de blocage de l'accès public Amazon S3 dans le Guide de l'utilisateur Amazon Simple Storage Service.
-
(Facultatif) Si vous souhaitez activer la fonctionnalité de verrouillage d'objet S3 :
-
Choisissez Paramètres avancés et lisez le message qui s'affiche.
ImportantVous ne pouvez activer la fonctionnalité de verrouillage d'objet S3 pour un compartiment que lors de sa création. Si vous activez le verrouillage d'objet pour le compartiment, vous ne pouvez pas le désactiver ultérieurement. L'activation du verrouillage d'objet active également la gestion des versions pour le compartiment. Après avoir activé le verrouillage d'objet pour le compartiment, vous devez configurer les paramètres de la fonctionnalité de verrouillage d'objet avant que les objets du compartiment ne soient protégés. Pour plus d'informations sur la configuration de la protection des objets, consultez Configuration du verrouillage d'objet S3 à l'aide de la console Amazon S3.
-
Si vous souhaitez activer la fonctionnalité de verrouillage d'objet, entrez activer dans la zone de texte et choisissez Confirmer.
Pour plus d'informations sur la fonctionnalité de verrouillage d'objet S3, consultez Verrouillage d'objets à l'aide de la fonctionnalité de verrouillage d'objet Amazon S3 dans le Guide de l'utilisateur Amazon Simple Storage Service.
-
-
Choisissez Créer un compartiment.
Lorsque vous utilisez le AWS SDK Pour créer un compartiment, vous devez créer un client, puis utiliser le client pour envoyer une demande de création d'un compartiment. En tant que bonne pratique, vous devez créer votre client et votre compartiment dans la même Région AWS. Si vous ne spécifiez pas de Région lorsque vous créez un client ou un compartiment, Amazon S3 utilise USA Est (Virginie du Nord), la Région par défaut.
Pour créer un client permettant d'accéder à un point de terminaison à double pile, vous devez spécifier un Région AWS. Pour plus d'informations, consultez Points de terminaison Amazon S3 Dual-Stack. Pour une liste des produits disponibles Régions AWS, voir Régions et points de terminaison dans le Références générales AWS.
Lorsque vous créez un client, la région correspond à Region-specific point final. Le client utilise ce point de terminaison pour communiquer avec Amazon S3 : s3.. Si votre Région a été lancée après le 20 mars 2019, votre client et votre compartiment doivent se trouver dans la même Région. Par conséquent, vous pouvez utiliser un client dans la Région USA Est (Virginie du Nord) pour créer un compartiment dans n’importe quelle Région lancée avant le 20 mars 2019. Pour plus d'informations, consultez Points de terminaison hérités.<region>.amazonaws.com
Ces AWS Les exemples de code SDK permettent d'effectuer les tâches suivantes :
-
Créer un client en indiquant explicitement une Région AWS – Dans l'exemple, le client utilise le point de terminaison
s3---us-west-2.amazonaws.com.rproxy.goskope.compour communiquer avec Amazon S3. Vous pouvez spécifier n'importe quelle Région AWS. Pour une liste des Régions AWS, voir Régions et points de terminaison dans le AWS Référence générale. -
Envoyer une demande de création de compartiment en indiquant uniquement un nom de compartiment — Le client envoie une demande à Amazon S3 pour créer le compartiment dans la Région où vous avez créé un client.
-
Récupérer des informations relatives à l'emplacement du compartiment – Amazon S3 stocke les informations relatives à l'emplacement du compartiment dans la sous-ressource de l'emplacement associée au compartiment.
Les exemples de code suivants illustrent comment utiliser CreateBucket.
Vous pouvez également utiliser un compartiment Amazon S3 d'un autre compte, mais vous devrez peut-être créer une politique pour le compartiment qui accorde des autorisations d'accès à AWS Config. Pour en savoir plus sur l'accord d'autorisations à un compartiment Amazon S3, consultez Autorisations pour le compartiment Amazon S3 pour AWS Config Canal de livraison, puis passer à Étape 2 : Création d'une rubrique Amazon SNS.
Étape 2 : Création d'une rubrique Amazon SNS
Si vous avez déjà une rubrique Amazon SNS dans votre compte et que vous souhaitez l'utiliser, ignorez cette étape et passez à Étape 3 : Création d'un rôle IAM.
Pour créer une rubrique Amazon SNS
Ouvrez la console Amazon SNS à l'adresse https://console.aws.amazon.com/sns/v3/home
. -
Effectuez l’une des actions suivantes :
-
Si aucun sujet n'a jamais été créé dans votre Compte AWS avant, lisez la description d'Amazon SNS sur la page d'accueil.
-
Si des sujets ont été créés sous votre Compte AWS avant, dans le panneau de navigation, de choisir Sujets.
-
-
Sur la page Rubriques, choisissez Créer une rubrique.
-
Sur la page Créer une rubrique, dans la section Détails, procédez comme suit :
-
Pour Type, choisissez un type de rubrique (Standard ou FIFO).
-
Entrez un Nom pour la rubrique. Pour une rubrique FIFO, ajoutez .fifo à la fin du nom.
-
(Facultatif) Entrez un Nom d'affichage pour votre rubrique.
-
(Facultatif) Pour une rubrique FIFO, vous pouvez choisir déduplication des messages basée sur le contenu pour activer la déduplication des messages par défaut. Pour plus d'informations, consultez Déduplication de message pour les rubriques FIFO.
-
-
(Facultatif) Développez la section Chiffrement et effectuez les opérations suivantes. Pour plus d'informations, consultez Chiffrement au repos.
-
Choisissez Activer le chiffrement.
-
Spécifiez la clé principale client (CMK). Pour plus d'informations, veuillez consulter la rubrique Termes clés.
Pour chaque type de CMK, les champs Description, Compte et CARN CMK s'affichent.
ImportantSi vous n'êtes pas le propriétaire de la clé CMK, ou si vous vous connectez avec un compte n'ayant pas les autorisations
kms:ListAliasesetkms:DescribeKey, vous ne pouvez pas afficher les informations relatives au CMK sur la console Amazon SNS.Demandez au propriétaire du CMK de vous accorder ces autorisations. Pour plus d'informations, consultez Autorisations d'API AWS KMS : référence des actions et ressources dans le Guide du développeur AWS Key Management Service .
-
Le AWS CMK géré pour Amazon SNS (Par défaut) alias/aws/sns est sélectionné par défaut.
NoteGardez à l’esprit les points suivants :
-
La première fois que vous utilisez Console de gestion AWS pour spécifier AWS CMK géré pour Amazon SNS pour un sujet, AWS KMS crée le AWS CMK géré pour Amazon SNS.
-
Sinon, la première fois que vous utilisez
Publishaction sur un sujet avec SSE activé, AWS KMS crée le AWS CMK géré pour Amazon SNS.
-
-
Pour utiliser une CMK personnalisée à partir de votre Compte AWS, choisissez le Clé principale du client (CMK) champ, puis choisissez la CMK personnalisée dans la liste.
NotePour obtenir des instructions pour la création de CMK personnalisées, consultez Création de clés dans le Guide du développeur AWS Key Management Service .
-
Pour utiliser un ARN CMK personnalisé provenant de votre Compte AWS ou d'un autre AWS compte, saisissez-le dans Clé principale du client (CMK) champ.
-
-
-
(Facultatif) Par défaut, seul le propriétaire de la rubrique peut publier dans la rubrique ou s'abonner à la rubrique. Pour configurer des autorisations d'accès supplémentaires, développez la section Politique d'accès. Pour plus d'informations, consultez Gestion des identités et des accès dans Amazon SNS et Cas d'exemple pour le contrôle d'accès Amazon SNS.
NoteLorsque vous créez une rubrique à l'aide de la console, la politique par défaut utilise la clé de condition
aws:SourceOwner. Cette clé est similaire àaws:SourceAccount. -
(Facultatif) Pour configurer la façon dont Amazon SNS réessaie les tentatives de remise de messages ayant échoué, développez le Politique de nouvelle tentative de livraison (HTTP/S) section. Pour plus d'informations, consultez Nouvelle tentative de distribution des messages Amazon SNS.
-
(Facultatif) Pour configurer la manière dont Amazon SNS enregistre l'envoi de messages à CloudWatch, développez le Enregistrement de l'état de livraison section. Pour plus d'informations, voir État de distribution des messages Amazon SNS.
-
(Facultatif) Pour ajouter des balises de métadonnées à la rubrique, développez la section Balises, saisissez une clé et une valeur (facultatif) et choisissez Ajouter une balise. Pour plus d'informations, consultez Identification des rubriques Amazon SNS.
-
Choisissez Créer une rubrique.
Le sujet est créé et
MyTopicla page s'affiche.Le Nom de la rubrique, l'ARN, (facultatif) le Nom d'affichage et l'ID de compte AWS du Propriétaire de la rubrique sont affichés dans la section Détails.
-
Copiez l'ARN de rubrique dans le Presse-papiers, par exemple :
arn:aws:sns:us-east-2:123456789012:MyTopic
Pour abonner une adresse e-mail à la rubrique Amazon SNS
Ouvrez la console Amazon SNS à l'adresse https://console.aws.amazon.com/sns/v3/home
. -
Dans le volet de navigation de gauche, choisissez Abonnements.
-
Sur la page Abonnements, choisissez Créer un abonnement.
-
Sur la page Créer un abonnement, dans la section Détails, procédez comme suit :
-
Pour ARN de rubrique, choisissez l'ARN (Amazon Resource Name) d'une rubrique.
-
Pour Protocole, choisissez un type de point de terminaison. Les types de point de terminaison disponibles sont les suivants :
-
Note
Pour vous abonner à une Rubrique SNS FIFO, choisissez cette option.
-
Pour Point de terminaison, saisissez la valeur du point de terminaison, telle qu'une adresse e-mail ou l'ARN d'une file d'attente Amazon SQS.
-
Terminaux Firehose uniquement : pour Rôle d'abonnement ARN, spécifiez l'ARN du rôle IAM que vous avez créé pour écrire dans les flux de diffusion Firehose. Pour plus d'informations, voir Conditions requises pour l'abonnement des flux de diffusion Firehose aux rubriques Amazon SNS.
-
(Facultatif) Pour Firehose, Amazon SQS, HTTP/S points de terminaison, vous pouvez également activer la livraison de messages bruts. Pour plus d'informations, consultez Remise des messages bruts Amazon SNS.
-
(Facultatif) Pour configurer une politique de filtre, développez la section Politique de filtre d'abonnement. Pour plus d'informations, consultez les politiques de filtre d'abonnement Amazon SNS.
-
(Facultatif) Pour configurer une file d’attente de lettres mortes pour l’abonnement, développez la section Politique de reconduite (File d’attente de lettres mortes). Pour plus d'informations, consultez Files d'attente de lettres mortes d'Amazon SNS.
-
Choisissez Créer un abonnement.
La console crée l'abonnement et ouvre la page Détails de l’abonnement.
-
Pour utiliser un AWS SDK, vous devez le configurer avec vos informations d'identification. Pour plus d'informations, consultez Les fichiers de configuration et d'informations d'identification partagés dans le AWS Guide de référence des kits SDK et des outils.
Les exemples de code suivants illustrent comment utiliser CreateTopic.
Vous pouvez également utiliser une rubrique Amazon SNS appartenant à un autre compte, mais, dans ce cas, vous devrez créer une politique qui accorde des autorisations d'accès à AWS Config. Pour en savoir plus sur l'octroi d'autorisations à une rubrique Amazon SNS, consultez Autorisations relatives à la rubrique Amazon SNS, puis passez à Étape 3 : Création d'un rôle IAM.
Étape 3 : Création d'un rôle IAM
(Recommandé) Utilisez le AWS Config rôle lié à un service
Il est recommandé d'utiliser AWS Config rôle lié à un service : AWSServiceRoleForConfig. Service-linked les rôles sont prédéfinis et incluent toutes les autorisations qui AWS Config nécessite d'appeler un autre Services AWS. Le AWS Config un rôle lié à un service est requis pour les enregistreurs de configuration liés à un service.
Pour plus d'informations, voir En utilisant Service-Linked Rôles pour AWS Config.
Vous pouvez utiliser la console IAM pour créer un rôle IAM qui accorde AWS Config autorisations pour accéder à votre compartiment Amazon S3, accéder à votre rubrique Amazon SNS et obtenir des informations de configuration pour les personnes prises en charge AWS ressources. Lorsque vous utilisez la console pour créer un rôle IAM, AWS Config attache automatiquement les autorisations requises au rôle pour vous.
Si vous avez utilisé un AWS service qui utilise AWS Config (comme AWS Security Hub ou AWS Control Tower) et un AWS Config le rôle a déjà été créé, vous devez vous assurer que le rôle IAM que vous utilisez lors de la configuration AWS Config conserve les mêmes privilèges minimaux que ceux déjà créés AWS Config rôle dans l'ordre de l'autre AWS service pour continuer à fonctionner comme prévu.
Par exemple, si AWS Control Tower a un rôle IAM qui permet AWS Config pour lire les objets Amazon S3, vous devez vous assurer que les mêmes autorisations sont accordées dans le rôle IAM que vous utilisez lors de la configuration AWS Config. Sinon, cela pourrait interférer avec AWS Les opérations de Control Tower.
Pour plus d'informations sur les rôles IAM pour AWS Config, voir AWS Gestion des identités et des accès.
Pour créer un rôle pour un AWS web
Connectez-vous au Console de gestion AWS et ouvrez la console IAM à l'adresse https://console.aws.amazon.com/iam/
. -
Dans le volet de navigation de la console IAM, sélectionnez Roles (Rôles), puis Create role (Créer un rôle).
-
Pour Sélectionner une entité de confiance, choisissez Service AWS .
-
Choisissez le cas d'utilisation que vous souhaitez AWS Config: Configuration - Personnalisable, Configuration - Organisations, Configuration, ou Configuration - Packs de conformité. Ensuite, choisissez Suivant.
-
Sur la page Nommer, vérifier et créer, passez en revue les détails relatifs à votre rôle et choisissez Créer un rôle.
Pour utiliser un AWS SDK, vous devez le configurer avec vos informations d'identification. Pour plus d'informations, consultez Les fichiers de configuration et d'informations d'identification partagés dans le AWS Guide de référence des kits SDK et des outils.
Les exemples de code suivants illustrent comment utiliser CreateRole.