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
Jenis sumber daya yang ditentukan oleh Agen AWS Keamanan
Kunci kondisi untuk Agen AWS Keamanan

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 dependen 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 Ruang Agen yang diberikan	Tulis	AgentSpace*
BatchDeletePentests	Memberikan izin untuk menghapus beberapa tes penetrasi dalam satu permintaan	Tulis	AgentSpace*		kms:Decrypt
BatchGetAgentSpaces	Memberikan izin untuk mengambil beberapa ruang agen dalam satu permintaan	Baca	AgentSpace*		kms:Decrypt
BatchGetArtifactMetadata	Memberikan izin untuk mengambil satu atau lebih catatan Metadata Artifact untuk Ruang Agen yang diberikan	Baca	AgentSpace*
BatchGetFindings	Memberikan izin untuk mengambil beberapa temuan pengujian keamanan dalam satu permintaan	Baca	AgentSpace*		kms:Decrypt
BatchGetPentestJobContentMetadata	Memberikan izin untuk mengambil beberapa metadata konten pekerjaan pentest dalam satu permintaan	Baca	AgentSpace*		kms:Decrypt
BatchGetPentestJobTasks	Memberikan izin untuk mengambil beberapa tugas pekerjaan pentest dalam satu permintaan	Baca	AgentSpace*		kms:Decrypt
BatchGetPentestJobs	Memberikan izin untuk mengambil beberapa pekerjaan pengujian keamanan dalam satu permintaan	Baca	AgentSpace*		kms:Decrypt
BatchGetPentests	Memberikan izin untuk mengambil beberapa tes penetrasi dalam satu permintaan	Baca	AgentSpace*		kms:Decrypt
BatchGetTargetDomains	Memberikan izin untuk mengambil beberapa domain target dalam satu permintaan	Baca	TargetDomain*
CreateAgentSpace	Memberikan izin untuk membuat catatan ruang agen	Tulis		aws:RequestTag/${TagKey} aws:TagKeys	kms:Decrypt kms:DescribeKey kms:GenerateDataKeyWithoutPlaintext
CreateApplication	Memberikan izin untuk membuat aplikasi baru	Tulis		aws:RequestTag/${TagKey} aws:TagKeys	iam:PassRole kms:DescribeKey sso:CreateApplication
CreateDesignReview	Memberikan izin untuk membuat tinjauan desain	Tulis	AgentSpace*
CreateIntegration	Memberikan izin untuk membuat integrasi pengujian keamanan	Tulis		aws:RequestTag/${TagKey} aws:TagKeys
CreateMembership	Memberikan izin untuk menambahkan satu anggota ke ruang agen dengan peran tertentu	Tulis	AgentSpace*
CreateOneTimeLoginSession	Memberikan izin untuk membuat sesi login satu kali	Tulis	AgentSpace*
CreatePentest	Memberikan izin untuk membuat konfigurasi uji penetrasi baru	Tulis	AgentSpace*		kms:Decrypt
CreateSecurityRequirement	Memberikan izin untuk menambahkan Persyaratan Keamanan terkelola pelanggan	Tulis	SecurityRequirementPack*
CreateTargetDomain	Memberikan izin untuk membuat catatan domain target	Tulis
DeleteAgentSpace	Memberikan izin untuk menghapus catatan ruang agen	Tulis	AgentSpace*		kms:Decrypt
DeleteApplication	Memberikan izin untuk menghapus aplikasi	Tulis	Application*
DeleteArtifact	Memberikan izin untuk menghapus Artifak	Tulis	AgentSpace*
DeleteDesignReview	Memberikan izin untuk menghapus tinjauan desain	Tulis	AgentSpace*
DeleteIntegration	Memberikan izin untuk menghapus integrasi aplikasi	Tulis	Integration*
DeleteMembership	Memberikan izin untuk menghapus satu anggota yang terkait dengan ruang agen	Tulis	AgentSpace*
DeleteSecurityRequirement	Memberikan izin untuk menghapus Persyaratan Keamanan yang dikelola pelanggan	Tulis	SecurityRequirementPack*
DeleteTargetDomain	Memberikan izin untuk menghapus catatan domain target	Tulis	TargetDomain*
GetApplication	Memberikan izin untuk mendapatkan detail aplikasi berdasarkan ID aplikasi	Baca	Application*
GetArtifact	Memberikan izin untuk mengambil Artifak untuk Ruang Agen yang diberikan	Baca	AgentSpace*
GetDesignReview	Memberikan izin untuk mendapatkan status tinjauan desain ruang agen terkait	Baca	AgentSpace*
GetDesignReviewArtifact	Memberikan izin untuk mendapatkan artefak tinjauan desain untuk dokumen tertentu	Baca	AgentSpace*
GetDesignReviewFeedback	Memberikan izin untuk mendapatkan umpan balik untuk komentar tinjauan desain	Baca	AgentSpace*
GetIntegration	Memberikan izin untuk mendapatkan metadata integrasi berdasarkan ID	Baca	Integration*
GetSecurityRequirement	Memberikan izin untuk mengambil Persyaratan Keamanan	Baca	SecurityRequirementPack*
InitiateProviderRegistration	Memberikan izin untuk memulai pendaftaran Aplikasi Agen Keamanan untuk penyedia yang diberikan (misalnya:) GitHub	Tulis
ListAgentSpaces	Memberikan izin untuk mencantumkan ruang agen	Daftar
ListApplications	Memberikan izin untuk membuat daftar semua aplikasi di akun	Daftar
ListArtifacts	Memberikan izin untuk membuat daftar semua artefak untuk ruang agen yang diberikan	Daftar	AgentSpace*
ListDesignReviewComments	Memberikan izin untuk membuat daftar komentar tinjauan desain	Daftar	AgentSpace*
ListDesignReviews	Memberikan izin untuk membuat daftar semua ulasan desain untuk ruang agen yang diberikan	Daftar	AgentSpace*
ListDiscoveredEndpoints	Memberikan izin untuk membuat daftar titik akhir yang ditemukan terkait dengan pekerjaan pentest dengan pemfilteran awalan URI opsional	Daftar	AgentSpace*		kms:Decrypt
ListFindings	Memberikan izin untuk membuat daftar temuan dengan dukungan penyaringan dan pagination	Daftar	AgentSpace*		kms:Decrypt
ListIntegratedResources	Memberikan izin untuk membuat daftar sumber daya terintegrasi untuk ruang agen	Daftar	AgentSpace*
ListIntegrations	Memberikan izin untuk mendapatkan integrasi yang dimiliki oleh pemanggil Akun AWS	Daftar
ListMemberships	Memberikan izin untuk membuat daftar semua anggota yang terkait dengan ruang agen dengan dukungan pagination	Daftar	AgentSpace*
ListPentestJobTasks	Memberikan izin untuk membuat daftar tugas pekerjaan pentest yang terkait dengan pekerjaan pentest	Daftar	AgentSpace*		kms:Decrypt
ListPentestJobsForPentest	Memberikan izin untuk membuat daftar pekerjaan uji penetrasi yang terkait dengan tes penetrasi	Daftar	AgentSpace*		kms:Decrypt
ListPentests	Memberikan izin untuk membuat daftar tes penetrasi dengan pemfilteran opsional berdasarkan status	Daftar	AgentSpace*		kms:Decrypt
ListResourcesFromIntegration	Memberikan izin untuk membuat daftar sumber daya dari Integrasi	Daftar	Integration*
ListSecurityRequirements	Memberikan izin untuk mencantumkan semua Persyaratan Keamanan	Daftar	SecurityRequirementPack*
ListTagsForResource	Memberikan izin untuk membuat daftar tag untuk sumber daya	Baca	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
ListTargetDomains	Memberikan izin untuk membuat daftar domain target	Daftar
PutDesignReviewFeedback	Memberikan izin untuk mengirimkan umpan balik untuk komentar tinjauan desain	Tulis	AgentSpace*
StartCodeRemediation	Memberikan izin untuk memulai remediasi kode untuk temuan	Tulis	AgentSpace*		kms:Decrypt kms:GenerateDataKey
StartPentestJob	Memberikan izin untuk memulai pelaksanaan tes penetrasi	Tulis	AgentSpace*		kms:Decrypt kms:GenerateDataKey
StopPentestJob	Memberikan izin untuk menghentikan eksekusi tes penetrasi yang sedang berjalan	Tulis	AgentSpace*		kms:Decrypt
TagResource	Memberikan izin untuk menambahkan tag ke sumber daya	Penandaan	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
				aws:RequestTag/${TagKey} aws:TagKeys
ToggleManagedSecurityRequirement	Memberikan izin untuk mengubah status Persyaratan Keamanan terkelola	Tulis	SecurityRequirementPack*
UntagResource	Memberikan izin untuk menghapus tag dari sumber daya	Penandaan	AgentSpace
			Application
			Integration
			SecurityRequirementPack
			TargetDomain
				aws:TagKeys
UpdateAgentSpace	Memberikan izin untuk memperbarui catatan ruang agen	Tulis	AgentSpace*		kms:Decrypt
UpdateApplication	Memberikan izin untuk memperbarui konfigurasi aplikasi	Tulis	Application*		iam:PassRole kms:DescribeKey
UpdateFinding	Memberikan izin untuk memperbarui temuan keamanan yang ada dengan detail atau status baru	Tulis	AgentSpace*		kms:Decrypt
UpdateIntegratedResources	Memberikan izin untuk memperbarui sumber daya terintegrasi untuk ruang agen	Tulis	AgentSpace*
UpdatePentest	Memberikan izin untuk memperbarui tes penetrasi yang ada dengan konfigurasi atau pengaturan baru	Tulis	AgentSpace*		kms:Decrypt
UpdateSecurityRequirement	Memberikan izin untuk memperbarui Persyaratan Keamanan yang dikelola pelanggan	Tulis	SecurityRequirementPack*
UpdateTargetDomain	Memberikan izin untuk memperbarui catatan domain target	Tulis	TargetDomain*
VerifyTargetDomain	Memberikan izin untuk memverifikasi kepemilikan domain target terdaftar	Tulis	TargetDomain*

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 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}`	aws:ResourceTag/${TagKey}
SecurityRequirementPack	`arn:${Partition}:securityagent:${Region}:${Account}:security-requirement-pack/${SecurityRequirementPackId}`	aws:ResourceTag/${TagKey}
Integration	`arn:${Partition}:securityagent:${Region}:${Account}:integration/${IntegrationId}`	aws:ResourceTag/${TagKey}
AgentSpace	`arn:${Partition}:securityagent:${Region}:${Account}:agent-space/${AgentId}`	aws:ResourceTag/${TagKey}
TargetDomain	`arn:${Partition}:securityagent:${Region}:${Account}:target-domain/${TargetDomainId}`	aws:ResourceTag/${TagKey}

Kunci kondisi untuk Agen AWS Keamanan

AWS Agen Keamanan mendefinisikan kunci kondisi berikut yang dapat digunakan dalam Condition elemen kebijakan IAM. Anda dapat menggunakan kunci ini untuk menyempurnakan syarat lebih lanjut saat pernyataan kebijakan berlaku. Untuk detail tentang kolom dalam tabel berikut, lihat Tabel tombol kondisi.

Untuk melihat kunci kondisi global yang tersedia untuk semua layanan, lihat kunci konteks kondisi AWS global.

Kunci syarat	Deskripsi	Jenis
aws:RequestTag/${TagKey}	Filter akses berdasarkan tanda yang diberikan dalam permintaan	String
aws:ResourceTag/${TagKey}	Filter akses dengan tanda yang terkait dengan sumber daya	String
aws:TagKeys	Filter akses berdasarkan kunci tanda yang diberikan dalam permintaan	ArrayOfString

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

AWS Secrets Manager

AWS Security Hub