Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
AWS IAM Identity Center Authentifizierung für OpenSearch UI
Mit AWS IAM Identity Center, Ihr Team erhält ein browserbasiertes Single-Sign-On-Erlebnis. Ihre Benutzer melden sich mit ihren AWS IAM Identity Center Anmeldeinformationen, anstatt vorsignierte URLs zu generieren.
Voraussetzungen
-
Ein AWS Konto sowohl mit der Basis als auch mit der AWS IAM Identity Center IAM-Berechtigungen. Weitere Informationen zu den erforderlichen Berechtigungen finden Sie unter IAM-Richtlinienreferenz für OpenSearch UI.
-
AWS IAM Identity Center in Ihrem Konto oder Ihrer Organisation aktiviert. Beachten Sie, ob Sie eine Organisations- oder eine Kontoinstanz haben, da sich dies auf einige Konfigurationsschritte auswirkt.
-
Eine IAM-Rolle mit sowohl der erforderlichen Berechtigungsrichtlinie als auch einer Vertrauensrichtlinie. Sie erstellen diese Rolle in Schritt 2: Erstellen der IAM-Rolle.
-
Mindestens einer OpenSearch domänen- oder serverlose Sammlung in der AWS Region.
-
Mindestens ein Benutzer oder eine Gruppe wurde erstellt in AWS IAM Identity Center.
Zusätzliche Voraussetzung für eine Organisationsinstanz, die einen vom Kunden verwalteten Schlüssel verwendet
Wenn Ihre Organisationsinstanz von AWS IAM Identity Center verwendet einen vom Kunden verwalteten Schlüssel für die Verschlüsselung im Ruhezustand, den Sie gewähren müssen OpenSearch UI-Erlaubnis, Identitätsdaten mit diesem Schlüssel zu entschlüsseln. Ohne diese Berechtigung schlägt Single Sign-On fehl mit AccessDeniedException während OpenSearch UI validiert den Autorisierungscode.
Um zu überprüfen, ob Ihre Instanz einen vom Kunden verwalteten Schlüssel verwendet, öffnen Sie das AWS IAM Identity Center
Konsole, wählen Sie Einstellungen, wähle die Verwaltung Tab und Bewertung Schlüssel für die Verschlüsselung von IAM Identity Center-Daten im Ruhezustand. Wenn es einen vom Kunden verwalteten Schlüssel-ARN und nicht einen anzeigt AWS eigener Schlüssel, fügen Sie der Schlüsselrichtlinie im Verwaltungskonto die folgenden Anweisungen hinzu AWS IAM Identity Center ist aktiviert. Ersetzen organization-id mit deinem AWS Organisations-ID der Organisation im 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}}" } } }
Weitere Informationen finden Sie unter Vom Kunden verwaltete Schlüssel in der AWS IAM Identity Center Benutzerleitfaden.
Schritt 1: Stellen Sie sicher, dass AWS IAM Identity Center ist aktiviert
Um das zu überprüfen AWS IAM Identity Center ist aktiviert
-
Öffnen Sie die AWS IAM-Identity-Center-Konsole
. -
Wenn die Konsole ein Dashboard mit Ihren Instanzdetails anzeigt, AWS IAM Identity Center ist aktiviert. Beachten Sie, ob es sich bei der Instanz um eine Organisations- oder eine Kontoinstanz handelt.
-
Wenn auf der Konsole eine Einrichtungsseite angezeigt wird, aktivieren Sie AWS IAM Identity Center bevor Sie fortfahren.
Eine Organisationsinstanz funktioniert für alle Konten in Ihrem AWS Organisation der Organisation, und es wird für den Einsatz in der Produktion empfohlen. Eine Kontoinstanz ist auf ein einzelnes Konto beschränkt, was für Tests und isolierte Setups geeignet ist. Wenn Ihr Konto zu einer Organisation gehört, die von einer anderen Person verwaltet wird, fragen Sie Ihren Administrator AWS IAM Identity Center muss auf Organisationsebene aktiviert werden.
Schritt 2: Erstellen der IAM-Rolle
AWS IAM Identity Center nimmt eine IAM-Rolle an, wenn Benutzer auf Ihre zugreifen OpenSearch UI-Anwendung. Diese Rolle benötigt eine Berechtigungsrichtlinie, die definiert, was die Rolle tun kann, und eine Vertrauensrichtlinie, die definiert, wer die Rolle übernehmen kann.
Verwenden Sie die folgende Berechtigungsrichtlinie. Ersetzen Sie die Platzhalterwerte durch Ihre Informationen.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "opensearch:ApplicationAccessAll", "Resource": "arn:aws:opensearch:{{region}}:{{account-id}}:application/*" } ] }
Verwenden Sie die folgende Vertrauensrichtlinie, die Folgendes ermöglicht AWS IAM Identity Center um die Rolle zu übernehmen:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "sso.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Um die Rolle zu erstellen und die Berechtigungsrichtlinie mit dem anzuhängen AWS CLI, führen Sie die folgenden Befehle aus:
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/*" }] }'
Beachten Sie die Rollen-ARN. Sie geben es im nächsten Schritt an. Der ARN hat das Format arn:aws:iam::{{account-id}}:role/OpenSearchUI-IDC-Role.
Schritt 3: Erstellen Sie die Anwendung mit AWS IAM Identity Center aktiviert
Um mit der Erstellung der Anwendung zu beginnen
-
Öffnen Sie das Amazon OpenSearch Servicekonsole
. -
Wählen Sie im Navigationsmenü OpenSearch Benutzeroberfläche (Dashboards).
-
Wählen Sie Create application aus.
-
Geben Sie einen Namen für die Anwendung ein.
-
Fügen Sie mindestens eine Datenquelle hinzu, entweder OpenSearch Domäne oder eine serverlose Sammlung.
Fahren Sie im gleichen Formular fort, um Single Sign-On zu aktivieren und die Erstellung der Anwendung abzuschließen.
Um zu aktivieren AWS IAM Identity Center und erstellen Sie die Anwendung
-
Wählen Sie das Authentifizierung mit IAM Identity Center Kontrollkästchen.
-
Wählen Sie die IAM-Rolle aus, die Sie in erstellt haben Schritt 2: Erstellen der IAM-Rolle.
-
(Optional) Konfigurieren Sie Dashboard-Administratoren.
-
Wählen Sie Erstellen aus.
Um dieselbe Anwendung zu erstellen mit dem AWS CLI, führen Sie den folgenden Befehl aus. Ersetzen Sie die Platzhalterwerte durch Ihre Informationen.
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}}
Schritt 4: Benutzer zuweisen in AWS IAM Identity Center
Um der Anwendung Benutzer oder Gruppen zuzuweisen
-
Öffnen Sie die AWS IAM-Identity-Center-Konsole
. -
Wählen Sie im Navigationsmenü Anwendungen.
-
Wählen Sie die Anwendung, die OpenSearch Ich habe mich automatisch registriert. Sein Name entspricht deinem OpenSearch Name der UI-Anwendung.
-
Wählen Sie Benutzer und Gruppen zuweisen aus.
-
Wählen Sie die Benutzer oder Gruppen aus, die Zugriff benötigen, und wählen Sie dann Zuweisen.
Schritt 5: Überprüfen Sie das Setup
Um das Setup zu überprüfen
-
Im Amazonas OpenSearch Vergewissern Sie sich an der Servicekonsole, dass der Anwendungsstatus lautet Aktiv, was darauf hinweist, dass die Anwendung einsatzbereit ist.
-
Bestätigen Sie das Authentifizierung mit IAM Identity Center ist auf der Seite mit den Anwendungsdetails aktiviert.
-
Kopieren Sie die Anwendungs-URL von der Seite mit den Anwendungsdetails.
-
Öffnen Sie die Anwendungs-URL in einem Browser. Sie werden weitergeleitet zum AWS IAM Identity Center Anmeldeseite.
-
Melde dich an mit deinem AWS IAM Identity Center Anmeldeinformationen. Die OpenSearch Die Auswahl des Benutzeroberflächenbereichs wird angezeigt.
Programmgesteuertes Verwalten von Benutzern und Gruppen
Wenn Sie eine erstellen OpenSearch UI-Anwendung mit AWS IAM Identity Center aktiviert, OpenSearch UI registriert eine AWS IAM Identity Center Anwendung. Sie müssen dieser Anwendung Benutzer zuweisen, bevor sie sich anmelden können. Es gibt zwei separate Zugriffsebenen:
- Zuweisung der Anwendung
-
Steuert, bei wem sich anmelden kann OpenSearch UI. Du schaffst es mit dem
sso-adminBefehle. - Administrator der Anwendung
-
Steuert, wer die Anwendung bearbeiten oder löschen und ihre Arbeitsbereiche verwalten kann. Sie verwalten es mit
aws opensearch update-application. Weitere Informationen zu Anwendungsadministratoren finden Sie unter Verwaltung von Anwendungsadministratoren.
Sie benötigen drei Identifikatoren, bevor Sie Aufgaben verwalten können.
| Kennung | Wie bekomme ich es |
|---|---|
| Das AWS IAM Identity Center Anwendung ARN | aws opensearch get-application, in iamIdentityCenterOptions.iamIdentityCenterApplicationArn |
| Die ID des Identitätsspeichers | aws sso-admin list-instances, in Instances[0].IdentityStoreId |
| Die Benutzer- oder Gruppen-ID | aws identitystore list-users oder aws identitystore
list-groups |
Mit den folgenden Befehlen werden Benutzer anhand ihres Benutzernamens und Gruppen anhand ihres Anzeigenamens gesucht. Ersetzen Sie den placeholder values mit deinen eigenen Informationen:
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
Mit den folgenden Befehlen weisen Sie der Anwendung einen Benutzer oder eine Gruppe zu und überprüfen oder entfernen Zuweisungen. Stellen Sie für eine Gruppe Folgendes ein --principal-type zu GROUP und verwende die Gruppen-ID, die du zuvor gefunden hast, als Prinzipal-ID:
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}}
Wenn ein Benutzer oder eine Gruppe noch nicht in Ihrem Identitätsspeicher existiert, erstellen Sie sie mit aws identitystore create-user oder aws identitystore
create-group, und füge Mitglieder hinzu mit aws identitystore
create-group-membership.
Das folgende Python-Codebeispiel sucht einen Benutzer anhand des Benutzernamens und weist diesen Benutzer der Anwendung mit dem AWS SDK für 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", )
Fehlerbehebung AWS IAM Identity Center Authentifizierung
AWS IAM Identity Center Authentifizierungsprobleme sind in der Regel auf eine Vertrauensrichtlinie zurückzuführen, die Folgendes auslässt sso.amazonaws.com, eine Berechtigungsrichtlinie, der die erforderlichen Aktionen fehlen, oder ein Benutzer, der der Anwendung nicht zugewiesen ist. In der folgenden Tabelle sind häufig auftretende Symptome, ihre wahrscheinlichen Ursachen und Lösungsansätze aufgeführt.
| Symptom | Wahrscheinliche Ursache | Auflösung |
|---|---|---|
| Eine Nachricht, die AWS IAM Identity Center ist nicht aktiviert wird angezeigt, während Sie die Anwendung erstellen | In Ihrem Konto oder Ihrer Organisation gibt es keine Instanz | Aktiviere AWS IAM Identity Center in der AWS IAM Identity Center Konsole |
| Single Sign-On leitet weiter, gibt aber einen Fehler zurück | Die Richtlinie zur Vertrauensstellung für Rollen umfasst Folgendes nicht sso.amazonaws.com |
Aktualisieren Sie die Vertrauensrichtlinie wie unter beschrieben Schritt 2: Erstellen der IAM-Rolle |
| Sign-in ist erfolgreich, aber der Benutzer hat keinen Zugriff | Der Benutzer ist der Anwendung nicht zugewiesen | Ordnen Sie den Benutzer in der AWS IAM Identity Center Konsole, wie beschrieben unter Schritt 4: Benutzer zuweisen in AWS IAM Identity Center |
| Der Zugriff wird nach der Anmeldung verweigert | In der Richtlinie für Rollenberechtigungen fehlen erforderliche Aktionen | Bestätigen Sie, dass die Rolle opensearch:ApplicationAccessAll und die Erlaubnis, auf die Datenquellen zuzugreifen |
| Die Anwendung zeigt AWS IAM Identity Center wurde aktiviert, aber die Anmeldung schlägt fehl | Der Rollen-ARN stimmt nicht überein | Vergewissern Sie sich, dass der Rollen-ARN in den Anwendungseinstellungen die Rolle ist, für die die richtigen Vertrauens- und Berechtigungsrichtlinien gelten |
| Die Anwendung kann nicht mit erstellt werden AWS IAM Identity Center | AWS IAM Identity Center Berechtigungen fehlen | Bestätigen Sie, dass Ihr IAM-Principal sso:CreateApplication, sso:PutApplicationGrant, und iam:PassRole |
| Die Anmeldeseite wird angezeigt, aber kein Benutzer kann sich anmelden | Es wurden keine Benutzer zugewiesen AWS IAM Identity Center | Ordnen Sie der Anwendung Benutzer in der AWS IAM Identity Center Konsole |
Sign-in schlägt mit einer Meldung fehl, dass der Autorisierungscode nicht validiert werden kann, oder mit AccessDeniedException |
AWS IAM Identity Center verwendet einen vom Kunden verwalteten Schlüssel ohne die erforderliche Schlüsselrichtlinie | Fügen Sie die oben in diesem Thema beschriebenen wichtigen Richtlinienerklärungen hinzu |
| Ein Benutzer kann sich kurz nach der Zuweisung nicht anmelden | Die Zuweisung wurde noch nicht weitergegeben | Warten Sie ein bis zwei Minuten, und versuchen Sie es dann erneut |
AccessDeniedException auf create-application-assignment |
Das sso:CreateApplicationAssignment Die Erlaubnis fehlt |
Fügen Sie das hinzu AWS IAM Identity Center Berechtigungen, die unter aufgeführt sind IAM-Richtlinienreferenz für OpenSearch UI |
ConflictException bei einer Aufgabe |
Der Benutzer oder die Gruppe ist bereits zugewiesen | Bestätigen Sie mit list-application-assignments |