Okta

Mit dem Okta-Connector können Sie Nutzer-, Gruppen-, Rollen- und App-Datensätze erstellen, lesen, aktualisieren und löschen sowie Nutzern oder Gruppen Rollen und Anwendungen zuweisen oder die Zuweisung aufheben.

Hinweis

Führen Sie in Ihrem Google Cloud-Projekt die folgenden Aufgaben aus:

• Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Informationen zu Netzwerkmustern finden Sie unter Netzwerkverbindung.
• Weisen Sie dem Nutzer, der den Connector konfiguriert, die IAM-Rolle roles/connectors.admin zu.
• Weisen Sie dem Dienstkonto, das Sie für den Connector verwenden möchten, die IAM-Rollen roles/secretmanager.viewer und roles/secretmanager.secretAccessor zu.
• Aktivieren Sie die folgenden Dienste:
  • secretmanager.googleapis.com (Secret Manager API)
  • connectors.googleapis.com (Connectors API)

  Informationen zum Aktivieren von Diensten finden Sie unter Dienste aktivieren. Wenn diese Dienste oder Berechtigungen für Ihr Projekt zuvor nicht aktiviert wurden, werden Sie aufgefordert, sie beim Konfigurieren des Connectors zu aktivieren.

Okta-Verbindung erstellen

Eine Verbindung ist für eine Datenquelle spezifisch. Wenn Sie also viele Datenquellen haben, müssen Sie für jede Datenquelle eine separate Verbindung erstellen. So erstellen Sie eine Verbindung:

1. Rufen Sie in der Cloud Console die Seite Integration Connectors > Verbindungen auf und wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Zur Seite „Verbindungen“

2. Klicken Sie auf + NEU ERSTELLEN, um die Seite Verbindung erstellen zu öffnen.
3. Wählen Sie im Abschnitt Standort den Standort für die Verbindung aus.
   1. Region: Wählen Sie einen Standort aus der Drop-down-Liste aus.

      Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

   2. Klicken Sie auf Weiter.
4. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
   1. Wählen Sie Okta aus der Liste Connector aus.
   2. Wählen Sie eine Connector-Version aus der Liste Connector-Version aus.
   3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein. Der Verbindungsname darf Kleinbuchstaben, Zahlen oder Bindestriche enthalten. Der Name muss mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden. Er darf nicht länger als 49 Zeichen sein.
   4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
   5. Optional können Sie Cloud Logging aktivieren und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error festgelegt.
   6. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
   7. Optional: Konfigurieren Sie die Verbindungsknoteneinstellungen.
   • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
   • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

   Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

   Hinweis:Sie können die Verbindungsknotenwerte nur anpassen, wenn Sie ein „Pay as you go“-Kunde sind.
   8. Domain: Geben Sie eine Okta-Domain ein, um eine Verbindung zur Okta-Instanz herzustellen.
   9. Klicken Sie optional auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
   10. Klicken Sie auf Weiter.
5. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
   1. Wählen Sie einen Authentifizierungstyp aus und geben Sie die relevanten Details ein.

      Die folgenden Authentifizierungstypen werden von der Okta-Verbindung unterstützt:

      • OAuth 2.0-Autorisierungscode
      • OAuth 2.0-Clientanmeldedaten mit JWT-Inhaber

   Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

   2. Klicken Sie auf Next (Weiter).
6. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
7. Klicken Sie auf Erstellen.

Authentifizierung konfigurieren

Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

• OAuth 2.0-Autorisierungscode
  • Client-ID: Die Client-ID, die zum Anfordern von Zugriffstokens verwendet wird.
  • Bereiche: Eine durch Kommas getrennte Liste der gewünschten Bereiche.
  • Clientschlüssel: Der Clientschlüssel, der zum Anfordern von Zugriffstokens verwendet wird.
  • Autorisierungs-URL: Die Autorisierungs-URL, die beim Erstellen des Clients generiert wurde.

Für den Authentifizierungstyp Authorization code müssen Sie nach dem Erstellen der Verbindung einige zusätzliche Schritte zum Konfigurieren der Authentifizierung ausführen. Weitere Informationen finden Sie unter Zusätzliche Schritte nach dem Erstellen der Verbindung.

Verwenden Sie beim Konfigurieren Ihrer OAuth-Drittanbieteranwendung diesen autorisierten Weiterleitungs-URI (Callback-URL):

https://console.cloud.google.com//connectors/oauth?project=PROJECT_ID

Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

• OAuth 2.0 – Clientanmeldedaten mit JWT-Inhaber
  • Client-ID: Die Client-ID, die zum Anfordern von Zugriffstokens verwendet wird.
  • Bereiche: Eine durch Kommas getrennte Liste der gewünschten Bereiche.
  • Privater Schlüssel: Secret Manager-Secret mit dem Inhalt der privaten Schlüsseldatei im PEM-Format. Der private Schlüssel muss mit dem öffentlichen Schlüssel bzw. Zertifikat übereinstimmen.

Zusätzliche Schritte nach dem Erstellen der Verbindung

Wenn Sie OAuth 2.0 - Authorization code für die Authentifizierung ausgewählt haben, müssen Sie nach dem Erstellen der Verbindung die folgenden zusätzlichen Schritte ausführen:

1. Suchen Sie auf der Seite „Verbindungen“ nach der neu erstellten Verbindung.

   Der Status des neuen Connectors ist Autorisierung erforderlich.

2. Klicken Sie auf Autorisierung erforderlich.

   Der Bereich Autorisierung bearbeiten wird angezeigt.

3. Kopieren Sie den Wert unter Weiterleitungs-URI in Ihre externe Anwendung.
4. Überprüfen Sie die Autorisierungsdetails.
5. Klicken Sie auf Autorisieren.

   Wenn die Autorisierung erfolgreich ist, wird der Verbindungsstatus auf der Seite Verbindungen auf Aktiv gesetzt.

Erneute Autorisierung für Autorisierungscode

Wenn Sie den Authentifizierungstyp Authorization code verwenden und Änderungen an der Konfiguration vorgenommen haben, müssen Sie Ihre Okta-Verbindung noch einmal autorisieren. So autorisieren Sie eine Verbindung neu:

1. Klicken Sie auf der Seite Verbindungen auf die gewünschte Verbindung.

   Dadurch wird die Seite mit den Verbindungsdetails geöffnet.

2. Klicken Sie auf Bearbeiten, um die Verbindungsdetails zu bearbeiten.
3. Prüfen Sie im Bereich Authentifizierung die Details zum OAuth 2.0-Autorisierungscode.

   Nehmen Sie bei Bedarf die erforderlichen Änderungen vor.

4. Klicken Sie auf Speichern. Dadurch gelangen Sie zur Seite mit den Verbindungsdetails.
5. Klicken Sie im Abschnitt Authentifizierung auf Autorisierung bearbeiten. Daraufhin wird der Bereich Autorisieren angezeigt.
6. Klicken Sie auf Autorisieren.

   Wenn die Autorisierung erfolgreich ist, wird der Verbindungsstatus auf der Seite Verbindungen auf Aktiv gesetzt.

Systembeschränkungen

Der Okta-Connector kann maximal eine Transaktion pro Sekunde und Knoten verarbeiten. Alle Transaktionen, die dieses Limit überschreiten, werden gedrosselt. Standardmäßig weist Integration Connectors für eine Verbindung zwei Knoten (für eine bessere Verfügbarkeit) zu.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Hinweis:Die Anzahl der Integration Connectors-Knoten wird dynamisch auf Grundlage Ihrer Nutzung automatisch skaliert. Wenn Sie jedoch Kapazität für große Mengen reservieren möchten, ohne auf das Autoscaling zu warten, können Sie den Mindestknotenwert für eine Verbindung anpassen. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, wenn eine Verbindung weniger Transaktionen verarbeitet. So konfigurieren Sie die Knotenwerte:

• Wenn Sie ein „Pay as you go“-Kunde sind, konfigurieren Sie den Mindest- und Höchstwert für Knoten auf der Seite „Verbindung bearbeiten“.
• Wenn Sie ein Abo haben, wenden Sie sich an den Support.

Die maximale Anzahl von Transaktionen, die ein Knoten verarbeiten kann, hängt von verschiedenen Faktoren ab. Bevor Sie die Mindestanzahl von Knoten für einen besseren Durchsatz anpassen, sollten Sie prüfen, ob Ihre Backend-Systeme optimal für die Verarbeitung des erforderlichen Traffics eingerichtet sind.

Okta-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie sowohl in Apigee Integration als auch in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Aufgabe „Connectors“ verwenden.

• Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Apigee Integration finden Sie unter Connectors-Aufgabe.
• Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Application Integration finden Sie unter Connectors-Aufgabe.

Aktionen

In diesem Abschnitt werden die vom Okta-Connector unterstützten Aktionen aufgeführt. Informationen zum Konfigurieren der Aktionen finden Sie unter Beispiele für Aktionen.

Aktion „ReactivateUser“

Durch diese Aktion wird ein Nutzer reaktiviert.

Eingabeparameter der Aktion „ReactivateUser“

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.

Ein Beispiel für die Konfiguration der Aktion ReactivateUser finden Sie unter ActivateUser-Beispiel.

ActivateUser-Aktion

Durch diese Aktion wird ein Nutzer aktiviert.

Eingabeparameter der Aktion „ActivateUser“

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.

Ein Beispiel für die Konfiguration der Aktion ActivateUser finden Sie unter ActivateUser-Beispiel.

Aktion „DeactivateUser“

Durch diese Aktion wird ein Nutzer deaktiviert.

Eingabeparameter der Aktion „DeactivateUser“

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.

Ein Beispiel für die Konfiguration der Aktion DeactivateUser finden Sie unter DeactivateUser-Beispiel.

Assignusertogroup-Aktion

Durch diese Aktion wird ein Nutzer einer Gruppe zugewiesen.

Eingabeparameter der Assignusertogroup-Aktion

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.
GroupID	String	Wahr	Die ID der Gruppe.

Ein Beispiel für die Konfiguration der Aktion Assignusertogroup finden Sie unter Beispiel für Assignusertogroup.

Aktion „UnassignUsertoRole“

Durch diese Aktion wird die Zuweisung eines Nutzers zu einer Rolle aufgehoben.

Eingabeparameter der Aktion „UnassignUsertoRole“

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.
RoleAssignmentId	String	Wahr	Die ID der Rolle.

Ein Beispiel für die Konfiguration der Aktion UnassignUsertoRole finden Sie unter Beispiel für UnassignUsertoRole.

Aktion „AssignUsertoRole“

Durch diese Aktion wird einem Nutzer eine Rolle zugewiesen.

Eingabeparameter der Aktion „AssignUsertoRole“

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.
RoleId	String	Wahr	Die ID der Rolle.

Ein Beispiel für die Konfiguration der Aktion AssignUsertoRole finden Sie unter Beispiel für AssignUsertoRole.

AssignUsertoApp-Aktion

Durch diese Aktion wird ein Nutzer einer App zugewiesen.

Eingabeparameter der Aktion „AssignUsertoApp“

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.
AppId	String	Wahr	Die ID der App.

Ein Beispiel für die Konfiguration der Aktion AssignUsertoApp finden Sie unter AssignUsertoApp-Beispiel.

Aktion „UnassignUsertoGroup“

Durch diese Aktion wird die Zuweisung eines Nutzers zu einer Gruppe aufgehoben.

Eingabeparameter der Aktion „UnassignUsertoGroup“

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.
GroupID	String	Wahr	Die ID der Gruppe.

Ein Beispiel für die Konfiguration der Aktion UnassignUsertoGroup finden Sie unter Beispiel für UnassignUsertoGroup.

Aktion „UnassignUsertoApp“

Durch diese Aktion wird die Zuweisung eines Nutzers zu einer App aufgehoben.

Eingabeparameter der Aktion „UnassignUsertoApp“

Parametername	Datentyp	Erforderlich	Beschreibung
UserID	String	Wahr	Die ID des Nutzers.
AppID	String	Wahr	Die ID der App.

Ein Beispiel für die Konfiguration der Aktion UnassignUsertoApp finden Sie unter Beispiel für UnassignUsertoApp.

Aktion „Assigngrouptoapp“

Mit dieser Aktion wird einer App eine Gruppe zugewiesen.

Eingabeparameter der Assigngrouptoapp-Aktion

Parametername	Datentyp	Erforderlich	Beschreibung
Gruppen-ID	String	Wahr	Die ID der Gruppe.
AppID	String	Wahr	Die ID der App.

Ein Beispiel für die Konfiguration der Aktion Assigngrouptoapp finden Sie unter Beispiel für Assigngrouptoapp.

Aktion „AssignGrouptoRole“

Durch diese Aktion wird einer Gruppe eine Rolle zugewiesen.

Eingabeparameter der Aktion „AssignGrouptoRole“

Parametername	Datentyp	Erforderlich	Beschreibung
Gruppen-ID	String	Wahr	Die ID der Gruppe
RoleId	String	Wahr	Die ID der Rolle
TypeId	String	Wahr	Die ID des Typs

Ein Beispiel für die Konfiguration der AssignGrouptoRole-Aktion finden Sie unter Beispiel für AssignGrouptoRole.

Aktion „UnassignGrouptoApp“

Mit dieser Aktion wird die Zuweisung einer Gruppe zu einer App aufgehoben.

Eingabeparameter der Aktion „UnassignGrouptoApp“

Parametername	Datentyp	Erforderlich	Beschreibung
Gruppe	String	Wahr	Die ID der GroupId
AppID	String	Wahr	Die ID der App

Ein Beispiel für die Konfiguration der Aktion UnassignGrouptoApp finden Sie unter UnassignGrouptoApp Example.

Aktion „UnassignGrouptoRole“

Bei dieser Aktion wird einer Gruppe die Zuweisung zu einer Rolle entzogen.

Eingabeparameter der Aktion „UnassignGrouptoRole“

Parametername	Datentyp	Erforderlich	Beschreibung
Gruppe	String	Wahr	Die ID der GroupId
AppID	String	Wahr	Die ID der AppId

Ein Beispiel für die Konfiguration der Aktion UnassignGrouptoRole finden Sie unter Beispiel für UnassignGrouptoRole.

Aktion „SuspendUser“

Durch diese Aktion wird ein Nutzer gesperrt.

Eingabeparameter der Aktion „SuspendUser“

Parametername	Datentyp	Erforderlich	Beschreibung
Gruppe	String	Wahr	Die ID der GroupId.
AppID	String	Wahr	Die ID der AppId.

Ein Beispiel für die Konfiguration der Aktion SuspendUser finden Sie unter SuspendUser-Beispiel.

Aktion „UnsuspendUser“

Dadurch wird die Sperrung eines Nutzers aufgehoben.

Eingabeparameter der Aktion „UnsuspendUser“

Parametername	Datentyp	Erforderlich	Beschreibung
Gruppe	String	Wahr	Die ID der GroupId.
AppID	String	Wahr	Die ID der AppId.

Ein Beispiel für die Konfiguration der Aktion UnsuspendUser finden Sie unter Beispiel für UnsuspendUser.

Beispiele für Aktionen

Beispiel: Nutzer reaktivieren

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion ReactivateUser aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": "00ulgqf2s4Zs5Ohge5d7"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des ReactivateUser-Vorgangs einen Wert, der dem folgenden ähnelt:

{ 
    "Status": "Success",
    "ActivationToken": "PKeQTJMUW9vg0wyh8czA",
    "ActivationUrl": "https://dev-99779501.okta.com/tokens/PKeQTJMUW9vg0wyh8czA/verify" 
}

Beispiel: Nutzer aktivieren

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion ActivateUser aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": "00ulgqf2s4Zs5Ohge5d7"
   }
   
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des ActivateUser-Vorgangs einen Wert, der dem folgenden ähnelt:

{ 
  "Status": "Success",
    "activationurl": null,
    "activationtoken": null
}

Beispiel: Nutzer deaktivieren

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion DeactivateUser aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": "00ulgqf2s4Zs5Ohge5d7"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DeactivateUser-Vorgangs einen Wert, der dem folgenden ähnelt:

{ 
 "Status": "Success",
"activationurl": null,
"activationtoken": null 
} 

Beispiel: Nutzer einer Gruppe zuweisen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion Assignusertogroup aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": "00ulgqf2s4Zs5Ohge5d7",
       "GroupId": "7463874b834938475d"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Assignusertogroup-Vorgangs einen Wert, der dem folgenden ähnelt:

{
 "Status": "Success",
}

Beispiel: Rollenzuweisung eines Nutzers aufheben

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UnassignUsertoRole aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": "00ukxucmpl25SNLP65d7",
       "RoleAssignmentId": "irblawnjpom1bLBcJ5d7"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UnassignUsertoRole-Vorgangs einen Wert, der dem folgenden ähnelt:

{
 "Status": "Success",
}

Beispiel: Nutzer einer Rolle zuweisen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion AssignUsertoRole aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "UserId": "00ukxucmpl25SNLP65d7",
   "RoleId": "cr0l2n9ay0pCCxLgG5d7",
   "ResourceSet": "iaml81kep6zefR4Oq5d7",
   "Type": "CUSTOM"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AssignUsertoRole-Vorgangs einen Wert, der dem folgenden ähnelt:

{
 "Status": "Success",
    "Id": "irblawfe99RsUfILD5d7",
    "Label": "UserCreatorByabhishkePostman",
    "Type": "CUSTOM", 
    "Created": "2024-11-21 07:33:05.0",
    "LastUpdated": "2024-11-21 07:33:05.0",
    "AssignmentStatus": "ACTIVE",
    "AssignmentType": "USER",
    "resource-set": "iaml81kep6zefR4Oq5d7",
    "role": "cr0l2n9ay0pCCxLgG5d7",
    "_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7",
    "_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7",
    "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7/permissions",
    "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l2n9ay0pCCxLgG5d7/members/irblawfe99RsUfILD5d7",
    "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"

}

Beispiel: Nutzer einer App zuweisen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion AssignUsertoApp aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": "00ukxucmpl25SNLP65d7",
       "AppId": "0oakn3j0bfGPR1Esk5d7"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AssignUsertoApp-Vorgangs einen Wert, der dem folgenden ähnelt:

{
    "Status": "Success",
    "Id": "00ukxucmpl25SNLP65d7",
    "Created": "2024-11-21 07:08:40.0",
    "LastUpdated": "2024-11-21 07:08:45.0",
    "Scope": "USER",
    "AssignmentStatus": "ACTIVE",
    "externalid": null, 
    "statuschanged": "2024-11-21T07:08:40.000Z",
    "passwordchanged": null,
    "syncstate": "DISABLED",
    "credentials_username": "[e-mail]",
    "profile_street_address": null,
    "profile_country": null, 
    "profile_website": null,
    "profile_zoneinfo": "America/Los_Angeles",
    "profile_birthdate": null,
    "profile_gender": null,
    "profile_formatted": null,
    "profile_profile": null,
    "profile_locality": null,
    "profile_given_name": "Baklavainthe",
    "profile_middle_name": null,
    le_phone_number": null,
    "profile_region": null,
    "profile_postal_code": null,
    "profile_family_name": "Balkans",
    "profile_email": "[e-mail]",
    "_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7", 
    "_links_user_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"

}

Beispiel: Zuweisung eines Nutzers zu einer Gruppe aufheben

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UnassignUsertoGroup aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": "00ukxucmpl25SNLP65d7",
       "GroupId": "0oakn3j0bfGPR1Esk5d7"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UnassignUsertoGroup-Vorgangs einen Wert, der dem folgenden ähnelt:

{
"Status": "Success"
}

Beispiel: Zuweisung eines Nutzers für eine App aufheben

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UnassignUsertoApp aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
       "UserId": "00ukxucmpl25SNLP65d7",
       "AppId": "0oakn3j0bfGPR1Esk5d7"
   }
   
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UnassignUsertoApp-Vorgangs einen Wert, der dem folgenden ähnelt:

 
{
"Status": "Success"
}

Beispiel: Gruppe einer App zuweisen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion Assigngrouptoapp aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
      "GroupId": "00gl5wovm8GuLr8vg5d7",
       "AppId": "0oakn3j0bfGPR1Esk5d7"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Assigngrouptoapp-Vorgangs einen Wert, der dem folgenden ähnelt:

{
"Status": "Success",
"Id": "00gl5wovm8GuLr8vg5d7",
"LastUpdated": "2024-11-21 08:42:53.0",
"Priority": 0,
"_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7",
"_links_self_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7/groups/00gl5wovm8GuLr8vg5d7", "_links_group_href": "https://dev-99779501.okta.com/api/v1/groups/00gl5wovm8GuLr8vg5d7"
}

Beispiel: Einer Rolle eine Gruppe zuweisen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion AssignGrouptoRole aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "GroupId": "00gl9xqojqXq0TJgS5d7",
   "RoleId": "cr0l5tqddvkDtcfPl5d7",
   "Type": "CUSTOM", "ResourceSet": "iaml81kep6zefR4Oq5d7"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AssignGrouptoRole-Vorgangs einen Wert, der dem folgenden ähnelt:

{
"Status": "Success",
"Id": "irbla1k8uy8XxDDFF5d7",
"Label": "ReadAdmin_Altostrat",
"Type": "CUSTOM",
"Created": "2024-11-20 12:28:33.0",
"LastUpdated": "2024-11-20 12:28:33.0",
"AssignmentStatus": "ACTIVE",
"AssignmentType": "GROUP",
"resource-set": "iaml81kep6zefR4Oq5d7",
"role": "cr0l5tqddvkDtcfPl5d7",
"_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7",
"_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7", "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7/permissions", "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l5tqddvkDtcfPl5d7/members/irbla1k8uy8XxDDFF5d7", "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/groups/00gl9xqojqXq0TJgS5d7"
}

Beispiel – Gruppe aus einer App entfernen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UnassignGrouptoApp aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
    "GroupId": "00gl5wovm8GuLr8vg5d7",
    "AppId": "0oakn3j0bfGPR1Esk5d7" 
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UnassignGrouptoApp-Vorgangs einen Wert, der dem folgenden ähnelt:

{
"Status": "Success"
}

Beispiel: Zuweisung einer Gruppe aus einer Rolle aufheben

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UnassignGrouptoRole aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "GroupId": "00gl5wovm8GuLr8vg5d7",
   "RoleAssignmentId": "irbl94sbyit77SGpg5d7"
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UnassignGrouptoRole-Vorgangs einen Wert, der dem folgenden ähnelt:

{
"Status": "Success"
}

Beispiel: Nutzer sperren

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion SuspendUser aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "UserId": "00ulkdsubxO6W6LgJ5d7" 
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des SuspendUser-Vorgangs einen Wert, der dem folgenden ähnelt:

{
"Status": "Success"
}

Beispiel – Sperre eines Nutzers aufheben

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion UnsuspendUser aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "UserId": "00ulkdsubxO6W6LgJ5d7" 
   }
   

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UnsuspendUser-Vorgangs einen Wert, der dem folgenden ähnelt:

{
"Status": "Success"
}

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird beschrieben, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Alle Nutzer auflisten

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option „Nutzer“ aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
4. Im Bereich Aufgabeneingabe der Aufgabe Connectors können Sie die filterClause nach Bedarf festlegen.

Der Wert für eine Filterklausel muss in einfache Anführungszeichen (') gesetzt sein. Mit der Filterklausel können Sie Datensätze anhand der Spalten filtern.

Beispiel: Nutzer abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Users aus der Liste Entity aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „20001“ fest. Dies ist der zu übergebende Schlüssel. Klicken Sie zum Festlegen der Entitäts-ID im Bereich Data Mapper des Data Mapping auf Open Data Mapping Editor (Datenabgleichs-Editor öffnen). Geben Sie dann "20001" in das Feld Input Value (Eingabewert) ein und wählen Sie „EntityId“ als lokale Variable aus.

Sie müssen die Entitäts-ID direkt übergeben, z. B. „20001“. Hier ist „20001“ der eindeutige Primärschlüsselwert, der übergeben wird.

Sie müssen die Filterklausel in Abfragen verwenden, bei denen das Übergeben einer Entitäts-ID einen Fehler auslösen würde, da es zwei zusammengesetzte Schlüssel gibt, z. B. id='20001'.

Beispiel: Nutzer löschen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Users aus der Liste Entity aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „00ul7l5fdyTdHDfSj5d7“ fest. Das ist der Schlüssel, der übergeben werden soll. Klicken Sie dazu im Bereich Data Mapper des Data Mapping auf Open Data Mapping Editor (Datenabgleichs-Editor öffnen), geben Sie "20001" in das Feld Input Value (Eingabewert) ein und wählen Sie EntityId als lokale Variable aus.

   Wenn eine Entität zwei zusammengesetzte Geschäfts- oder Primärschlüssel hat, können Sie anstelle der entityId auch die filterClause auf id='00ul7l5fdyTdHDfSj5d7' festlegen.

Beispiel: Nutzer erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Users aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.

   { "ProfileFirstName": "Test",
       "ProfileLastName": "Test User",
       "ProfileEmail": "[e-mail]",
       "ProfileLogin": "[e-mail]"
   }
   

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Vendor-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": "00ula502hjbwWYsO25d7"
   }
   

Beispiel: Gruppe erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Groups aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.

   {
       "ProfileDescription": "Googlecloud group",
       "ProfileName": "Goolecloud created grp\n"
   }
   

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des APBill-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": "00gl7lb5gniIAOMwA5d7"
   }
   

Beispiel: App erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Apps aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.

   { "Label": "Googlecloud generated app",
       "SignOnMode": "AUTO_LOGIN",
       "AutoSubmitToolbar": false,
       "Settings": "{\"signOn\":{\"redirectUrl\":\"https://www.example.com\",\"loginUrl\":\"https://www.example.com\"}}"
   }
   

   In diesem Beispiel wird der Vendtype erstellt. Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Vendtype-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": "0oal9vwooxEXXpdjS5d7"
   }
   

Beispiel: Rolle erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Roles aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.

   { "Label": "new role2", 
       "Description": "GABA Role1",
       "Permissions": "\"okta.users.read\", \"okta.groups.read\"" 
   }
   

   Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Customer-Vorgangs einen Wert, der dem folgenden ähnelt:

   {
       "Id": "cr0l824rbiTvtJDoi5d7"
   }
   

Beispiel: Nutzer aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Users aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
       "ProfileFirstName": "ShubhGillL" 
   }
   

5. Legen Sie die Entitäts-ID im Data Mapper auf die Entität der Nutzer fest. Klicken Sie zum Festlegen der Entitäts-ID auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf 20044 festlegen.

   Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

   {
       "Id": "00ul7u8cyobt8SGRK5d7" 
   }
   

Beispiel: Gruppe aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Groups aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
       "ProfileName": "Updated Googlecloud group"
   }
   

5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der Gruppen fest. Klicken Sie zum Festlegen der Entitäts-ID auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf 1371 festlegen.

   Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

   {
       "Id": "00gl92veg4VSQQb5A5d7"
   }
   

Beispiel: App aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Apps aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
       "Label": "Googlecloud updated label"
   }
   

5. Legen Sie die Entitäts-ID im Data Mapper auf die Entität der Apps fest. Klicken Sie zum Festlegen der Entitäts-ID auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf Customerid='10100'\n festlegen.

   Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

   {
       "Id": "0oal9vwooxEXXpdjS5d7"
   }
   

Beispiel: Rolle aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie Roles aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
       "Label": "Googlecloud updated label"
   }
   

5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der Rollen fest. Klicken Sie zum Festlegen der Entitäts-ID auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf 1 festlegen.

   Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

   {
       "Id": "cr0l7dqeatRuIrn5x5d7"
   }
   

Hilfe von der Google Cloud-Community erhalten

Sie können Ihre Fragen und Anregungen zu diesem Connector in der Google Cloud-Community unter Cloud-Foren posten.

Nächste Schritte

• Verbindungen anhalten und fortsetzen
• Connector-Nutzung überwachen
• Connector-Logs ansehen