Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tindakan, sumber daya, dan kunci kondisi untuk Agen AWS Keamanan
AWS Agen Keamanan (awalan layanan:securityagent) menyediakan sumber daya, tindakan, dan kunci konteks kondisi khusus layanan berikut untuk digunakan dalam kebijakan izin IAM.
Referensi:
-
Pelajari cara mengonfigurasi layanan ini.
-
Lihat daftar Operasi API yang tersedia untuk layanan ini.
-
Pelajari cara mengamankan layanan ini dan sumber dayanya dengan menggunakan kebijakan izin IAM.
Topik
Tindakan yang ditentukan oleh Agen AWS Keamanan
Anda dapat menyebutkan tindakan berikut dalam elemen Action pernyataan kebijakan IAM. Gunakan kebijakan untuk memberikan izin untuk melaksanakan operasi dalam AWS. Saat Anda menggunakan sebuah tindakan dalam sebuah kebijakan, Anda biasanya mengizinkan atau menolak akses ke operasi API atau perintah CLI dengan nama yang sama. Namun, dalam beberapa kasus, satu tindakan tunggal mengontrol akses ke lebih dari satu operasi. Atau, beberapa operasi memerlukan beberapa tindakan yang berbeda.
Kolom tingkat akses pada tabel Tindakan menjelaskan cara tindakan diklasifikasikan (Daftar, Baca, Manajemen izin, atau Penandaan). Klasifikasi ini dapat membantu Anda memahami tingkat akses yang diberikan tindakan saat Anda menggunakannya dalam kebijakan. Untuk informasi selengkapnya tentang tingkat akses, lihat Tingkat akses dalam ringkasan kebijakan.
Kolom tipe sumber daya pada tabel Tindakan menunjukkan apakah setiap tindakan mendukung izin tingkat sumber daya. Jika tidak ada nilai untuk kolom ini, Anda harus menentukan semua sumber daya (“*”) yang berlaku kebijakan dalam Resource elemen pernyataan kebijakan Anda. Jika kolom mencantumkan jenis sumber daya, maka Anda dapat menyebutkan ARN dengan jenis tersebut dalam sebuah pernyataan dengan tindakan tersebut. Jika tindakan memiliki satu atau lebih sumber daya yang diperlukan, pemanggil harus memiliki izin untuk menggunakan tindakan dengan sumber daya tersebut. Sumber daya yang diperlukan ditunjukkan dalam tabel dengan tanda bintang (*). Jika Anda membatasi akses sumber daya dengan Resource elemen dalam kebijakan IAM, Anda harus menyertakan ARN atau pola untuk setiap jenis sumber daya yang diperlukan. Beberapa tindakan mendukung berbagai jenis sumber daya. Jika jenis sumber daya opsional (tidak ditunjukkan sesuai kebutuhan), maka Anda dapat memilih untuk menggunakan salah satu jenis sumber daya opsional.
Kolom Condition keys pada tabel Actions menyertakan kunci yang dapat Anda tentukan dalam Condition elemen pernyataan kebijakan. Untuk informasi selengkapnya tentang kunci kondisi yang terkait dengan sumber daya untuk layanan, lihat kolom Kunci kondisi pada tabel Jenis sumber daya.
Kolom Tindakan tergantung pada tabel Tindakan menunjukkan izin tambahan yang mungkin diperlukan untuk berhasil memanggil tindakan. Izin ini mungkin diperlukan selain izin untuk tindakan itu sendiri. Saat tindakan menentukan tindakan dependen, dependensi tersebut mungkin berlaku untuk sumber daya tambahan yang ditentukan untuk tindakan tersebut, bukan hanya sumber daya pertama yang tercantum dalam tabel.
catatan
Kunci kondisi sumber daya tercantum dalam tabel Jenis sumber daya. Anda dapat menemukan tautan ke jenis sumber daya yang berlaku untuk tindakan di kolom Jenis sumber daya (*wajib) pada tabel Tindakan. Jenis sumber daya dalam tabel Jenis sumber daya menyertakan kolom Kunci kondisi, yang merupakan kunci kondisi sumber daya yang berlaku untuk tindakan dalam tabel Tindakan.
Untuk detail tentang kolom dalam tabel berikut, lihat Tabel tindakan.
| Tindakan | Deskripsi | Tingkat akses | Jenis sumber daya (*diperlukan) | Kunci syarat | Tindakan bergantung |
|---|---|---|---|---|---|
| AddArtifact | Memberikan izin untuk menambahkan Artifak untuk Instance Agen yang diberikan | Tulis | |||
| AddControl | Memberikan izin untuk menambahkan Kontrol terkelola pelanggan | Tulis | |||
| BatchDeletePentests | Memberikan izin untuk menghapus beberapa tes penetrasi dalam satu permintaan | Tulis | |||
| BatchGetAgentInstances | Memberikan izin untuk mengambil beberapa instance agen dalam satu permintaan | Baca | |||
| BatchGetArtifactMetadata | Memberikan izin untuk mengambil satu atau beberapa catatan Metadata Artifact untuk Instance Agen yang diberikan | Baca | |||
| BatchGetFindings | Memberikan izin untuk mengambil beberapa temuan pengujian keamanan dalam satu permintaan | Baca | |||
| BatchGetPentestJobs | Memberikan izin untuk mengambil beberapa pekerjaan pengujian keamanan dalam satu permintaan | Baca | |||
| BatchGetPentests | Memberikan izin untuk mengambil beberapa tes penetrasi dalam satu permintaan | Baca | |||
| BatchGetSecurityTestContentMetadata | Memberikan izin untuk mengambil beberapa metadata konten pengujian keamanan dalam satu permintaan | Baca | |||
| BatchGetTasks | Memberikan izin untuk mengambil beberapa tugas pengujian keamanan dalam satu permintaan | Baca | |||
| CreateAgentInstance | Memberikan izin untuk membuat catatan instance agen | Tulis | |||
| CreateApplication | Memberikan izin untuk membuat aplikasi baru | Tulis |
iam:PassRole sso:CreateApplication |
||
| CreateDocumentReview | Memberikan izin untuk membuat tinjauan dokumen | Tulis | |||
| CreateIntegration | Memberikan izin untuk membuat integrasi pengujian keamanan | Tulis | |||
| CreateMembership | Memberikan izin untuk menambahkan satu anggota ke instance agen dengan peran tertentu | Tulis | |||
| CreateOneTimeLoginSession | Memberikan izin untuk membuat sesi login satu kali | Tulis | |||
| CreatePentest | Memberikan izin untuk membuat konfigurasi uji penetrasi baru | Tulis | |||
| DeleteAgentInstance | Memberikan izin untuk menghapus catatan instans agen | Tulis | |||
| DeleteApplication | Memberikan izin untuk menghapus aplikasi | Tulis | |||
| DeleteArtifact | Memberikan izin untuk menghapus Artifak | Tulis | |||
| DeleteControl | Memberikan izin untuk menghapus Kontrol terkelola pelanggan | Tulis | |||
| DeleteIntegration | Memberikan izin untuk menghapus integrasi aplikasi | Tulis | |||
| DeleteMembership | Memberikan izin untuk menghapus satu anggota yang terkait dengan instance agen | Tulis | |||
| DescribeFindings | Memberikan izin untuk mengambil temuan keamanan untuk tes penetrasi atau tugas pengujian keamanan dalam tes penetrasi | Baca | |||
| GetApplication | Memberikan izin untuk mendapatkan detail aplikasi berdasarkan ID aplikasi | Baca | |||
| GetArtifact | Memberikan izin untuk mengambil Artifak untuk Instans Agen yang diberikan | Baca | |||
| GetCodeReviewTask | Memberikan izin untuk mengambil Tugas Peninjauan Kode | Baca | |||
| GetControl | Memberikan izin untuk mengambil Kontrol | Baca | |||
| GetDocReviewTask | Memberikan izin untuk mengambil tugas peninjauan dokumen | Baca | |||
| GetDocumentReview | Memberikan izin untuk mendapatkan status peninjauan dokumen instans agen terkait | Baca | |||
| GetDocumentReviewArtifact | Memberikan izin untuk mendapatkan artefak peninjauan dokumen untuk dokumen tertentu | Baca | |||
| GetIntegration | Memberikan izin untuk mendapatkan metadata integrasi berdasarkan ID | Baca | |||
| GetLoginSessionCredentials | Memberikan izin untuk mengambil kredensi untuk sesi login satu kali | Baca | |||
| HandleOneTimeLoginSession | Memberikan izin untuk memproses dan membatalkan sesi login satu kali | Tulis | |||
| InitiateProviderRegistration | Memberikan izin untuk memulai pendaftaran Aplikasi Agen Keamanan untuk penyedia yang diberikan (misalnya:) GitHub | Tulis | |||
| ListAgentInstanceTasks | Memberikan izin untuk membuat daftar tugas untuk contoh agen tertentu | Daftar | |||
| ListAgentInstances | Memberikan izin untuk mencantumkan instance agen | Daftar | |||
| ListApplications | Memberikan izin untuk membuat daftar semua aplikasi di akun | Daftar | |||
| ListArtifacts | Memberikan izin untuk membuat daftar semua artefak untuk proyek yang diberikan | Daftar | |||
| ListControls | Memberikan izin untuk membuat daftar semua Kontrol | Daftar | |||
| ListDiscoveredEndpoints | Memberikan izin untuk membuat daftar titik akhir yang ditemukan terkait dengan pekerjaan pentest dengan pemfilteran awalan URI opsional | Daftar | |||
| ListDocumentReviewComments | Memberikan izin untuk membuat daftar komentar ulasan dokumen | Daftar | |||
| ListDocumentReviews | Memberikan izin untuk membuat daftar semua ulasan dokumen untuk proyek yang diberikan | Daftar | |||
| ListFindings | Memberikan izin untuk membuat daftar temuan dengan dukungan penyaringan dan pagination | Daftar | |||
| ListIntegratedResources | Memberikan izin untuk membuat daftar sumber daya terintegrasi untuk instance agen | Daftar | |||
| ListIntegrations | Memberikan izin untuk mendapatkan integrasi yang dimiliki oleh pemanggil Akun AWS | Daftar | |||
| ListMemberships | Memberikan izin untuk mencantumkan semua anggota yang terkait dengan instance agen dengan dukungan pagination | Daftar | |||
| ListPentestJobsForPentest | Memberikan izin untuk membuat daftar pekerjaan uji penetrasi yang terkait dengan tes penetrasi | Daftar | |||
| ListPentests | Memberikan izin untuk membuat daftar tes penetrasi dengan pemfilteran opsional berdasarkan status | Daftar | |||
| ListResourcesFromIntegration | Memberikan izin untuk membuat daftar sumber daya dari Integrasi | Daftar | |||
| ListTasks | Memberikan izin untuk membuat daftar tugas pengujian keamanan yang terkait dengan pekerjaan pentest | Daftar | |||
| StartCodeRemediation | Memberikan izin untuk memulai remediasi kode untuk temuan | Tulis | |||
| StartPentestExecution | Memberikan izin untuk memulai pelaksanaan tes penetrasi | Tulis | |||
| StopPentestExecution | Memberikan izin untuk menghentikan eksekusi tes penetrasi yang sedang berjalan | Tulis | |||
| ToggleManagedControl | Memberikan izin untuk beralih status | Tulis | |||
| UpdateAgentInstance | Memberikan izin untuk memperbarui catatan instans agen | Tulis | |||
| UpdateApplication | Memberikan izin untuk memperbarui konfigurasi aplikasi | Tulis |
iam:PassRole |
||
| UpdateControl | Memberikan izin untuk memperbarui Kontrol terkelola pelanggan | Tulis | |||
| UpdateFinding | Memberikan izin untuk memperbarui temuan keamanan yang ada dengan detail atau status baru | Tulis | |||
| UpdateIntegratedResources | Memberikan izin untuk memperbarui sumber daya terintegrasi untuk instance agen | Tulis | |||
| UpdatePentest | Memberikan izin untuk memperbarui tes penetrasi yang ada dengan konfigurasi atau pengaturan baru | Tulis | |||
| VerifyTargetDomain | Memberikan izin untuk memverifikasi kepemilikan domain target terdaftar dalam instance agen | Tulis |
Jenis sumber daya yang ditentukan oleh Agen AWS Keamanan
Jenis sumber daya berikut ditentukan oleh layanan ini dan dapat digunakan dalam elemen Resource pernyataan kebijakan izin IAM. Setiap tindakan dalam Tabel tindakan mengidentifikasi jenis sumber daya yang dapat ditentukan dengan tindakan tersebut. Jenis sumber daya juga dapat menentukan kunci kondisi mana yang dapat Anda sertakan dalam kebijakan. Tombol-tombol ini ditampilkan di kolom terakhir dari tabel Jenis sumber daya. Untuk detail tentang kolom dalam tabel berikut, lihat Tabel tipe sumber daya.
| Jenis sumber daya | ARN | Kunci syarat |
|---|---|---|
| Application |
arn:${Partition}:securityagent:${Region}:${Account}:application/${ApplicationId}
|
|
| Control |
arn:${Partition}:securityagent:${Region}:${Account}:control/${ControlId}
|
|
| Integration |
arn:${Partition}:securityagent:${Region}:${Account}:integration/${IntegrationId}
|
|
| AgentInstance |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}
|
|
| Artifact |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/artifact/${ArtifactId}
|
|
| Pentest |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest/${PentestId}
|
|
| PentestJob |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest-job/${JobId}
|
|
| PentestTask |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/pentest-task/${TaskId}
|
|
| Finding |
arn:${Partition}:securityagent:${Region}:${Account}:agent-instance/${AgentId}/finding/${FindingId}
|
Kunci kondisi untuk Agen AWS Keamanan
securityagent tidak memiliki kunci konteks khusus layanan yang dapat digunakan dalam Condition elemen pernyataan kebijakan. Untuk daftar kunci konteks global yang tersedia untuk semua layanan, lihat kunci konteks kondisi AWS global.
