View a markdown version of this page

Menggunakan JSON - Amazon Kendra

Amazon Kendra tidak akan lagi terbuka untuk pelanggan baru mulai 30 Juli 2026. Jika Anda ingin menggunakan layanan ini, silakan mendaftar sebelum 30 Juli. Untuk kemampuan yang mirip dengan Amazon Kendra, jelajahi Pangkalan Pengetahuan Amazon Bedrock. Pelajari selengkapnya.

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

Menggunakan JSON

Contoh berikut menunjukkan cara menggunakan JSON untuk kontrol akses pengguna saat Anda membuat indeks.

Awas

Token JSON adalah muatan yang tidak divalidasi. Ini hanya boleh digunakan ketika permintaan Amazon Kendra datang dari server tepercaya dan tidak pernah dari browser.

Console

  1. Pilih Buat indeks untuk mulai membuat indeks baru.

  2. Pada Tentukan detail indeks, beri indeks Anda nama dan deskripsi.

  3. Untuk IAM peran, pilih peran atau pilih Buat peran baru dan tentukan nama peran untuk membuat peran baru. IAM Peran akan memiliki awalan "AmazonKendra-”.

  4. Biarkan bidang lain dengan defaultnya. Pilih Berikutnya.

  5. Di halaman Konfigurasikan kontrol akses pengguna, di bawah Pengaturan kontrol akses, pilih Ya untuk menggunakan token untuk kontrol akses.

  6. Di bawah Konfigurasi token, pilih JSON sebagai Jenis token.

  7. Tentukan nama Pengguna yang akan digunakan dalam pemeriksaan ACL.

  8. Tentukan satu atau lebih Grup untuk digunakan dalam pemeriksaan ACL.

  9. Pilih Berikutnya.

  10. Di halaman Detail penyediaan, pilih Edisi Developer.

  11. Pilih Buat untuk membuat indeks Anda.

  12. Tunggu indeks Anda dibuat. Amazon Kendra menyediakan perangkat keras untuk indeks Anda. Operasi ini dapat memakan waktu lama.

CLI

Untuk membuat indeks dengan AWS CLI menggunakan file input JSON, pertama buat file JSON dengan parameter yang Anda inginkan:

{
    "Name": "user-context",
    "Edition": "ENTERPRISE_EDITION",
    "RoleArn": "arn:aws:iam::account-id:role:/my-role",
    "UserTokenConfigurations": [
        {
            "JsonTokenTypeConfiguration": {
                "UserNameAttributeField": "user",
                "GroupAttributeField": "group"
            }
        }
    ],
    "UserContextPolicy": "USER_TOKEN"
}

Selanjutnya, panggil create-index menggunakan file input. Misalnya, jika nama file JSON Anda adalah create-index-openid.json, Anda dapat menggunakan yang berikut ini: 

aws kendra create-index --cli-input-json file://create-index-openid.json

Jika Anda tidak menggunakan Open ID untuk AWS IAM Identity Center, Anda dapat mengirimkan token dalam format JSON kepada kami. Jika demikian, Anda harus menentukan bidang mana dalam token JSON yang berisi nama pengguna dan bidang mana yang berisi grup. Nilai bidang grup harus berupa array string JSON. Misalnya, jika menggunakan SAML, token Anda akan seperti berikut:

{
     "username" : "user1", 
     "groups": [
        "group1", 
        "group2"
     ]
}

TokenConfiguration akan menentukan nama pengguna dan nama bidang grup:

{
    "UserNameAttributeField":"username",
    "GroupAttributeField":"groups"
}
Python
response = kendra.create_index(
    Name='user-context',
    Edition='ENTERPRISE_EDITION',
    RoleArn='arn:aws:iam::account-id:role:/my-role',
    UserTokenConfigurations=[
        {
            "JwtTokenTypeConfiguration": {
                "UserNameAttributeField": "user",
                "GroupAttributeField": "group",
            }
        }
    ],
    UserContextPolicy='USER_TOKEN'
)