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.
Authentifizierung mithilfe der IAM-Identität
Amazon DocumentDB-Benutzer und -Anwendungen können IAM-Benutzer und -Rollen verwenden, um sich bei einem Amazon DocumentDB-Cluster zu authentifizieren. Die Amazon DocumentDB-IAM-Authentifizierung ist eine kennwortlose Authentifizierungsmethode. Außerdem senden Client-Anwendungen die Passwortgeheimnisse nicht an den Amazon DocumentDB-Cluster, wenn sie IAM verwenden roles/users. Stattdessen werden Client-Verbindungen authentifiziert durch AWS STS mit temporären Sicherheitstoken. Non-administrative Benutzer und Anwendungen können jetzt denselben IAM-Identitäts-ARN verwenden, wenn sie eine Verbindung zu verschiedenen Amazon DocumentDB-Clustern und anderen herstellen AWS Dienste.
Sie können auch wählen, ob Sie sowohl die kennwortbasierte als auch die IAM-Authentifizierung verwenden möchten, um Benutzer und Anwendungen bei einem Amazon DocumentDB-Cluster zu authentifizieren. Die IAM-Authentifizierung ist nur in der instanzbasierten Cluster-Version 5.0 von Amazon DocumentDB verfügbar. Die IAM-Authentifizierung mithilfe von IAM-Identitäts-ARNs wird für den primären Amazon DocumentDB-Benutzer nicht unterstützt.
Anmerkung
Der Hauptbenutzer kann nur mithilfe der vorhandenen kennwortbasierten Authentifizierung authentifiziert werden.
Topics
Erste Schritte mit der Authentifizierung mithilfe von IAM-Benutzern und -Rollen
Amazon DocumentDB-Benutzer und -Rollen mit IAM-Identitäten werden in einem erstellt und verwaltet $external Datenbank.
Einen Benutzer erstellen
Stellen Sie als Hauptbenutzer eine Verbindung her und erstellen Sie dann einen IAM-Benutzer und eine IAM-Rolle:
use $external; db.createUser( { user: "arn:aws:iam::123456789123:user/iamuser", mechanisms: ["MONGODB-AWS"], roles: [ { role: "readWrite", db: "readWriteDB" } ] } );
Fügen Sie alternativ einen Amazon DocumentDB-Benutzer mithilfe einer IAM-Rolle hinzu:
use $external; db.createUser( { user: "arn:aws:iam::123456789123:role/iamrole", mechanisms: ["MONGODB-AWS"], roles: [ { role: "readWrite", db: "readWriteDB" } ] } );
Einen IAM-Benutzer oder eine IAM-Rolle ändern
Ändern Sie einen vorhandenen IAM-Benutzer:
use $external; db.updateUser( "arn:aws:iam::123456789123:user/iamuser", { roles: [ { role: "read", db: "readDB" } ] } );
Ändern Sie eine bestehende IAM-Rolle:
use $external; db.updateUser( "arn:aws:iam::123456789123:role/iamrole", { roles: [ { role: "read", db: "readDB" } ] } );
So gewähren oder entziehen Sie einem IAM-Benutzer Rollen:
use $external; db.grantRolesToUser( "arn:aws:iam::123456789123:user/iamuser", [ { db: "admin", role: "readWriteAnyDatabase" } ] );
use $external; db.revokeRolesFromUser( "arn:aws:iam::123456789123:user/iamuser", [ { db: "admin", role: "readWriteAnyDatabase" } ] );
So gewähren oder entziehen Sie Rollen einer IAM-Rolle:
use $external; db.grantRolesToUser( "arn:aws:iam::123456789123:user/iamrole", [ { db: "admin", role: "readWriteAnyDatabase" } ] );
use $external; db.revokeRolesFromUser( "arn:aws:iam::123456789123:user/iamrole", [ { db: "admin", role: "readWriteAnyDatabase" } ] );
Einen IAM-Benutzer oder eine IAM-Rolle löschen
So löschen Sie einen vorhandenen IAM-Benutzer:
use $external; db.dropUser("arn:aws:iam::123456789123:user/iamuser");
So löschen Sie eine bestehende IAM-Rolle:
use $external; db.dropUser("arn:aws:iam::123456789123:role/iamrole");
Konfigurieren Sie einen Verbindungs-URI für die Authentifizierung mit AWS IAM
Um sich zu authentifizieren mit AWS IAM, verwenden Sie die folgenden URI-Parameter: authSource als $external und authMechanism als MONGODB-AWS. Wenn Sie einen IAM-Benutzer verwenden, werden die Felder Benutzername und Passwort durch einen Zugriffsschlüssel bzw. einen Geheimschlüssel ersetzt. Wenn Sie eine IAM-Rolle übernehmen, die der Umgebung zugeordnet ist, in der Sie sich befinden (z. B. AWS Lambda Funktion, Amazon EC2-Instanz). Sie müssen keine speziellen Anmeldeinformationen angeben, wenn Sie sich mit dem authentifizieren MONGODB-AWS Mechanismus. Wenn Sie MongoDB-Treiber verwenden, die das unterstützen MONGODB-AWS Authentifizierungsmechanismus: Die Treiber sind auch in der Lage, IAM-Rollenanmeldedaten von der Recheninstanz abzurufen (z. B. Amazon EC2, Lambda-Funktion und andere). Das folgende Beispiel verwendet eine Mongo-Shell zur Authentifizierung mit MONGODB-AWS durch manuelles Übergeben eines Zugriffsschlüssels und eines geheimen Schlüssels (eines IAM-Benutzers), um die Authentifizierung gegenüber Amazon DocumentDB nachzuweisen.
Das folgende Beispiel verwendet Python-Code zur Authentifizierung mit MONGODB-AWS ohne explizit Anmeldeinformationen zu übergeben (unter Verwendung einer an die Umgebung angehängten IAM-Rolle), um die Authentifizierung gegen Amazon DocumentDB nachzuweisen.
##Create a MongoDB client, open a connection to Amazon DocumentDB using an IAM role client = pymongo.MongoClient(‘mongodb://<DocDBEndpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false&authSource=%24external&authMechanism=MONGODB-AWS')
Das folgende Beispiel verwendet eine Mongo-Shell zur Authentifizierung mit MONGODB-AWS Mechanismus, bei dem ein Zugriffsschlüssel und ein geheimer Schlüssel (eines IAM-Benutzers) manuell übergeben werden, um die Authentifizierung gegenüber Amazon DocumentDB nachzuweisen.
$ mongo 'mongodb://<access_key>:<secret_key>@<cluster_endpoint>:<db_port>/test?authSource=%24external&authMechanism=MONGODB-AWS'
Das folgende Beispiel verwendet eine Mongo-Shell zur Authentifizierung mit MONGODB-AWS ohne explizit Anmeldeinformationen zu übergeben (unter Verwendung der an die Umgebung angehängten IAM-Rolle), um die Authentifizierung gegen Amazon DocumentDB nachzuweisen.
$ mongo 'mongodb://<cluster_endpoint>:<db_port>/test?authSource=%24external&authMechanism=MONGODB-AWS'
Konfigurieren AWS berechne Typen für die Authentifizierung bei Amazon DocumentDB AWS IAM
Verwenden von Amazon EC2/AWS Lambda/AWS Fargate
Amazon EC2 verwendet die folgenden Umgebungsvariablen. Wenn der EC2-Instance eine IAM-Rolle oder eine Ausführungs-IAM-Rolle zugeordnet ist, die einer Lambda-Funktion oder einer Amazon ECS-Aufgabe zugeordnet ist, werden diese Variablen automatisch aufgefüllt und der Treiber kann diese Werte aus der Umgebung abrufen:
AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN
Weitere Informationen zu Umgebungsvariablen finden Sie unter Verwenden von Lambda-Umgebungsvariablen in der AWS Lambda Leitfaden für Entwickler.
Verwenden von Amazon EKS
Wenn Sie Ihren Amazon Elastic Kubernetes Service (Amazon EKS) -Pods eine Rolle zuweisen, werden automatisch die folgenden beiden Umgebungsvariablen eingerichtet:
AWS_WEB_IDENTITY_TOKEN_FILE - path of web identity token file AWS_ROLE_ARN - Name of IAM role to connect with
Übernehmen Sie mithilfe dieser Variablen manuell die Rolle aus Ihrem Code. Verwenden Sie dazu AWS SDK-Aufruf für AssumeRoleWithWebIdentity:
Lassen Sie das weg
ProviderIDParameter.Ermitteln Sie den Wert von
WebIdentityTokenParameter in der Datei, beschrieben in derAWS_WEB_IDENTITY_TOKEN_FILEUmgebungsvariable.
Weitere Informationen zu Amazon EKS finden Sie unter Was ist Amazon EKS in der Amazon EKS-Benutzerhandbuch.
Überwachung von IAM-Authentifizierungsanfragen
Verwenden der Amazon DocumentDB-Überwachung
Gehen Sie zum Audit-Log-Ordner in Amazon CloudWatch, und verwenden Sie verschiedene Suchmuster, um die Protokolle für die IAM-Authentifizierung abzurufen. Verwenden Sie zum Beispiel { $.param.mechanism = "MONGODB-AWS" } als Suchmuster für „Alle Log-Streams durchsuchen“.
Weitere Informationen zu unterstützten Ereignissen im Auditing finden Sie unter Prüfung von Amazon DocumentDB-Ereignissen.
Amazon verwenden CloudWatch Metriken
StsGetCallerIdentityCalls: Diese Metrik zeigt, wie viele GetCallerIdentity Aufrufe, die eine Amazon DocumentDB-Instance an die regionalisierte AWS -Security-Token-Service (AWS STS) Endpunkt. Beziehen Sie sich auf die MONGODB-AWS Authentifizierungsspezifikation darüber, warum Datenbankinstanzen STS erstellen müssen GetCallerIdentity Anrufe.
Verwenden der IAM-Authentifizierung
Wenn Sie den Benutzernamen und das Passwort nicht in Ihrer eigenen Datenbank verwalten möchten, können Sie die IAM-Authentifizierung verwenden. Die IAM-Authentifizierung ist nur in der instanzbasierten Cluster-Version 5.0 von Amazon DocumentDB verfügbar.
Die IAM-Authentifizierung ist abhängig von AWS -Security-Token-Service (AWS STS). Wenn du eine bekommst AWS STS Drosselungsausnahme bei Verwendung der IAM-Authentifizierung, senken Sie Ihre Verbindungsrate.
Informationen zu IAM-Kontingenten finden Sie unter IAM und AWS STS Quoten in der IAM-Benutzerhandbuch.
Treiber, die IAM unterstützen
Treiber, die Amazon DocumentDB 5.0 und die unterstützen MONGODB-AWS Der Authentifizierungsmechanismus sollte mit der IAM-Authentifizierungsimplementierung in Amazon DocumentDB funktionieren.
Wichtig
Es gibt eine bekannte Einschränkung bei Node.js Treiber, die älter als Version 6.13.1 sind und derzeit von der IAM-Identitätsauthentifizierung für Amazon DocumentDB nicht unterstützt werden. Node.js Treiber und Tools, die Folgendes verwenden Node.js Der Treiber (z. B. Mongosh) muss aktualisiert werden, um ihn verwenden zu können Node.js Treiberversion 6.13.1 oder höher.
Häufig gestellte Fragen zur IAM-Identitätsauthentifizierung
Gibt es Beispiele, auf die ich mich beziehen kann?
Auf diesen Seiten finden Sie Beispiele für Anwendungsfälle und Konfigurationen:
Ich erhalte eine Fehlermeldung bei der Verwendung meines Python-Treibers: „pymongo.errors.ConfigurationError: MONGODB-AWS Die Authentifizierung erfordert „pymongo-auth-aws“. Wie kann ich das lösen?
Stellen Sie sicher, dass Sie bei der Installation des Python-Treibers mit IAM-Authentifizierung die folgende Anweisung verwenden:
pip install 'pymongo[aws]'
Dadurch wird das zusätzliche installiert AWS Abhängigkeiten, die erforderlich sind, damit die IAM-Authentifizierung funktioniert.
Wird meine Verbindung unterbrochen, wenn die temporären Anmeldeinformationen für meine IAM-Rolle ablaufen?
Nein, die temporären IAM-Anmeldeinformationen werden nur für den Verbindungsaufbau und die Authentifizierung verwendet. Dann erfolgt die gesamte weitere Autorisierung im Amazon DocumentDB-Cluster. Auch wenn IAM-Anmeldeinformationen rotate/expire, die Verbindung wird nicht unterbrochen oder veraltet.