Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Bagaimana Amazon Kendra bekerja dengan IAM
Sebelum Anda menggunakan IAM untuk mengelola akses ke Amazon Kendra, Anda harus memahami IAM fitur apa yang tersedia untuk digunakan dengan Amazon Kendra. Untuk mendapatkan tampilan tingkat tinggi tentang cara kerja Amazon Kendra dan layanan AWS lainnya, AWS lihat Layanan yang IAM Berfungsi di IAM Panduan PenggunaIAM.
Topik
Kebijakan berbasis identitas Amazon Kendra
Dengan kebijakan IAM berbasis identitas, Anda dapat menentukan tindakan dan sumber daya yang diizinkan atau ditolak serta kondisi di mana tindakan diizinkan atau ditolak. Amazon Kendra mendukung tindakan, sumber daya, dan kunci syarat tertentu. Untuk mempelajari semua elemen yang Anda gunakan dalam JSON kebijakan, lihat Referensi Elemen IAM JSON Kebijakan di Panduan IAM Pengguna.
Tindakan
Administrator dapat menggunakan AWS JSON kebijakan untuk menentukan siapa yang memiliki akses ke apa. Yaitu, principal dapat melakukan tindakan pada suatu sumber daya, dan dalam suatu syarat.
Action
Elemen JSON kebijakan menjelaskan tindakan yang dapat Anda gunakan untuk mengizinkan atau menolak akses dalam kebijakan. Tindakan kebijakan biasanya memiliki nama yang sama dengan AWS API operasi terkait. Ada beberapa pengecualian, seperti tindakan khusus izin yang tidak memiliki operasi yang cocok. API Ada juga beberapa operasi yang memerlukan beberapa tindakan dalam suatu kebijakan. Tindakan tambahan ini disebut tindakan dependen.
Menyertakan tindakan dalam kebijakan untuk memberikan izin untuk melakukan operasi terkait.
Tindakan kebijakan di Amazon Kendra menggunakan prefiks berikut sebelum tindakan: kendra:
. Misalnya, untuk memberikan izin kepada seseorang untuk mencantumkan indeks Amazon Kendra dengan ListIndicesAPIoperasi, Anda menyertakan kendra:ListIndices
tindakan tersebut dalam kebijakan mereka. Pernyataan kebijakan harus memuat elemen Action
atau NotAction
. Amazon Kendra menentukan serangkaian tindakannya sendiri yang menjelaskan tugas yang dapat Anda lakukan dengan layanan ini.
Untuk menetapkan beberapa tindakan dalam satu pernyataan, pisahkan dengan koma seperti berikut:
"Action": [ "kendra:action1", "kendra:action2"
Anda dapat menentukan beberapa tindakan menggunakan wildcard (*). Sebagai contoh, untuk menentukan semua tindakan yang dimulai dengan kata Describe
, sertakan tindakan berikut:
"Action": "kendra:Describe*"
Untuk melihat daftar tindakan Amazon Kendra, lihat Tindakan yang Ditentukan oleh Amazon Kendra di IAM Panduan Pengguna.
Sumber daya
Administrator dapat menggunakan AWS JSON kebijakan untuk menentukan siapa yang memiliki akses ke apa. Yaitu, principal dapat melakukan tindakan pada suatu sumber daya, dan dalam suatu syarat.
Elemen Resource
JSON kebijakan menentukan objek atau objek yang tindakan tersebut berlaku. Pernyataan harus menyertakan elemen Resource
atau NotResource
. Sebagai praktik terbaik, tentukan sumber daya menggunakan Amazon Resource Name (ARN). Anda dapat melakukan ini untuk tindakan yang mendukung jenis sumber daya tertentu, yang dikenal sebagai izin tingkat sumber daya.
Untuk tindakan yang tidak mendukung izin di tingkat sumber daya, misalnya operasi pencantuman, gunakan wildcard (*) untuk menunjukkan bahwa pernyataan tersebut berlaku untuk semua sumber daya.
"Resource": "*"
Sumber daya indeks Amazon Kendra memiliki yang berikut: ARN
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}
Untuk informasi selengkapnya tentang formatARNs, lihat Amazon Resource Names (ARNs) dan Ruang Nama AWS Layanan.
Misalnya, untuk menentukan indeks dalam pernyataan Anda, gunakan indeks berikut iniARN: GUID
"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"
Untuk menetapkan semua indeks milik akun tertentu, gunakan wildcard (*):
"Resource": "arn:aws:${Region}:${Account}:index/*"
Beberapa tindakan Amazon Kendra, seperti membuat sumber daya, tidak dapat dilakukan pada sumber daya tertentu. Dalam kasus tersebut, Anda harus menggunakan wildcard (*).
"Resource": "*"
Untuk melihat daftar jenis sumber daya Amazon Kendra dan jenisnyaARNs, lihat Sumber Daya yang Ditentukan oleh Amazon Kendra di IAM Panduan Pengguna. Untuk mempelajari tindakan mana yang dapat Anda tentukan ARN dari setiap sumber daya, lihat Tindakan yang Ditentukan oleh Amazon Kendra.
Kunci syarat
Administrator dapat menggunakan AWS JSON kebijakan untuk menentukan siapa yang memiliki akses ke apa. Yaitu, di mana utama dapat melakukan tindakan pada sumber daya, dan dalam kondisi apa.
Elemen Condition
(atau blok Condition
) akan memungkinkan Anda menentukan kondisi yang menjadi dasar suatu pernyataan berlaku. Elemen Condition
bersifat opsional. Anda dapat membuat ekspresi bersyarat yang menggunakan operator kondisi, misalnya sama dengan atau kurang dari, untuk mencocokkan kondisi dalam kebijakan dengan nilai-nilai yang diminta.
Jika Anda menentukan beberapa elemen Condition
dalam sebuah pernyataan, atau beberapa kunci dalam elemen Condition
tunggal, maka AWS akan mengevaluasinya menggunakan operasi AND
logis. Jika Anda menentukan beberapa nilai untuk satu kunci kondisi, AWS mengevaluasi kondisi menggunakan OR
operasi logis. Semua kondisi harus dipenuhi sebelum izin pernyataan diberikan.
Anda juga dapat menggunakan variabel placeholder saat menentukan kondisi. Misalnya, Anda dapat memberikan izin IAM pengguna untuk mengakses sumber daya hanya jika ditandai dengan nama IAM pengguna mereka. Untuk informasi selengkapnya, lihat elemen IAM kebijakan: variabel dan tag di Panduan IAM Pengguna.
AWS mendukung kunci kondisi global dan kunci kondisi khusus layanan. Untuk melihat semua kunci kondisi AWS global, lihat kunci konteks kondisi AWS global di Panduan IAM Pengguna.
Amazon Kendra tidak menyediakan kunci syarat khusus layanan, tetapi mendukung penggunaan beberapa kunci syarat global. Untuk melihat semua kunci kondisi AWS global, lihat Kunci Konteks Kondisi AWS Global di Panduan IAM Pengguna.
Contoh
Untuk melihat contoh kebijakan berbasis identitas Amazon Kendra, lihat Contoh kebijakan berbasis Identitas Amazon Kendra.
Kebijakan berbasis Sumber Daya Amazon Kendra
Amazon Kendra tidak mendukung kebijakan berbasis sumber daya.
Daftar kontrol akses (ACLs)
Amazon Kendra tidak mendukung daftar kontrol akses (ACLs) untuk akses ke AWS layanan dan sumber daya.
Otorisasi berdasarkan tanda Amazon Kendra
Anda dapat mengaitkan tanda dengan jenis sumber daya Amazon Kendra tertentu untuk mengotorisasi akses ke sumber daya tersebut. Untuk mengontrol akses berdasarkan tanda, berikan informasi tanda dalam elemen syarat kebijakan menggunakan aws:RequestTag/
, atau kunci syarat key-name
aws:TagKeys
.
Tabel berikut mencantumkan tindakan, jenis sumber daya yang sesuai, dan kunci syarat untuk kontrol akses berbasis tanda. Setiap tindakan diotorisasi berdasarkan tanda yang terkait dengan jenis sumber daya yang sesuai.
Tindakan | Jenis sumber daya | Kunci syarat |
---|---|---|
CreateDataSource | aws:RequestTag , aws:TagKeys |
|
CreateFaq | aws:RequestTag , aws:TagKeys |
|
CreateIndex | aws:RequestTag , aws:TagKeys |
|
API_ListTagsForResource | sumber data,FAQ, indeks | |
TagResource | sumber data,FAQ, indeks | aws:RequestTag , aws:TagKeys |
UntagResource | sumber data,FAQ, indeks | aws:TagKeys |
Untuk informasi selengkapnya tentang penandaan sumber daya Amazon Kendra, lihat Tag. Untuk melihat contoh kebijakan berbasis identitas yang membatasi akses ke sumber daya berdasarkan tanda sumber daya, lihat Contoh kebijakan berbasis tanda. Untuk informasi selengkapnya tentang penggunaan tag untuk membatasi akses ke sumber daya, lihat Mengontrol akses menggunakan tag di Panduan IAM Pengguna.
Peran Amazon Kendra IAM
IAMPeran adalah entitas dalam AWS akun Anda yang memiliki izin khusus.
Menggunakan kredensial sementara dengan Amazon Kendra
Anda dapat menggunakan kredensi sementara untuk masuk dengan federasi, mengambil IAM peran, atau untuk mengambil peran lintas akun. Anda memperoleh kredensi keamanan sementara dengan memanggil AWS STS API operasi seperti AssumeRoleatau. GetFederationToken
Amazon Kendra mendukung penggunaan kredensial sementara.
Peran layanan
Fitur ini memungkinkan layanan untuk menerima peran layanan atas nama Anda. Peran ini mengizinkan layanan untuk mengakses sumber daya di layanan lain untuk menyelesaikan tindakan atas nama Anda. Peran layanan muncul di IAM akun Anda dan dimiliki oleh akun. Ini berarti bahwa IAM administrator dapat mengubah izin untuk peran ini. Namun, melakukan hal itu dapat merusak fungsionalitas layanan.
Amazon Kendra mendukung peran layanan.
Memilih IAM peran di Amazon Kendra
Saat Anda membuat indeks, memanggil BatchPutDocument
operasi, membuat sumber data, atau membuatFAQ, Anda harus memberikan peran akses Amazon Resource Name (ARN) yang digunakan Amazon Kendra untuk mengakses sumber daya yang diperlukan atas nama Anda. Jika sudah membuat peran, konsol Amazon Kendra akan memberi Anda daftar peran untuk dipilih. Penting untuk memilih peran yang mengizinkan akses ke sumber daya yang Anda butuhkan. Untuk informasi selengkapnya, lihat IAM peran akses untuk Amazon Kendra.