View a markdown version of this page

Otentikasi IAM 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.

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

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}}" }] }'
catatan

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}}
catatan

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
catatan

/_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
penting

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.