View a markdown version of this page

Pusat Identitas AWS IAM otentikasi untuk OpenSearch UI - Amazon OpenSearch Pelayanan

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

Pusat Identitas AWS IAM otentikasi untuk OpenSearch UI

Dengan Pusat Identitas AWS IAM, tim Anda mendapatkan pengalaman masuk tunggal berbasis browser. Pengguna Anda masuk dengan Pusat Identitas AWS IAM kredenSIAL alih-alih menghasilkan URL yang ditandatangani sebelumnya.

Prasyarat

  • Sebuah AWS akun dengan basis dan Pusat Identitas AWS IAM Izin IAM. Untuk informasi lebih lanjut tentang izin yang diperlukan, lihat Referensi kebijakan IAM untuk OpenSearch UI.

  • Pusat Identitas AWS IAM diaktifkan di akun atau organisasi Anda. Perhatikan apakah Anda memiliki instance organisasi atau instance akun, karena ini memengaruhi beberapa langkah konfigurasi.

  • Peran IAM dengan kebijakan izin yang diperlukan dan kebijakan kepercayaan. Anda membuat peran ini di Langkah 2: Buat peran IAM.

  • Setidaknya satu OpenSearch domain atau koleksi tanpa server di AWS Wilayah.

  • Setidaknya satu pengguna atau grup dibuat di Pusat Identitas AWS IAM.

Prasyarat tambahan untuk instance organisasi yang menggunakan kunci yang dikelola pelanggan

Jika contoh organisasi Anda Pusat Identitas AWS IAM menggunakan kunci yang dikelola pelanggan untuk enkripsi saat istirahat, Anda harus memberikan OpenSearch Izin UI untuk mendekripsi data identitas dengan kunci itu. Tanpa izin ini, sistem masuk tunggal gagal dengan AccessDeniedException sambil OpenSearch UI memvalidasi kode otorisasi.

Untuk memeriksa apakah instance Anda menggunakan kunci yang dikelola pelanggan, buka Pusat Identitas AWS IAM konsol, pilih Pengaturan, pilih Manajemen tab, dan ulasan Kunci untuk mengenkripsi data Pusat Identitas IAM saat diam. Jika itu menunjukkan kunci yang dikelola pelanggan ARN daripada sebuah AWS kunci yang dimiliki, tambahkan pernyataan berikut ke kebijakan kunci di akun manajemen di mana Pusat Identitas AWS IAM diaktifkan. Ganti organization-id dengan milikmu AWS ID organisasi organisasi, dalam format o-xxxxxxxxxx.

{ "Sid": "Allow_AWS_app_admins_in_the_same_AWS_organization_to_use_the_KMS_key", "Effect": "Allow", "Principal": "*", "Action": [ "kms:Decrypt" ], "Resource": "*", "Condition": { "StringEquals": { "aws:PrincipalOrgID": "{{organization-id}}" }, "StringLike": { "kms:ViaService": [ "sso.*.amazonaws.com", "identitystore.*.amazonaws.com" ] } } }, { "Sid": "Allow_managed_apps_to_use_the_KMS_Key", "Effect": "Allow", "Principal": "*", "Action": [ "kms:Decrypt" ], "Resource": "*", "Condition": { "Bool": { "aws:PrincipalIsAWSService": "true" }, "StringLike": { "kms:ViaService": [ "sso.*.amazonaws.com", "identitystore.*.amazonaws.com" ] }, "StringEquals": { "aws:SourceOrgID": "{{organization-id}}" } } }

Untuk informasi lebih lanjut, lihat Kunci yang dikelola pelanggan di Pusat Identitas AWS IAM Panduan Pengguna.

Langkah 1: Verifikasi bahwa Pusat Identitas AWS IAM diaktifkan

Untuk memverifikasi itu Pusat Identitas AWS IAM diaktifkan
  1. Buka AWS konsol Pusat Identitas IAM.

  2. Jika konsol menampilkan dasbor dengan detail instans Anda, Pusat Identitas AWS IAM diaktifkan. Perhatikan apakah instance tersebut merupakan instance organisasi atau instance akun.

  3. Jika konsol menampilkan halaman pengaturan, aktifkan Pusat Identitas AWS IAM sebelum Anda melanjutkan.

Instans organisasi berfungsi di semua akun di AWS Organisasi organisasi, dan direkomendasikan untuk penggunaan produksi. Instans akun dicakup ke satu akun, yang sesuai dengan pengujian dan pengaturan terisolasi. Jika akun Anda milik organisasi yang dikelola orang lain, tanyakan kepada administrator Anda apakah Pusat Identitas AWS IAM harus diaktifkan di tingkat organisasi.

Langkah 2: Buat peran IAM

Pusat Identitas AWS IAM mengambil peran IAM saat pengguna mengakses OpenSearch Aplikasi UI. Peran itu memerlukan kebijakan izin, yang mendefinisikan apa yang dapat dilakukan peran, dan kebijakan kepercayaan, yang menentukan siapa yang dapat mengambil peran tersebut.

Gunakan kebijakan izin berikut. Ganti nilai placeholder dengan informasi Anda sendiri.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "opensearch:ApplicationAccessAll", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*" } ] }

Gunakan kebijakan kepercayaan berikut, yang memungkinkan Pusat Identitas AWS IAM untuk mengambil peran:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sso.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

Untuk membuat peran dan melampirkan kebijakan izin dengan AWS CLI, jalankan perintah berikut:

aws iam create-role \ --role-name OpenSearchUI-IDC-Role \ --assume-role-policy-document '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Principal":{"Service":"sso.amazonaws.com"}, "Action":"sts:AssumeRole" }] }' aws iam put-role-policy \ --role-name OpenSearchUI-IDC-Role \ --policy-name OpenSearchAppAccess \ --policy-document '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Action":"opensearch:ApplicationAccessAll", "Resource":"arn:aws:opensearch:{{region}}:{{account-id}}:application/*" }] }'

Perhatikan ARN peran. Anda menentukannya di langkah berikutnya. ARN memiliki format arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role.

Langkah 3: Buat aplikasi dengan Pusat Identitas AWS IAM diaktifkan

Untuk mulai membuat aplikasi
  1. Buka Amazon OpenSearch Konsol layanan.

  2. Pada menu navigasi, pilih OpenSearch UI (Dasbor).

  3. Pilih Create application (Buat aplikasi).

  4. Masukkan nama untuk aplikasi.

  5. Tambahkan setidaknya satu sumber data, baik OpenSearch domain atau koleksi tanpa server.

Lanjutkan dalam formulir yang sama untuk mengaktifkan single sign-on dan selesai membuat aplikasi.

Untuk mengaktifkan Pusat Identitas AWS IAM dan buat aplikasi
  1. Pilih Otentikasi dengan Pusat Identitas IAM kotak centang.

  2. Pilih peran IAM yang Anda buat Langkah 2: Buat peran IAM.

  3. (Opsional) Konfigurasikan administrator dasbor.

  4. Pilih Buat.

Untuk membuat aplikasi yang sama dengan AWS CLI, jalankan perintah berikut. Ganti nilai placeholder dengan informasi Anda sendiri.

aws opensearch create-application \ --name "{{application-name}}" \ --iam-identity-center-options '{ "enabled": true, "iamRoleForIdentityCenterApplicationArn": "arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role" }' \ --data-sources '[{ "dataSourceArn": "arn:aws:es:{{region}}:{{account-id}}:domain/{{domain-name}}" }]' \ --region {{region}}

Langkah 4: Tetapkan pengguna di Pusat Identitas AWS IAM

Untuk menetapkan pengguna atau grup ke aplikasi
  1. Buka AWS konsol Pusat Identitas IAM.

  2. Pada menu navigasi, pilih Aplikasi.

  3. Pilih aplikasi yang OpenSearch UI terdaftar secara otomatis. Namanya cocok dengan Anda OpenSearch Nama aplikasi UI.

  4. Memilih Menetapkan pengguna dan grup.

  5. Pilih pengguna atau grup yang membutuhkan akses, lalu pilih Menetapkan.

Langkah 5: Verifikasi pengaturan

Untuk memverifikasi pengaturan
  1. Di Amazon OpenSearch Konsol layanan, konfirmasikan bahwa status aplikasi adalah Aktif, yang menunjukkan bahwa aplikasi siap digunakan.

  2. Konfirmasikan itu Otentikasi dengan Pusat Identitas IAM diaktifkan pada halaman detail aplikasi.

  3. Salin URL aplikasi dari halaman detail aplikasi.

  4. Buka URL aplikasi di browser. Anda diarahkan ke Pusat Identitas AWS IAM halaman masuk.

  5. Masuk dengan Pusat Identitas AWS IAM kredenSIAL. Yang OpenSearch Pemilih ruang kerja UI muncul.

Mengelola pengguna dan grup secara terprogram

Ketika Anda membuat OpenSearch Aplikasi UI dengan Pusat Identitas AWS IAM diaktifkan, OpenSearch UI mendaftarkan Pusat Identitas AWS IAM aplikasi. Anda harus menetapkan pengguna ke aplikasi tersebut sebelum mereka dapat masuk. Ada dua tingkat akses yang terpisah:

Penugasan aplikasi

Mengontrol siapa yang dapat masuk OpenSearch UI. Anda mengelolanya dengan sso-admin perintah.

Administrator aplikasi

Mengontrol siapa yang dapat mengedit atau menghapus aplikasi dan mengelola ruang kerjanya. Anda mengelolanya dengan aws opensearch update-application. Untuk informasi selengkapnya tentang administrator aplikasi, lihat Mengelola administrator aplikasi.

Anda memerlukan tiga pengidentifikasi sebelum mengelola tugas.

Pengidentifikasi Cara mendapatkannya
Yang Pusat Identitas AWS IAM aplikasi ARN aws opensearch get-application, dalam iamIdentityCenterOptions.iamIdentityCenterApplicationArn
ID penyimpanan identitas aws sso-admin list-instances, dalam Instances[0].IdentityStoreId
ID pengguna atau grup aws identitystore list-users atau aws identitystore list-groups

Perintah berikut menemukan pengguna dengan nama pengguna mereka, dan grup dengan nama tampilannya. Ganti placeholder values dengan informasi Anda sendiri:

aws identitystore list-users \ --identity-store-id {{identity-store-id}} \ --filters '[{"AttributePath":"UserName","AttributeValue":"{{user-name}}"}]' \ --region {{region}} \ --query 'Users[0].UserId' --output text aws identitystore list-groups \ --identity-store-id {{identity-store-id}} \ --filters '[{"AttributePath":"DisplayName","AttributeValue":"{{group-name}}"}]' \ --region {{region}} \ --query 'Groups[0].GroupId' --output text

Perintah berikut menetapkan pengguna atau grup ke aplikasi, dan meninjau atau menghapus tugas. Untuk grup, atur --principal-type kepada GROUP dan gunakan ID grup yang Anda temukan sebelumnya sebagai ID utama:

aws sso-admin create-application-assignment \ --application-arn {{identity-center-application-arn}} \ --principal-id {{principal-id}} \ --principal-type USER \ --region {{region}} aws sso-admin list-application-assignments \ --application-arn {{identity-center-application-arn}} \ --region {{region}} aws sso-admin delete-application-assignment \ --application-arn {{identity-center-application-arn}} \ --principal-id {{principal-id}} \ --principal-type USER \ --region {{region}}

Jika pengguna atau grup belum ada di toko identitas Anda, buat dengan aws identitystore create-user atau aws identitystore create-group, dan menambahkan anggota dengan aws identitystore create-group-membership.

Contoh kode Python berikut mencari pengguna berdasarkan nama pengguna dan menetapkan pengguna itu ke aplikasi dengan AWS SDK untuk Python (Boto3):

import boto3 region = "{{region}}" app_id = "{{application-id}}" opensearch = boto3.client("opensearch", region_name=region) sso_admin = boto3.client("sso-admin", region_name=region) identity_store = boto3.client("identitystore", region_name=region) app = opensearch.get_application(id=app_id) idc_app_arn = app["iamIdentityCenterOptions"]["iamIdentityCenterApplicationArn"] identity_store_id = sso_admin.list_instances()["Instances"][0]["IdentityStoreId"] users = identity_store.list_users( IdentityStoreId=identity_store_id, Filters=[{"AttributePath": "UserName", "AttributeValue": "{{user-name}}"}], ) user_id = users["Users"][0]["UserId"] sso_admin.create_application_assignment( ApplicationArn=idc_app_arn, PrincipalId=user_id, PrincipalType="USER", )

Pemecahan Masalah Pusat Identitas AWS IAM autentikasi

Pusat Identitas AWS IAM masalah otentikasi biasanya berasal dari kebijakan kepercayaan yang menghilangkan sso.amazonaws.com, kebijakan izin yang tidak memiliki tindakan yang diperlukan, atau pengguna yang tidak ditugaskan ke aplikasi. Tabel berikut mencantumkan gejala umum, kemungkinan penyebabnya, dan cara mengatasinya.

Gejala Kemungkinan penyebabnya Resolusi
Sebuah pesan yang Pusat Identitas AWS IAM tidak diaktifkan muncul saat Anda membuat aplikasi Tidak ada contoh di akun atau organisasi Anda Aktifkan Pusat Identitas AWS IAM di Pusat Identitas AWS IAM konsol
Pengalihan masuk tunggal tetapi mengembalikan kesalahan Kebijakan kepercayaan peran tidak termasuk sso.amazonaws.com Memperbarui kebijakan kepercayaan seperti yang dijelaskan dalam Langkah 2: Buat peran IAM
Sign-in berhasil tetapi pengguna tidak memiliki akses Pengguna tidak ditugaskan ke aplikasi Menetapkan pengguna di Pusat Identitas AWS IAM konsol, seperti yang dijelaskan dalam Langkah 4: Tetapkan pengguna di Pusat Identitas AWS IAM
Akses ditolak setelah masuk Kebijakan izin peran tidak memiliki tindakan yang diperlukan Konfirmasikan bahwa peran tersebut memiliki opensearch:ApplicationAccessAll dan izin untuk mengakses sumber data
Aplikasi menunjukkan Pusat Identitas AWS IAM sebagaimana diaktifkan, tetapi masuk gagal Peran ARN tidak cocok Konfirmasikan bahwa peran ARN dalam pengaturan aplikasi adalah peran yang memiliki kebijakan kepercayaan dan izin yang benar
Aplikasi tidak dapat dibuat dengan Pusat Identitas AWS IAM Pusat Identitas AWS IAM izin tidak ada Konfirmasikan bahwa kepala sekolah IAM Anda memiliki sso:CreateApplication, sso:PutApplicationGrant, dan iam:PassRole
Halaman masuk muncul tetapi tidak ada pengguna yang dapat masuk Tidak ada pengguna yang ditugaskan di Pusat Identitas AWS IAM Menetapkan pengguna ke aplikasi di Pusat Identitas AWS IAM konsol
Sign-in gagal dengan pesan bahwa kode otorisasi tidak dapat divalidasi, atau dengan AccessDeniedException Pusat Identitas AWS IAM menggunakan kunci yang dikelola pelanggan tanpa kebijakan kunci yang diperlukan Menambahkan pernyataan kebijakan utama yang dijelaskan sebelumnya dalam topik ini
Pengguna tidak dapat masuk segera setelah ditugaskan Tugas belum disebarkan Tunggu satu hingga dua menit, lalu coba lagi
AccessDeniedException pada create-application-assignment Yang sso:CreateApplicationAssignment Izin hilang Tambahkan Pusat Identitas AWS IAM izin yang tercantum di Referensi kebijakan IAM untuk OpenSearch UI
ConflictException pada tugas Pengguna atau grup sudah ditugaskan Konfirmasikan dengan list-application-assignments