Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Otentikasi IAM untuk OpenSearch UI
Topik ini mencakup izin IAM minimum yang diperlukan untuk mengakses OpenSearch Aplikasi UI yang menggunakan otentikasi IAM, tanpa Pusat Identitas AWS IAM. Setelah Anda menyelesaikan langkah-langkah ini, peran IAM dapat masuk ke aplikasi dan menanyakan sumber datanya.
Prasyarat
-
Sebuah OpenSearch Aplikasi UI dibuat dengan otentikasi IAM. Untuk petunjuk tentang membuat aplikasi, lihat Memulai dengan OpenSearch antarmuka pengguna di Amazon OpenSearch Pelayanan.
-
Peran IAM yang membutuhkan akses ke aplikasi.
-
The AWS CLI dikonfigurasi dengan kredenSIAL.
Langkah 1: Berikan izin IAM
Kebijakan IAM berikut memberikan akses ke antarmuka aplikasi. Lampirkan ke peran IAM yang membutuhkan akses, dan 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/{{application-id}}" } ] }
Mencakup sumber daya ke ID aplikasi tunggal memberikan hak istimewa paling sedikit yang dibutuhkan peran tersebut. Untuk memberikan akses ke setiap aplikasi di akun dan Wilayah sebagai gantinya, gunakan wildcard:
"Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*"
Anda dapat melampirkan kebijakan yang sama dengan AWS CLI:
aws iam put-role-policy \ --role-name {{role-name}} \ --policy-name OpenSearchAppAccess \ --policy-document '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Action":"opensearch:ApplicationAccessAll", "Resource":"arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}" }] }'
Tindakan yang memberikan akses ke antarmuka aplikasi adalah opensearch:ApplicationAccessAll. Untuk informasi selengkapnya tentang izin yang diperlukan aplikasi, lihat Referensi kebijakan IAM untuk OpenSearch UI.
Jika pengguna Anda juga membuka aplikasi dari Konsol Manajemen AWS, tambahkan pernyataan berikut, sehingga mereka dapat melihat aplikasi di konsol:
{ "Effect": "Allow", "Action": "es:GetApplication", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/{{application-id}}" }
Langkah 2: Konfigurasikan administrator dasbor
Tetapkan prinsipal IAM mana yang menerima hak administrator di dalamnya OpenSearch UI. Untuk memberikan hak administrator kepada semua pengguna yang diautentikasi, jalankan perintah berikut:
aws opensearch update-application \ --id {{application-id}} \ --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"*"}]' \ --region {{region}}
Untuk memberikan hak administrator ke peran tunggal, tentukan peran ARN:
aws opensearch update-application \ --id {{application-id}} \ --app-configs '[{"key":"opensearchDashboards.dashboardAdmin.users","value":"arn:aws:iam::{{account-id}}:role/{{role-name}}"}]' \ --region {{region}}
Pengaturan administrator dasbor mengontrol fitur administrator di dalam antarmuka, seperti manajemen pola indeks dan objek yang disimpan. Anda tidak memerlukannya untuk masuk — kebijakan IAM pada langkah 1 sudah cukup untuk mengakses aplikasi.
Langkah 3: Verifikasi akses
Anda dapat memverifikasi akses dari browser dengan URL yang telah ditandatangani sebelumnya, atau secara terprogram dengan header permintaan Signature Version 4.
Verifikasi akses dari browser
Contoh kode Python berikut menghasilkan URL tanda tangan Versi 4 yang telah ditandatangani sebelumnya yang Anda buka di browser:
from botocore.session import Session from botocore.auth import SigV4QueryAuth from botocore.awsrequest import AWSRequest session = Session() cred = session.get_credentials().get_frozen_credentials() endpoint = "{{application-endpoint}}" region = "{{region}}" url = f"https://{endpoint}/_login/" request = AWSRequest(method="GET", url=url) SigV4QueryAuth(cred, "opensearch", region, expires=300).add_auth(request) print(request.url) # Open this URL in a browser
/_login/ URL yang telah ditandatangani hanya berfungsi di browser. Itu tidak bekerja dengan curl atau klien HTTP lainnya.
Verifikasi akses secara terprogram
Contoh kode Python berikut menandatangani permintaan ke titik akhir aplikasi dengan header Signature Version 4:
from botocore.session import Session from botocore.auth import SigV4Auth from botocore.awsrequest import AWSRequest import subprocess session = Session() cred = session.get_credentials().get_frozen_credentials() endpoint = "{{application-endpoint}}" region = "{{region}}" url = f"https://{endpoint}/" request = AWSRequest(method="GET", url=url) SigV4Auth(cred, "opensearch", region).add_auth(request) cmd = ["curl", "-s", "-w", "\nHTTP: %{http_code}\n", "-D", "-"] for k, v in request.headers.items(): cmd.extend(["-H", f"{k}: {v}"]) cmd.append(url) result = subprocess.run(cmd, capture_output=True, text=True) print(result.stdout)
Permintaan yang berhasil dikembalikan HTTP/1.1 302 Found dengan location tajuk dari /app/workspace_initial. Permintaan yang kembali HTTP/1.1 403 Forbidden menunjukkan masalah dengan kebijakan IAM.
Rincian penandatanganan Signature Versi 4
Tabel berikut mencantumkan parameter Signature Version 4 yang OpenSearch UI mengharapkan.
| Parameter | Nilai |
|---|---|
| Nama layanan | opensearch |
| Algoritme | AWS4-HMAC-SHA256 |
| Header yang ditandatangani | host, minimal |
| Kedaluwarsa URL yang telah ditandatangani sebelumnya | Direkomendasikan tidak lebih dari 300 detik |
Nama layanan Signature Version 4 adalah opensearch. Menandatangani dengan es atau aoss menyebabkan permintaan gagal.
Ringkasan konfigurasi
Tabel berikut mencantumkan apa yang dikontrol setiap lapisan konfigurasi.
| Lapisan | Konfigurasi | Diperlukan untuk masuk? |
|---|---|---|
| kebijakan IAM | opensearch:ApplicationAccessAll pada aplikasi ARN |
Ya |
| kebijakan IAM | es:GetApplication pada aplikasi ARN |
Hanya untuk membuka aplikasi dari Konsol Manajemen AWS |
| Konfigurasi aplikasi | opensearchDashboards.dashboardAdmin.users |
Tidak — hanya mengontrol fitur administrator |
Memecahkan masalah otentikasi IAM
Masalah otentikasi IAM biasanya berasal dari tindakan kebijakan yang hilang, URL yang telah ditandatangani sebelumnya yang digunakan di luar browser, atau permintaan yang ditandatangani dengan nama layanan yang salah. Tabel berikut mencantumkan gejala umum, kemungkinan penyebabnya, dan cara mengatasinya.
| Gejala | Kemungkinan penyebabnya | Resolusi |
|---|---|---|
403 Forbidden saat Anda membuka URL aplikasi |
opensearch:ApplicationAccessAll Izin hilang |
Menambahkan kebijakan IAM dari langkah 1 |
403 dengan pesan bahwa Anda tidak berwenang untuk melakukan es:GetApplication |
Izin konsol hilang | Tambah es:GetApplication pada aplikasi ARN. Hal ini diperlukan hanya untuk Konsol Manajemen AWS akses |
400 Bad Request di atas /_login/ bersama curl |
/_login/ titik akhir hanya berfungsi di browser |
Gunakan otentikasi header Signature Versi 4 pada / untuk akses terprogram |
URL yang telah ditandatangani kembali SignatureDoesNotMatch |
Nama layanan Signature Version 4 salah | Tanda tangani permintaan dengan opensearch, tidak es atau aoss |
| Anda dapat membuka aplikasi tetapi fitur administrator hilang | Administrator dasbor tidak dikonfigurasi | Jalankan update-application bersama opensearchDashboards.dashboardAdmin.users, seperti yang dijelaskan pada langkah 2 |
| URL yang ditandatangani sebelumnya telah kedaluwarsa | URL dibuat lebih dari 300 detik sebelumnya | Buat URL baru yang ditandatangani sebelumnya. URL yang ditandatangani sebelumnya berumur pendek |
Untuk informasi lebih lanjut tentang tindakan IAM yang OpenSearch Penggunaan UI, lihat Referensi kebijakan IAM untuk OpenSearch UI.