View a markdown version of this page

Einrichtung der Verbreitung vertrauenswürdiger Identitäten mit SageMaker Studio - AWS IAM Identity Center

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.

Einrichtung der Verbreitung vertrauenswürdiger Identitäten mit SageMaker Studio

Das folgende Verfahren führt Sie Schritt für Schritt durch die Einrichtung von SageMaker Studio für vertrauenswürdige Identitäten und Hintergrundsitzungen für Benutzer.

Voraussetzungen

Bevor Sie mit diesem Tutorial beginnen können, müssen Sie die folgenden Aufgaben erledigen:

  1. Aktivieren Sie IAM Identity Center. Eine Organisationsinstanz ist erforderlich. Weitere Informationen finden Sie unter Voraussetzungen und Überlegungen.

  2. Stellen Sie die Benutzer und Gruppen aus Ihrer Identitätsquelle im IAM Identity Center bereit.

  3. Vergewissern Sie sich, dass Benutzersitzungen im Hintergrund in der IAM Identity Center-Konsole aktiviert sind. Standardmäßig sind Benutzer-Hintergrundsitzungen aktiviert und die Sitzungsdauer ist auf 7 Tage festgelegt. Sie können diese Dauer ändern.

Um die Weitergabe vertrauenswürdiger Identitäten von SageMaker Studio aus einzurichten, muss der SageMaker Studio-Administrator die folgenden Schritte ausführen.

Schritt 1: Aktivieren Sie die Weitergabe vertrauenswürdiger Identitäten in einer neuen oder vorhandenen SageMaker Studio-Domäne

SageMaker Studio verwendet Domänen, um Benutzerprofile, Anwendungen und die zugehörigen Ressourcen zu organisieren. Um die Weitergabe vertrauenswürdiger Identitäten zu aktivieren, müssen Sie eine SageMaker Studio-Domäne erstellen oder eine vorhandene Domäne ändern, wie im folgenden Verfahren beschrieben.

  1. Öffnen Sie die SageMaker AI-Konsole, navigieren Sie zu Domains und führen Sie eine der folgenden Aktionen aus.

    • Erstellen Sie mithilfe von Setup für Organisationen eine neue SageMaker Studio-Domain.

      Wählen Sie Für Organisationen einrichten aus, und gehen Sie dann wie folgt vor:

      • Wählen Sie AWS Identity Center als Authentifizierungsmethode.

      • Aktivieren Sie das Kontrollkästchen Weitergabe vertrauenswürdiger Identitäten für alle Benutzer dieser Domäne aktivieren.

    • Ändern Sie eine bestehende SageMaker Studio-Domäne.

      • Wählen Sie eine vorhandene Domain aus, die IAM Identity Center für die Authentifizierung verwendet.

        Wichtig

        Die Weitergabe vertrauenswürdiger Identitäten wird nur in SageMaker Studio-Domänen unterstützt, die IAM Identity Center für die Authentifizierung verwenden. Wenn die Domain IAM für die Authentifizierung verwendet, können Sie die Authentifizierungsmethode nicht ändern und daher die Weitergabe vertrauenswürdiger Identitäten nicht aktivieren.

      • Bearbeiten Sie die Domain-Einstellungen. Bearbeiten Sie die Authentifizierungs- und Berechtigungseinstellungen, um die Verbreitung vertrauenswürdiger Identitäten zu aktivieren.

  2. Fahren Sie mit Schritt 2 fort: Konfigurieren Sie die Standard-Domain-Ausführungsrolle. Diese Rolle ist erforderlich, damit Benutzer einer SageMaker Studio-Domain auf andere AWS Dienste wie Amazon S3 zugreifen können.

Schritt 2: Konfigurieren Sie die standardmäßige Domänenausführungsrolle und die Rollenvertrauensrichtlinie

Eine Domänenausführungsrolle ist eine IAM-Rolle, die eine SageMaker Studio-Domäne im Namen aller Benutzer in der Domäne übernimmt. Die Berechtigungen, die Sie dieser Rolle zuweisen, bestimmen, welche Aktionen SageMaker Studio ausführen kann.

  1. Gehen Sie wie folgt vor, um eine Domänenausführungsrolle zu erstellen oder auszuwählen:

    • Erstellen Sie mithilfe von Setup für Organisationen eine Rolle oder wählen Sie sie aus.

      • Öffnen Sie die SageMaker AI-Konsole und folgen Sie den Anweisungen der Konsole in Schritt 2: Rollen und ML-Aktivitäten konfigurieren, um eine neue Domänenausführungsrolle zu erstellen, oder wählen Sie eine vorhandene Rolle aus.

      • Führen Sie die restlichen Einrichtungsschritte durch, um Ihre SageMaker Studio-Domain zu erstellen.

    • Erstellen Sie manuell eine Ausführungsrolle.

  2. Aktualisieren Sie die Vertrauensrichtlinie, die der Domänenausführungsrolle zugeordnet ist, sodass sie die folgenden beiden Aktionen umfasst: sts:AssumeRole und sts:SetContext. Informationen dazu, wie Sie die Ausführungsrolle für Ihre SageMaker Studio-Domain finden, finden Sie unter Domain-Ausführungsrolle abrufen.

    Eine Vertrauensrichtlinie gibt die Identität an, die eine Rolle übernehmen kann. Diese Richtlinie ist erforderlich, damit der SageMaker Studio-Dienst die Rolle der Domänenausführung übernehmen kann. Fügen Sie diese beiden Aktionen hinzu, sodass sie in Ihrer Richtlinie wie folgt angezeigt werden.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "sagemaker.amazonaws.com" ] }, "Action": [ "sts:AssumeRole", "sts:SetContext" ] } ] }

Schritt 3: Überprüfen Sie die erforderlichen Amazon S3 Access Grant-Berechtigungen für die Domain-Ausführungsrolle

Um Amazon S3 Access Grants verwenden zu können, muss Ihrer SageMaker Studio-Domain-Ausführungsrolle eine Berechtigungsrichtlinie (entweder als Inline-Richtlinie oder als vom Kunden verwaltete Richtlinie) beigefügt sein, die die folgenden Berechtigungen enthält.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:GetDataAccess", "s3:GetAccessGrantsInstanceForPrefix" ], "Resource": "arn:aws:s3:us-east-2:111122223333:access-grants/default" } ] }

Wenn Sie keine Richtlinie haben, die diese Berechtigungen enthält, folgen Sie den Anweisungen unter Hinzufügen und Entfernen von IAM-Identitätsberechtigungen im AWS Identity and Access Management Benutzerhandbuch.

Schritt 4: Weisen Sie der Domain Gruppen und Benutzer zu

Weisen Sie der SageMaker Studio-Domäne Gruppen und Benutzer zu, indem Sie den Schritten unter Gruppen und Benutzer hinzufügen folgen.

Schritt 5: Richten Sie Amazon S3 Access Grants ein

Um Amazon S3 Access Grants einzurichten, folgen Sie den Schritten unter Konfiguration von Amazon S3 Access Grants für die Verbreitung vertrauenswürdiger Identitäten über IAM Identity Center. Folgen Sie den schrittweisen Anweisungen, um die folgenden Aufgaben auszuführen:

  1. Erstellen Sie eine Amazon S3 Access Grants-Instance.

  2. Registrieren Sie einen Standort in dieser Instance.

  3. Erstellen Sie Zuschüsse, um bestimmten IAM Identity Center-Benutzern oder -Gruppen den Zugriff auf bestimmte Amazon S3-Standorte oder Untergruppen (z. B. bestimmte Präfixe) innerhalb dieser Standorte zu ermöglichen.

Schritt 6: Reichen Sie einen SageMaker Schulungsauftrag ein und sehen Sie sich die Hintergrundinformationen der Benutzer an

Starten Sie in SageMaker Studio ein neues Jupyter-Notizbuch und reichen Sie einen Trainingsjob ein. Führen Sie während der Ausführung des Jobs die folgenden Schritte aus, um die Sitzungsinformationen anzuzeigen und zu überprüfen, ob der Hintergrundsitzungskontext des Benutzers aktiv ist.

  1. Öffnen Sie die IAM-Identity-Center-Konsole.

  2. Wählen Sie Users (Benutzer) aus.

  3. Wählen Sie auf der Seite Benutzer den Benutzernamen des Benutzers aus, dessen Sitzungen Sie verwalten möchten. Dadurch gelangen Sie zu einer Seite mit den Benutzerinformationen.

  4. Wählen Sie auf der Benutzerseite den Tab Aktive Sitzungen. Die Zahl in Klammern neben Aktive Sitzungen gibt die Anzahl der aktiven Sitzungen für diesen Benutzer an.

  5. Um anhand des Amazon-Ressourcennamens (ARN) des Jobs, der die Sitzung verwendet, nach Sitzungen zu suchen, wählen Sie in der Liste Sitzungstyp die Option Benutzerhintergrundsitzungen aus, und geben Sie dann die Job-ARN in das Suchfeld ein.

Im Folgenden finden Sie ein Beispiel dafür, wie ein Trainingsjob, der eine Benutzersitzung im Hintergrund verwendet, auf der Registerkarte Aktive Sitzungen für einen Benutzer angezeigt wird.

Registerkarte „Aktive Sitzungen“, auf der ein Trainingsjob mit dem Sitzungstyp „Benutzer im Hintergrund“ angezeigt wird.

Schritt 7: Sehen Sie sich die CloudTrail Protokolle an, um die Verbreitung vertrauenswürdiger Identitäten in zu überprüfen CloudTrail

Wenn die Weitergabe vertrauenswürdiger Identitäten aktiviert ist, werden Aktionen in den CloudTrail Ereignisprotokollen unter dem onBehalfOf Element angezeigt. Das userId gibt die ID des IAM Identity Center-Benutzers wieder, der den Schulungsjob initiiert hat. Das folgende CloudTrail Ereignis erfasst den Prozess der Weitergabe vertrauenswürdiger Identitäten.

"userIdentity": { "type": "AssumedRole", "principalId": "AROA123456789EXAMPLE:SageMaker", "arn": "arn:aws:sts::111122223333:assumed-role/SageMaker-ExecutionRole-20250728T125817/SageMaker", "accountId": "111122223333", "accessKeyId": "ASIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AROA123456789EXAMPLE", "arn": "arn:aws:iam::111122223333:role/service-role/SageMaker-ExecutionRole-20250728T125817", "accountId": "111122223333", "userName": "SageMaker-ExecutionRole-20250728T125817" }, "attributes": { "creationDate": "2025-07-29T17:17:10Z", "mfaAuthenticated": "false" } }, "onBehalfOf": { "userId": "2801d3e0-f0e1-707f-54e8-f558b19f0a10", "identityStoreArn": "arn:aws:identitystore::777788889999:identitystore/d-1234567890" } },

Überlegungen zur Laufzeit

Wenn ein Administrator langwierige Schulungs- oder Verarbeitungsaufträge festlegt MaxRuntimeInSeconds, die kürzer als die Dauer der Benutzersitzung im Hintergrund sind, führt SageMaker Studio den Auftrag mindestens für die Dauer der Hintergrundsitzung des Benutzers aus. MaxRuntimeInSeconds

Weitere Informationen MaxRuntimeInSeconds dazu finden Sie in der Anleitung für den CreateTrainingJob StoppingCondition Parameter in der SageMaker Amazon-API-Referenz.