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.
Verwenden AWS Lambda um Ihren Identitätsanbieter zu integrieren
In diesem Thema wird beschrieben, wie Sie eine AWS Lambda Funktion erstellen, die eine Verbindung zu Ihrem benutzerdefinierten Identitätsanbieter herstellt. Sie können jeden benutzerdefinierten Identitätsanbieter wie Okta, Secrets Manager oder einen benutzerdefinierten Datenspeicher verwenden OneLogin, der Autorisierungs- und Authentifizierungslogik enthält.
Für die meisten Anwendungsfälle empfiehlt es sich, einen benutzerdefinierten Identitätsanbieter zu konfigurieren, die Lösung für benutzerdefinierte Identitätsanbieter zu verwenden.
Anmerkung
Bevor Sie einen Transfer Family-Server erstellen, der Lambda als Identitätsanbieter verwendet, müssen Sie die Funktion erstellen. Eine Beispielfunktion für Lambda finden Sie unter Beispiel für Lambda-Funktionen. Oder Sie können einen CloudFormation Stack bereitstellen, der einen der Vorlagen für Lambda-Funktionen verwendet. Stellen Sie außerdem sicher, dass Ihre Lambda-Funktion eine ressourcenbasierte Richtlinie verwendet, die Transfer Family vertraut. Eine Beispielrichtlinie finden Sie unter Ressourcenbasierte Lambda-Richtlinie.
-
Öffnen Sie die AWS Transfer Family -Konsole
. -
Wählen Sie Server erstellen, um die Seite Server erstellen zu öffnen. Wählen Sie unter Wählen Sie einen Identitätsanbieter die Option Benutzerdefinierter Identitätsanbieter aus, wie im folgenden Screenshot gezeigt.
Anmerkung
Die Auswahl der Authentifizierungsmethoden ist nur verfügbar, wenn Sie SFTP als eines der Protokolle für Ihren Transfer Family-Server aktivieren.
-
Stellen Sie sicher, dass der Standardwert „Für AWS Lambda die Verbindung mit Ihrem Identitätsanbieter verwenden“ ausgewählt ist.
-
Wählen Sie für AWS Lambda Funktion den Namen Ihrer Lambda-Funktion aus.
-
Füllen Sie die verbleibenden Felder aus und wählen Sie dann Create server. Einzelheiten zu den verbleibenden Schritten zum Erstellen eines Servers finden Sie unterKonfiguration eines SFTP-, FTPS- oder FTP-Serverendpunkts.
Ressourcenbasierte Lambda-Richtlinie
Sie müssen über eine Richtlinie verfügen, die auf den Transfer Family-Server und die Lambda-ARNs verweist. Sie könnten beispielsweise die folgende Richtlinie mit Ihrer Lambda-Funktion verwenden, die eine Verbindung zu Ihrem Identitätsanbieter herstellt. Der Richtlinie wird JSON als Zeichenfolge maskiert.
-
"Policy": "{\"Version\":\"2012-10-17\", \"Id\":\"default\", \"Statement\":[ {\"Sid\":\"AllowTransferInvocation\", \"Effect\":\"Allow\", \"Principal\":{\"Service\":\"transfer.amazonaws.com\"}, \"Action\":\"lambda:InvokeFunction\", \"Resource\":\"arn:aws:lambda:region:123456789012:function:my-lambda-auth-function\", \"Condition\":{\"ArnLike\":{\"AWS:SourceArn\":\"arn:aws:transfer:region:123456789012:server/server-id\"}}} ]}"
Anmerkung
Ersetzen Sie in der obigen Beispielrichtlinie jede Richtlinie user input
placeholder durch Ihre eigenen Informationen.
Struktur von Ereignismeldungen
Die Struktur der Ereignisnachricht, die vom SFTP-Server an die Lambda-Funktion des Authorizers für einen benutzerdefinierten IDP gesendet wird, lautet wie folgt.
{ "username": "value", "password": "value", "protocol": "SFTP", "serverId": "s-abcd123456", "sourceIp": "192.168.0.100" }
Wo username und password sind die Werte für die Anmeldeinformationen, die an den Server gesendet werden.
Beispielsweise geben Sie den folgenden Befehl ein, um eine Verbindung herzustellen:
sftp bobusa@server_hostname
Sie werden dann aufgefordert, Ihr Passwort einzugeben:
Enter password: mysecretpassword
Sie können dies von Ihrer Lambda-Funktion aus überprüfen, indem Sie das übergebene Ereignis in der Lambda-Funktion drucken. Er sollte dem folgenden Textblock ähneln.
{ "username": "bobusa", "password": "mysecretpassword", "protocol": "SFTP", "serverId": "s-abcd123456", "sourceIp": "192.168.0.100" }
Die Eventstruktur ist für FTP und FTPS ähnlich: Der einzige Unterschied besteht darin, dass diese Werte für den protocol Parameter und nicht für SFTP verwendet werden.
Lambda-Funktionen für die Authentifizierung
Um verschiedene Authentifizierungsstrategien zu implementieren, bearbeiten Sie die Lambda-Funktion. Um Ihnen zu helfen, die Anforderungen Ihrer Anwendung zu erfüllen, können Sie einen CloudFormation Stack bereitstellen. Weitere Informationen zu Lambda finden Sie im AWS Lambda Entwicklerhandbuch oder im Abschnitt Erstellen von Lambda-Funktionen mit. Node.js
Themen
Gültige Lambda-Werte
In der folgenden Tabelle werden Details zu den Werten beschrieben, die Transfer Family für Lambda-Funktionen akzeptiert, die für benutzerdefinierte Identitätsanbieter verwendet werden.
| Wert | Description | Erforderlich |
|---|---|---|
|
|
Gibt den Amazon-Ressourcennamen (ARN) der IAM-Rolle an, die den Zugriff Ihrer Benutzer auf Ihr Amazon S3-Bucket- oder Amazon EFS-Dateisystem steuert. Die dieser Rolle beigefügten Richtlinien bestimmen die Zugriffsebene, die Sie Ihren Benutzern bei der Übertragung von Dateien in Ihr Amazon S3- oder Amazon EFS-Dateisystem gewähren möchten. Die IAM-Rolle sollte außerdem eine Vertrauensstellung enthalten, mit der der Server Zugriff auf Ihre Ressourcen erhält, wenn er die Übertragungsanfragen Ihres Benutzers bearbeitet. Einzelheiten zum Aufbau einer Vertrauensbeziehung finden Sie unterSo stellen Sie eine Vertrauensbeziehung her. |
Erforderlich |
|
|
Die vollständige POSIX-Identität, einschließlich Benutzer-ID ( |
Erforderlich für Amazon EFS-Backing-Speicher |
|
|
Eine Liste der Werte für öffentliche SSH-Schlüssel, die für diesen Benutzer gültig sind. Eine leere Liste bedeutet, dass dies kein gültiges Login ist. Darf bei der Passwortauthentifizierung nicht zurückgegeben werden. |
Optional |
|
|
Eine Sitzungsrichtlinie für Ihren Benutzer, sodass Sie dieselbe IAM-Rolle für mehrere Benutzer verwenden können. Diese Richtlinie grenzt den Benutzerzugriff auf Teile ihres Amazon S3-Buckets ein. Weitere Informationen zur Verwendung von Sitzungsrichtlinien mit benutzerdefinierten Identitätsanbietern finden Sie in den Beispielen für Sitzungsrichtlinien in diesem Thema. |
Optional |
|
|
Die Art des Zielverzeichnisses (Ordners), das das Home-Verzeichnis Ihrer Benutzer sein soll, wenn sie sich beim Server anmelden.
|
Optional |
|
|
Logische Verzeichniszuordnungen, die angeben, welche Amazon S3- oder Amazon EFS-Pfade und -Schlüssel für Ihre Benutzer sichtbar sein sollen und wie Sie sie sichtbar machen möchten. Sie müssen das |
Erforderlich, wenn |
|
|
Das Zielverzeichnis für einen Benutzer, der sich mit dem Client am Server anmeldet. Das Format hängt von Ihrem Speicher-Backend ab:
WichtigDer Bucket-Name oder die Amazon EFS-Dateisystem-ID muss im Pfad enthalten sein. Das Auslassen dieser Informationen führt bei Dateiübertragungen zu der Fehlermeldung „Datei nicht gefunden“. |
Optional |
Anmerkung
HomeDirectoryDetailsist eine Zeichenkettendarstellung einer JSON-Map. Dies steht im Gegensatz zuPosixProfile, was ein echtes JSON-Zuordnungsobjekt ist und PublicKeys welches ein JSON-Array von Zeichenketten ist. Die sprachspezifischen Details finden Sie in den Codebeispielen.
HomeDirectory Anforderungen an das Format
Stellen Sie bei der Verwendung des HomeDirectory Parameters sicher, dass Sie das vollständige Pfadformat angeben:
-
Für Amazon S3-Speicher: Geben Sie immer den Bucket-Namen im Format an
/bucket-name/path -
Für Amazon EFS-Speicher: Geben Sie immer die Dateisystem-ID im Format an
/fs-12345/path
Eine häufige Ursache für „Datei nicht gefunden“ -Fehler ist das Weglassen des Bucket-Namens oder der EFS-Dateisystem-ID im HomeDirectory Pfad. Wenn HomeDirectory Sie den Wert auf „Nur“ / ohne Speicher-ID setzen, ist die Authentifizierung zwar erfolgreich, Dateioperationen schlagen jedoch fehl.
Beispiel für Lambda-Funktionen
In diesem Abschnitt werden einige Beispiele für Lambda-Funktionen vorgestellt, sowohl in NodeJS als auch in Python.
Anmerkung
In diesen Beispielen sind die Benutzer-, Rollen-, POSIX-Profil-, Passwort- und Home-Verzeichnisdetails allesamt Beispiele und müssen durch Ihre tatsächlichen Werte ersetzt werden.
Testen Sie Ihre Konfiguration
Nachdem Sie Ihren benutzerdefinierten Identitätsanbieter erstellt haben, sollten Sie Ihre Konfiguration testen.
Wenn die Benutzerauthentifizierung erfolgreich ist, gibt der Test eine StatusCode:
200 HTTP-Antwort, eine leere Zeichenfolge Message: "" (die andernfalls einen Grund für den Fehler enthalten würde) und ein Response Feld zurück.
Anmerkung
Im folgenden Antwortbeispiel ist das Response Feld ein JSON-Objekt, das „stringifiziert“ wurde (in eine flache JSON-Zeichenfolge umgewandelt, die in einem Programm verwendet werden kann) und die Details zu den Rollen und Berechtigungen des Benutzers enthält.
{ "Response":"{\"Policy\":\"{\\\"Version\\\":\\\"2012-10-17\\\",\\\"Statement\\\":[{\\\"Sid\\\":\\\"ReadAndListAllBuckets\\\",\\\"Effect\\\":\\\"Allow\\\",\\\"Action\\\":[\\\"s3:ListAllMybuckets\\\",\\\"s3:GetBucketLocation\\\",\\\"s3:ListBucket\\\",\\\"s3:GetObjectVersion\\\",\\\"s3:GetObjectVersion\\\"],\\\"Resource\\\":\\\"*\\\"}]}\",\"Role\":\"arn:aws:iam::000000000000:role/MyUserS3AccessRole\",\"HomeDirectory\":\"/\"}", "StatusCode": 200, "Message": "" }
Vorlagen für Lambda-Funktionen
Sie können einen CloudFormation Stack bereitstellen, der eine Lambda-Funktion zur Authentifizierung verwendet. Wir stellen mehrere Vorlagen zur Verfügung, mit denen Sie Ihre Benutzer mithilfe von Anmeldeinformationen authentifizieren und autorisieren. Sie können diese Vorlagen oder den AWS Lambda Code ändern, um den Benutzerzugriff weiter anzupassen.
Anmerkung
Sie können einen FIPS-enabled AWS Transfer Family Server erstellen, CloudFormation indem Sie eine FIPS-enabled Sicherheitsrichtlinie in Ihrer Vorlage angeben. Die verfügbaren Sicherheitsrichtlinien werden unter beschrieben Sicherheitsrichtlinien für AWS Transfer Family Server
Um eine zu erstellen CloudFormation Stapel, der für die Authentifizierung verwendet werden soll
-
Öffnen Sie die CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation
. -
Folgen Sie den Anweisungen zum Bereitstellen eines CloudFormation Stacks aus einer vorhandenen Vorlage unter Auswahl einer Stack-Vorlage im AWS CloudFormation Benutzerhandbuch.
-
Verwenden Sie eine der folgenden Vorlagen, um eine Lambda-Funktion zu erstellen, die Sie für die Authentifizierung in Transfer Family verwenden können.
-
Klassische Stack-Vorlage (Amazon Cognito)
Eine grundlegende Vorlage zum Erstellen einer Vorlage AWS Lambda zur Verwendung als benutzerdefinierter Identitätsanbieter in AWS Transfer Family. Es authentifiziert sich bei Amazon Cognito für die kennwortbasierte Authentifizierung. Öffentliche Schlüssel werden aus einem Amazon S3-Bucket zurückgegeben, wenn eine Authentifizierung auf Basis eines öffentlichen Schlüssels verwendet wird. Nach der Bereitstellung können Sie den Lambda-Funktionscode ändern, um etwas anderes zu tun.
-
AWS Secrets Manager Vorlage stapeln
Eine einfache Vorlage, die AWS Lambda zusammen mit einem AWS Transfer Family Server verwendet wird, um Secrets Manager als Identitätsanbieter zu integrieren. Sie authentifiziert sich anhand eines Eintrags in AWS Secrets Manager diesem Format
aws/transfer/. Außerdem muss das Geheimnis die Schlüssel-Wert-Paare für alle Benutzereigenschaften enthalten, die an Transfer Family zurückgegeben werden. Nach der Bereitstellung können Sie den Lambda-Funktionscode ändern, um etwas anderes zu tun.server-id/username -
Okta-Stack-Vorlage
: Eine einfache Vorlage, die AWS Lambda zusammen mit einem AWS Transfer Family Server verwendet wird, um Okta als benutzerdefinierten Identitätsanbieter zu integrieren. -
Okta-mfa Stack-Vorlage
: Eine einfache Vorlage, die AWS Lambda zusammen mit einem AWS Transfer Family Server verwendet wird, um Okta mit Multi-Factor Authentication als benutzerdefinierten Identitätsanbieter zu integrieren. -
Azure Active Directory-Vorlage
: Einzelheiten zu diesem Stack werden im Blogbeitrag Authentifizierung AWS Transfer Family bei Azure Active Directory und beschrieben. AWS Lambda
Nachdem der Stack bereitgestellt wurde, können Sie Details dazu auf der Registerkarte Ausgaben in der CloudFormation Konsole einsehen.
Die Bereitstellung eines dieser Stacks ist der einfachste Weg, einen benutzerdefinierten Identitätsanbieter in den Workflow „Familie übertragen“ zu integrieren.
-