Bei einigen der vorkonfigurierten SAML-Anwendungen müssen Sie einem Nutzer ein benutzerdefiniertes Attribut hinzufügen. Mit dem Schema können Sie das Nutzerprofil mit diesen von Ihnen erstellten Attributen aktualisieren. Die folgenden Beispiele sind auf die Amazon Web Services-Cloud-Anwendung zugeschnitten. Sie enthalten Verweise auf den Rollen-ARN und den Anbieter-ARN, die für Amazon Web Services spezifisch sind.
Benutzerdefiniertes Schema erstellen
- Öffnen Sie die Seite Schemas: insert (Schemas: einfügen).
- Geben Sie für customerId (Kunden-ID) "my_customer" ein.
Fügen Sie im Bereich Anfragetext den folgenden Text ein:
{ "fields": [ { "fieldName": "role", "fieldType": "STRING", "readAccessType": "ADMINS_AND_SELF", "multiValued": true, "displayName": "role" } ], "schemaName": "SSO" "displayName": "Amazon" }Hinweise:
- schemaName kann normalerweise ein beliebiger Textwert sein. Wenn Sie jedoch ein benutzerdefiniertes Schema für die Verwendung mit der Amazon Web Services-Cloud-Anwendung konfigurieren, ist der spezifische Wert „SSO“ erforderlich.
- Wenn Sie mehr als eine Rolle verwenden möchten, wählen Sie für multiValued "true" (wahr) aus.
Klicken Sie auf Ausführen.
Autorisieren Sie den Zugriff auf die Directory API.
Sie sollten die Antwort 200 OK sehen und die Ausgabe der Anfrage wird angezeigt.
Benutzerdefinierte Daten zu einem Nutzerprofil hinzufügen
- Öffnen Sie die Seite zum Aktualisieren von Nutzern.
- Geben Sie unter userKey die E-Mail-Adresse des Google-Nutzers ein, dessen Profil Sie aktualisieren möchten. (Sie können auch einen E‑Mail-Alias oder eine eindeutige Nutzer-ID verwenden. Weitere Informationen finden Sie in der Dokumentation zur Directory API.
Fügen Sie im Bereich Anfragetext den folgenden Text ein und ersetzen Sie
<role ARN>und<provider ARN>durch die entsprechenden Werte, die im Artikel zur Amazon Web Services-Cloud-Anwendung verfügbar sind.Hinweis: Wenn das benutzerdefinierte Feld
typeaufcustomgesetzt ist, müssen Sie auch den ParametercustomTypeverwenden. Dieser muss auf einen Wert gesetzt sein, damit kein Fehler zurückgegeben wird.{ "customSchemas": { "SSO": { "role": [ { "value": "<role ARN>,<provider ARN>", "type": "custom" "customType": "SSO" } ] } } }Optional: Wenn Sie Zugriff auf mehr als eine Rolle gewähren möchten, fügen Sie Werte innerhalb von
{}hinzu und trennen Sie sie durch ein Komma „,“.- Sie können nur dann mehrere Rollen einrichten, wenn Sie beim Erstellen des Schemas multiValued auf „true“ festlegen.
- Wenn mehrere Rollen verfügbar sind, wird der Nutzer gefragt, welche er verwenden möchte.
In diesem Beispiel sind die beiden Rollen SSO und tester:
{ "customSchemas": { "SSO": { "role": [ { "value": "arn:aws:iam::038047464115:role/SSO,arn:aws:iam::038047464115:saml-provider/Google", "type": "custom" "customType": "SSO" }, { "value": "arn:aws:iam::038047464115:role/tester,arn:aws:iam::038047464115:saml-provider/Google", "type": "custom" "customType": "tester" } ] } } }Klicken Sie auf Ausführen.
Autorisieren Sie den Zugriff auf die Directory API.
Sie sollten die Antwort 200 OK sehen und das Nutzerprofil wird mit den benutzerdefinierten Daten aktualisiert.