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.
Étape 2 : lancez votre zone de landing zone à l'aide de l'AWS Control Tower APIs
Vous pouvez utiliser AWS Control Tower APIs pour lancer votre zone de landing zone. Cette section explique comment créer le fichier manifeste de zone d'atterrissage requis et comment l'utiliser avec l'opération CreateLandingZone d'API.
Création du fichier manifeste
Le fichier manifeste est un document JSON qui indique la configuration de votre zone d'atterrissage. Avec la version 4.0 de landing zone, de nombreux composants sont désormais optionnels, ce qui permet un déploiement plus flexible.
Structure du manifeste
Vous trouverez ci-dessous la structure complète du fichier manifeste avec toutes les configurations disponibles :
{ "accessManagement": { "enabled": true // Required - Controls IAM Identity Center integration }, "backup": { "enabled": true, // Required - Controls AWS Backup integration "configurations": { "backupAdmin": { "accountId":"111122223333"// Backup administrator account }, "centralBackup": { "accountId":"111122224444"// Central backup account }, "kmsKeyArn":"arn:aws:kms:region:account-id:key/key-id"} }, "centralizedLogging": { "accountId":"111122225555", // Log archive account "enabled": true, // Required - Controls centralized logging "configurations": { "accessLoggingBucket": { "retentionDays": 365 // Minimum value: 1 }, "loggingBucket": { "retentionDays": 365 // Minimum value: 1 }, "kmsKeyArn":"arn:aws:kms:region:account-id:key/key-id"} }, "config": { "accountId":"111122226666", // Config aggregator account "enabled": true, // Required - Controls AWS Config integration "configurations": { "accessLoggingBucket": { "retentionDays": 365 // Minimum value: 1 }, "loggingBucket": { "retentionDays": 365 // Minimum value: 1 }, "kmsKeyArn":"arn:aws:kms:region:account-id:key/key-id"} }, "governedRegions": [ // Optional - List of regions to govern "us-east-1", "us-west-2" ], "securityRoles": { "enabled": true, // Required - Controls security roles creation "accountId": ""111122226666"// Security/Audit account } }
Remarques importantes
Tous les
enableddrapeaux sont obligatoires dans le manifeste.-
Si vous désactivez l'intégration AWS Config (
"config.enabled": false), vous devez également désactiver les intégrations suivantes :Rôles de sécurité (
"securityRoles.enabled": false)Gestion des accès (
"accessManagement.enabled": false)Backup (
"backup.enabled": false)
Le compte IDs doit être un AWS compte IDs à 12 chiffres valide.
La clé KMS ARNs doit être une AWS KMS clé valide ARNs.
Le nombre de jours de rétention doit être d'au moins 1.
Utilisation de l' CreateLandingZone API
Pour créer votre zone de landing zone à l'aide de l'API :
aws controltower create-landing-zone --landing-zone-version 4.0 --manifest file://manifest.json
L'API renvoie un identifiant d'opération de zone d'atterrissage que vous pouvez utiliser pour suivre la progression de la création de votre zone d'atterrissage. Exemple de réponse :
{ "arn": "arn:aws:controltower:us-west-2:123456789012:landingzone/1A2B3C4D5E6F7G8H", "operationIdentifier": "55XXXXXX-e2XX-41XX-a7XX-446XXXXXXXXX" }
Vous pouvez surveiller l'état des opérations à l'aide de l'GetLandingZoneOperationAPI qui renvoie un statut de SUCCEEDEDFAILED, ou IN_PROGRESS :
aws controltower get-landing-zone-operation --operation-identifier "55XXXXXX-eXXX-4XXX-aXXX-44XXXXXXXXXX"
Ce qui a changé dans la version 4.0 de landing zone
Modifications importantes apportées à la structure et aux exigences du manifeste :
-
Structure de l'organisation
organizationStructurela définition a été supprimée du manifesteLes clients peuvent désormais définir leur propre structure organisationnelle
Seule exigence : les comptes d'intégration de services doivent se trouver dans la même unité d'organisation directement sous root
-
Drapeaux activés
Toutes les configurations d'intégration de services comportent un
enabledindicateur qui est désormais un champ obligatoire.Les clients doivent toujours fournir une valeur booléenne. Aucune valeur par défaut n'est fournie.
-
Les clients doivent indiquer explicitement enable/disable chaque configuration d'intégration de service dans le manifeste :
accessManagementbackupcentralizedLoggingconfigsecurityRoles
-
Rôles de sécurité
L'intégration des rôles de sécurité est désormais facultative
Nouveau
enableddrapeau introduit pour gérersecurityRolesle déploiementLorsqu'elles sont désactivées, les fonctionnalités de sécurité associées ne seront pas mises en œuvre
-
AWS Intégration de Config
-
Une nouvelle section d'intégration du service AWS Config a été ajoutée au manifeste
configavec les champs suivants :enabled: indicateur booléen requis pour gérer le déploiement de l'intégration AWS ConfigaccountId: ID de compte AWS pour l'agrégateur AWS Config-
configurations :
accessLoggingBucket.retentionDays: Période de conservation des journaux d'accèsloggingBucket.retentionDays: Période de conservation des journaux AWS ConfigkmsKeyArn: clé KMS pour le chiffrement
-