Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengaktifkan Security Lake secara terprogram
Tutorial ini menjelaskan cara mengaktifkan dan mulai menggunakan Security Lake secara terprogram. Amazon Security Lake API memberi Anda akses terprogram yang komprehensif ke akun, data, dan sumber daya Security Lake Anda. Atau, Anda dapat menggunakan alat baris AWS perintah — [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) atau [AWS Alat untuk PowerShell ](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-welcome.html) —atau [AWS SDK ](https://aws.amazon.com/developertools/) untuk mengakses Security Lake.
## Langkah 1: Buat peran IAM
Jika Anda mengakses Security Lake secara terprogram, Anda perlu membuat beberapa peran AWS Identity and Access Management (IAM) untuk mengonfigurasi danau data Anda.
**penting**
Tidak perlu membuat peran IAM ini jika Anda menggunakan konsol Security Lake untuk mengaktifkan dan mengkonfigurasi Security Lake.
Anda harus membuat peran di IAM jika Anda akan mengambil satu atau beberapa tindakan berikut (pilih tautan untuk melihat informasi selengkapnya tentang peran IAM untuk setiap tindakan):
+ [Membuat sumber kustom ](custom-sources.md#iam-roles-custom-sources) — Sumber kustom adalah sumber selain Layanan AWS yang didukung secara asli yang mengirim data ke Security Lake.
+ [Membuat pelanggan dengan akses data ](prereqs-creating-subscriber.md#iam-role-subscriber) — Pelanggan dengan izin dapat langsung mengakses objek S3 dari danau data Anda.
+ [Membuat pelanggan dengan akses kueri ](prereqs-query-subscriber.md#iam-role-query-subscriber) — Pelanggan dengan izin dapat menanyakan data dari Security Lake menggunakan layanan seperti Amazon Athena.
+ [Mengkonfigurasi Wilayah rollup ](add-rollup-region.md#iam-role-replication) — Wilayah rollup mengkonsolidasikan data dari beberapa. Wilayah AWS
Setelah membuat peran yang disebutkan sebelumnya, lampirkan [AmazonSecurityLakeAdministrator](https://docs.aws.amazon.com/security-lake/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonSecurityLakeAdministrator) AWS kebijakan terkelola ke peran yang Anda gunakan untuk mengaktifkan Security Lake. Kebijakan ini memberikan izin administratif yang memungkinkan kepala sekolah untuk naik ke Security Lake dan mengakses semua tindakan Security Lake.
Lampirkan [AmazonSecurityLakeMetaStoreManager](https://docs.aws.amazon.com/security-lake/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonSecurityLakeAdministrator) AWS kebijakan terkelola untuk membuat data lake atau data kueri dari Security Lake. Kebijakan ini diperlukan agar Security Lake mendukung pekerjaan ekstrak, transformasi, dan memuat (ETL) pada log mentah dan data peristiwa yang diterimanya dari sumber.
## Langkah 2: Aktifkan Amazon Security Lake
Untuk mengaktifkan Security Lake secara terprogram, gunakan pen [CreateDataLake](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_CreateDataLake.html) goperasian Security Lake API. Jika Anda menggunakan AWS CLI, jalankan perintah [ create-data-lake](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/securitylake/create-data-lake.html). Dalam permintaan Anda, gunakan `region` bidang `configurations` objek untuk menentukan kode Wilayah untuk Wilayah di mana mengaktifkan Security Lake. Untuk daftar kode Wilayah, lihat titik akhir [ Amazon Security Lake ](https://docs.aws.amazon.com/general/latest/gr/securitylake.html) di *Referensi Umum AWS*.
**Contoh 1**
Perintah contoh berikut mengaktifkan Security Lake di `us-east-1` dan Wil `us-east-2` ayah. Di kedua Wilayah, danau data ini dienkripsi dengan kunci terkelola Amazon S3. Objek kedaluwarsa setelah 365 hari, dan objek bertransisi ke kelas penyimpanan `ONEZONE_IA` S3 setelah 60 hari. Contoh ini diformat untuk Linux, macOS, atau Unix, dan menggunakan karakter garis miring terbalik (\\) untuk meningkatkan keterbacaan.
```
$ aws securitylake create-data-lake \
--configurations '[{"encryptionConfiguration": {"kmsKeyId":"{{S3_MANAGED_KEY}}"},"region":"{{us-east-1}}","lifecycleConfiguration": {"expiration":{"days":{{365}}},"transitions":[{"days":{{60}},"storageClass":"{{ONEZONE_IA}}"}]}}, {"encryptionConfiguration": {"kmsKeyId":"{{S3_MANAGED_KEY}}"},"region":"{{us-east-2}}","lifecycleConfiguration": {"expiration":{"days":{{365}}},"transitions":[{"days":{{60}},"storageClass":"{{ONEZONE_IA}}"}]}}]' \
--meta-store-manager-role-arn "{{arn:aws:iam:us-east-1:123456789012:role/service-role/AmazonSecurityLakeMetaStoreManager}}"
```
**Contoh 2**
Perintah contoh berikut mengaktifkan Danau Keamanan di Wil `us-east-2` ayah. Danau data ini dienkripsi dengan kunci yang dikelola pelanggan yang dibuat di AWS Key Management Service (AWS KMS). Objek kedaluwarsa setelah 500 hari, dan objek bertransisi ke kelas penyimpanan `GLACIER` S3 setelah 30 hari. Contoh ini diformat untuk Linux, macOS, atau Unix, dan menggunakan karakter garis miring terbalik (\\) untuk meningkatkan keterbacaan.
```
$ aws securitylake create-data-lake \
--configurations '[{"encryptionConfiguration": {"kmsKeyId":"{{1234abcd-12ab-34cd-56ef-1234567890ab}}"},"region":"{{us-east-2}}","lifecycleConfiguration": {"expiration":{"days":{{500}}},"transitions":[{"days":{{30}},"storageClass":"{{GLACIER}}"}]}}]' \
--meta-store-manager-role-arn "{{arn:aws:iam:us-east-1:123456789012:role/service-role/AmazonSecurityLakeMetaStoreManager}}"
```
**catatan**
Jika Anda telah mengaktifkan Security Lake dan ingin memperbarui pengaturan konfigurasi untuk Wilayah atau sumber, gunakan [UpdateDataLake](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_UpdateDataLake.html) operasi, atau jika menggunakan AWS CLI, perintah [ update-data- ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/securitylake/update-data-lake.html) lake. Jangan gunakan `CreateDataLake` operasi.
## Langkah 3: Konfigurasikan sumber
Security Lake mengumpulkan data log dan peristiwa dari berbagai sumber dan di seluruh Akun AWS dan Anda Wilayah AWS. Ikuti petunjuk berikut untuk mengidentifikasi data mana yang ingin Anda kumpulkan oleh Security Lake. Anda hanya dapat menggunakan instruksi ini untuk menambahkan sumber yang didukung Layanan AWS secara asli. Untuk informasi tentang menambahkan sumber khusus, lihat[Mengumpulkan data dari sumber khusus di Security Lake](custom-sources.md).
Untuk menentukan satu atau lebih sumber koleksi secara terprogram, gunakan [ CreateAwsLogSource ](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_CreateAwsLogSource.html) operasi Security Lake API. Untuk setiap sumber, tentukan nilai unik Regional untuk `sourceName` parameter. Secara opsional gunakan parameter tambahan untuk membatasi ruang lingkup sumber ke akun tertentu (`accounts`) atau versi tertentu (`sourceVersion`).
**catatan**
Jika Anda tidak menyertakan parameter opsional dalam permintaan Anda, Security Lake menerapkan permintaan Anda ke semua akun atau semua versi sumber yang ditentukan, tergantung pada parameter yang Anda kecualikan. Misalnya, jika Anda adalah administrator Security Lake yang didelegasikan untuk organisasi dan Anda mengecualikan `accounts` parameter, Security Lake menerapkan permintaan Anda ke semua akun di organisasi Anda. Demikian pula, jika Anda mengecualikan `sourceVersion` parameter, Security Lake menerapkan permintaan Anda ke semua versi sumber yang ditentukan.
Jika permintaan Anda menentukan Wilayah di mana Anda belum mengaktifkan Security Lake, kesalahan terjadi. Untuk mengatasi kesalahan ini, pastikan bahwa `regions` array hanya menentukan Wilayah di mana Anda telah mengaktifkan Security Lake. Atau, Anda dapat mengaktifkan Danau Keamanan di Wilayah, dan kemudian mengirimkan permintaan Anda lagi.
Saat Anda mengaktifkan Security Lake di akun untuk pertama kalinya, semua sumber log dan peristiwa yang dipilih akan menjadi bagian dari periode uji coba gratis 15 hari. Untuk informasi selengkapnya tentang statistik penggunaan, lihat[Meninjau penggunaan dan perkiraan biaya](reviewing-usage-costs.md).
## Langkah 4: Konfigurasikan pengaturan penyimpanan dan Wilayah rollup (opsional)
Anda dapat menentukan kelas penyimpanan Amazon S3 di mana Anda ingin Security Lake menyimpan data Anda dan untuk berapa lama. Anda juga dapat menentukan Wilayah rollup untuk mengkonsolidasikan data dari beberapa Wilayah. Ini adalah langkah-langkah opsional. Untuk informasi selengkapnya, lihat [Manajemen siklus hidup di Security Lake](lifecycle-management.md).
Untuk menentukan tujuan target secara terprogram saat Anda mengaktifkan Security Lake, gunakan [CreateDataLake](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_CreateDataLake.html) operasi Security Lake API. Jika Anda telah mengaktifkan Security Lake dan ingin menentukan tujuan target, gunakan [UpdateDataLake](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_UpdateDataLake.html) operasi, bukan `CreateDataLake` operasi.
Untuk salah satu operasi, gunakan parameter yang didukung untuk menentukan pengaturan konfigurasi yang Anda inginkan:
+ Untuk menentukan Wilayah rollup, gunakan `region` bidang untuk menentukan Wilayah yang ingin Anda sumbangkan data ke Wilayah rollup. Dalam `regions` array `replicationConfiguration` objek, tentukan kode Wilayah untuk setiap Wilayah rollup. Untuk daftar kode Wilayah, lihat titik akhir [ Amazon Security Lake ](https://docs.aws.amazon.com/general/latest/gr/securitylake.html) di *Referensi Umum AWS*.
+ Untuk menentukan pengaturan retensi untuk data Anda, gunakan `lifecycleConfiguration` parameter:
+ Untuk`transitions`, tentukan jumlah total hari (`days`) yang ingin Anda simpan objek S3 di kelas penyimpanan Amazon S3 tertentu (`storageClass`).
+ Untuk`expiration`, tentukan jumlah total hari yang ingin Anda simpan objek di Amazon S3, menggunakan kelas penyimpanan apa pun, setelah objek dibuat. Ketika periode retensi ini berakhir, objek akan kedaluwarsa dan Amazon S3 menghapusnya.
Security Lake menerapkan pengaturan retensi yang ditentukan ke Wilayah yang Anda tent `region` ukan di bidang `configurations` objek.
Misalnya, perintah berikut membuat danau data dengan `ap-northeast-2` sebagai Wilayah rollup. Wil `us-east-1` ayah akan menyumbangkan data ke D `ap-northeast-2` aerah. Contoh ini juga menetapkan periode kedaluwarsa 10 hari untuk objek yang ditambahkan ke danau data.
```
$ aws securitylake create-data-lake \
--configurations '[{"encryptionConfiguration": {"kmsKeyId":"{{S3_MANAGED_KEY}}"},"region":"{{us-east-1}}","replicationConfiguration": {"regions": ["{{ap-northeast-2}}"],"roleArn":"{{arn:aws:iam::123456789012:role/service-role/AmazonSecurityLakeS3ReplicationRole}}"},"lifecycleConfiguration": {"expiration":{"days":{{10}}}}}]' \
--meta-store-manager-role-arn "{{arn:aws:iam::123456789012:role/service-role/AmazonSecurityLakeMetaStoreManager}}"
```
Anda sekarang telah membuat danau data Anda. Gunakan pen [ListDataLakes](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_ListDataLakes.html) goperasian Security Lake API untuk memverifikasi pengaktifan Security Lake dan pengaturan danau data Anda di setiap Wilayah.
Jika masalah atau kesalahan muncul dalam pembuatan danau data Anda, Anda dapat melihat daftar pengecualian dengan menggunakan [ListDataLakeExceptions](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_ListDataLakeExceptions.html) operasi, dan memberi tahu pengguna tentang pengecualian dengan [CreateDataLakeExceptionSubscription](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_CreateDataLakeExceptionSubscription.html) operasi. Untuk informasi selengkapnya, lihat [Memecahkan masalah status danau data](securitylake-data-lake-troubleshoot.md).
## Langkah 5: Lihat dan kueri data Anda sendiri
Setelah membuat data lake, Anda dapat menggunakan Amazon Athena atau layanan serupa untuk melihat dan menanyakan data Anda dari AWS Lake Formation database dan tabel. Bila Anda mengaktifkan Security Lake secara terprogram, izin tampilan database tidak diberikan secara otomatis. Akun administrator danau data di AWS Lake Formation harus memberikan `SELECT` izin ke peran IAM yang ingin Anda gunakan untuk menanyakan database dan tabel yang relevan. Minimal, peran harus memiliki * izin analis * data. Untuk informasi selengkapnya tentang tingkat izin, lihat referensi personas Formasi [ Danau dan izin IAM. ](https://docs.aws.amazon.com/lake-formation/latest/dg/permissions-reference.html) Untuk petunjuk tentang pemberian `SELECT` izin, lihat [ Memberikan izin Katalog Data menggunakan metode sumber daya bernama ](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-cat-perms-named-resource.html) di Panduan Peng *AWS Lake Formation embang*.
## Langkah 6: Buat pelanggan
Setelah membuat danau data Anda, Anda dapat menambahkan pelanggan untuk mengkonsumsi data Anda. Pelanggan dapat menggunakan data dengan langsung mengakses objek di bucket Amazon S3 Anda atau dengan menanyakan data lake. Untuk informasi selengkapnya tentang pelanggan, lihat[Manajemen pelanggan di Security Lake](subscriber-management.md).