View a markdown version of this page

Langkah 2: Luncurkan zona pendaratan Anda menggunakan AWS Control Tower API - Menara Kontrol AWS

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Langkah 2: Luncurkan zona pendaratan Anda menggunakan AWS Control Tower API

Anda dapat menggunakan AWS Control Tower API untuk meluncurkan zona pendaratan Anda. Bagian ini menjelaskan cara membuat file manifes zona pendaratan yang diperlukan dan menggunakannya dengan operasi CreateLandingZone API.

Membuat file manifes

File manifes adalah dokumen JSON yang menentukan konfigurasi zona pendaratan Anda. Dengan zona pendaratan versi 4.0, banyak komponen sekarang opsional, memungkinkan penerapan yang lebih fleksibel.

Struktur Manifest

Di bawah ini adalah struktur lengkap dari file manifes dengan semua konfigurasi yang tersedia:

{ "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 } }

Catatan Penting

  • Semua enabled bendera diperlukan dalam manifes.

  • Jika menonaktifkan integrasi AWS Config ("config.enabled": false), Anda juga harus menonaktifkan integrasi berikut:

    • Peran Keamanan ("securityRoles.enabled": false)

    • Manajemen Akses ("accessManagement.enabled": false)

    • Cadangan ("backup.enabled": false)

  • ID akun harus berupa ID AWS akun 12 digit yang valid.

  • ARN kunci KMS harus menjadi ARN AWS KMS kunci yang valid.

  • Hari retensi harus minimal 1.

Menggunakan CreateLandingZone API

Untuk membuat zona pendaratan menggunakan API:

aws controltower create-landing-zone --landing-zone-version 4.0 --manifest file://manifest.json

API akan mengembalikan ID operasi zona pendaratan yang dapat Anda gunakan untuk melacak kemajuan pembuatan zona pendaratan Anda. Contoh respons:

{ "arn": "arn:aws:controltower:us-west-2:123456789012:landingzone/1A2B3C4D5E6F7G8H", "operationIdentifier": "55XXXXXX-e2XX-41XX-a7XX-446XXXXXXXXX" }

Anda dapat memantau status operasi menggunakan GetLandingZoneOperation API yang mengembalikan statusSUCCEEDED,FAILED, atauIN_PROGRESS:

aws controltower get-landing-zone-operation --operation-identifier "55XXXXXX-eXXX-4XXX-aXXX-44XXXXXXXXXX"

Apa yang berubah di zona pendaratan versi 4.0

Perubahan penting pada struktur dan persyaratan manifes:

  • Struktur Organisasi

    • organizationStructuredefinisi telah dihapus dari manifes

    • Pelanggan sekarang dapat menentukan struktur organisasi mereka sendiri

    • Satu-satunya persyaratan: Akun integrasi layanan harus berada di OU yang sama langsung di bawah root

  • Bendera yang Diaktifkan

    • Semua konfigurasi integrasi layanan memiliki enabled tanda yang sekarang menjadi bidang wajib.

    • Pelanggan harus selalu memberikan nilai boolean. Tidak ada nilai default yang disediakan.

    • Pelanggan perlu secara eksplisit enable/disable setiap konfigurasi integrasi layanan dalam manifes:

      • accessManagement

      • backup

      • centralizedLogging

      • config

      • securityRoles

  • Peran Keamanan

    • Integrasi Peran Keamanan sekarang opsional

    • enabledBendera baru diperkenalkan untuk mengelola securityRoles penerapan

    • Saat dinonaktifkan, fitur keamanan terkait tidak akan diimplementasikan

  • AWS Integrasi Konfigurasi

    • Bagian integrasi layanan AWS Config baru ditambahkan ke manifes seperti config dengan bidang berikut:

      • enabled: Bendera boolean yang diperlukan untuk mengelola penyebaran integrasi AWS Config

      • accountId: ID akun AWS untuk agregator AWS Config

      • konfigurasi:

        • accessLoggingBucket.retentionDays: Periode retensi untuk log akses

        • loggingBucket.retentionDays: Periode retensi untuk log AWS Config

        • kmsKeyArn: Kunci KMS untuk enkripsi