LDAP

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

• Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

  Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Liste Entities leer.

• Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keine der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Operations-Liste aufgeführt.

• Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und einen Ausgabeparameter. Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Aktionen

In diesem Abschnitt werden alle vom LDAP-Connector unterstützten Aktionen aufgeführt.

MoveToDN-Aktion

Bei dieser Aktion werden Objekte von einem DN (Distinguished Name) zu einem anderen verschoben.

Eingabeparameter der MoveToDN-Aktion

Ausgabeparameter der Aktion „DownloadFile“

Diese Aktion gibt den Status 200 (OK) mit einem Antworttext zurück, der die Ergebnisse enthält.

Informationen zum Konfigurieren der Aktion MoveToDN finden Sie unter Beispiele für Aktionen.

Aktion „GetAttributes“

Mit dieser Aktion werden alle Attributnamen und -werte eines DN abgerufen.

Eingabeparameter der Aktion „GetAttributes“

Ausgabeparameter der Aktion „GetAttributes“

Diese Aktion gibt den Status 200 (OK) mit einem Antworttext zurück, der die Ergebnisse enthält.

Informationen zum Konfigurieren der Aktion GetAttributes finden Sie unter Beispiele für Aktionen.

Aktion „AddMembersToGroup“

Durch diese Aktion werden Nutzer einer Gruppe hinzugefügt.

Eingabeparameter der Aktion „GetAttributes“

Ausgabeparameter der Aktion „AddMembersToGroup“

Diese Aktion gibt den Status 200 (OK) mit einem Antworttext zurück, der die Ergebnisse enthält.

Informationen zum Konfigurieren der Aktion AddMembersToGroup finden Sie unter Beispiele für Aktionen.

Beispiele für Aktionen

In diesem Abschnitt wird beschrieben, wie Sie einige der Aktionen in diesem Connector ausführen.

Beispiel: Objekt von einem DN in einen anderen verschieben

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion MoveToDN 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:

   {
   "DN": "CN=Google Cloud,OU=Bangalore,OU=India,OU=Domain_Users,DC=test-ldap,DC=com",
   "NewParentDN": "OU=Mysore,OU=India,OU=Domain_Users,DC=test-ldap,DC=com"
   }
     

In diesem Beispiel wird ein Objekt von einem DN in ein anderes verschoben. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
"Success": null,
"result": "[ok]",
"modified": "true",
"rss:title": "The movement was successful.",
"resultcode": "0"
}]

Beispiel: Attribute eines DN abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion GetAttributes 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:

   {
   "DN": "CN=Bangalore user,OU=Bangalore,OU=India,OU=Domain_Users,DC=test-ldap,DC=com"
   }

In diesem Beispiel wird das Attribut des angegebenen DN abgerufen. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
    "AttributeName": "_op",
    "AttributeValue": "ldapadoGetAttributes"
  }, {
    "AttributeName": "usncreated",
    "AttributeValue": "36006"
  }, {
    "AttributeName": "countrycode",
    "AttributeValue": "0"
  }, {
    "AttributeName": "badpwdcount",
    "AttributeValue": "0"
  }, {
    "AttributeName": "dn",
    "AttributeValue": ""
  }, {
    "AttributeName": "dn",
    "AttributeValue": "CN=Bangalore user,OU=Bangalore,OU=India,OU=Domain_Users,DC=test-ldap,DC=com"
  }, {
    "AttributeName": "whenchanged",
    "AttributeValue": "20230913125155.0Z"
  }, {
    "AttributeName": "objectclass",
    "AttributeValue": "top"
  }, {
    "AttributeName": "objectclass",
    "AttributeValue": "person"
  }, {
    "AttributeName": "objectclass",
    "AttributeValue": "organizationalPerson"
  }, {
    "AttributeName": "objectclass",
    "AttributeValue": "user"
  }, {
    "AttributeName": "primarygroupid",
    "AttributeValue": "513"
  }, {
    "AttributeName": "givenname",
    "AttributeValue": "Bangalore"
  }, {
    "AttributeName": "dscorepropagationdata",
    "AttributeValue": "16010101000001.0Z"
  }, {
    "AttributeName": "sn",
    "AttributeValue": "user"
  }, {
    "AttributeName": "useraccountcontrol",
    "AttributeValue": "512"
  }, {
    "AttributeName": "cn",
    "AttributeValue": "Bangalore user"
  }, {
    "AttributeName": "codepage",
    "AttributeValue": "0"
  }, {
    "AttributeName": "accountexpires",
    "AttributeValue": "9223372036854775807"
  }, {
    "AttributeName": "userprincipalname",
    "AttributeValue": "user-1@test-l
  }]  
  

Beispiel: Nutzer einer Gruppe hinzufügen

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion AddMembersToGroup 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 das Feld Default Value ein:

   {
   "GroupId": "1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com",
   "UserDNs": "[{\"DN\":\"CN=Google AI,CN=Users,DC=test-ldap,DC=com;CN=Guest,CN=Users,DC=test-ldap,DC=com\"}]"
   }

In diesem Beispiel wird der Gruppe mit der ID 1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com ein Nutzer-DN hinzugefügt. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
  "Success": "True"
  }]

Beispiele für Entitätsvorgänge

Beispiel: Nutzer auflisten

In diesem Beispiel werden alle Nutzer in der User-Einheit aufgeführt.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie User aus der Liste Entity aus.
3. Wählen Sie den Vorgang LIST aus und klicken Sie auf Fertig.
4. Optional können Sie das Ergebnisset filtern. Wenn Sie den Ergebnissatz filtern möchten, legen Sie im Bereich Aufgabeneingabe der Aufgabe Connectors die filterClause entsprechend Ihren Anforderungen fest.

   Wenn Sie die Filterklausel beispielsweise auf Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com' festlegen, werden nur die Datensätze aufgeführt, deren ID diesem Kriterium entspricht.

Beispiel: Nutzerdatensatz abrufen

In diesem Beispiel werden Nutzerdetails aus der User-Einheit abgerufen.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie User aus der Liste Entity aus.
3. Wählen Sie den Vorgang GET aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf EntityId und geben Sie dann 1|CN=admin,CN=Users,DC=test-ldap,DC=com in das Feld Standardwert ein.

   Dabei ist 1|CN=admin,CN=Users,DC=test-ldap,DC=com einer der Primärschlüsselwerte der User-Entität.

Beispiel: Nutzerdatensatz erstellen

In diesem Beispiel wird ein Nutzerdatensatz in der User-Entität erstellt.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie User aus der Liste Entity aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Default Value ein:

   {
   "RDN": "CN=MPATAI",
   "ObjectClass": "top;person;organizationalPerson;user"
   }

   Wenn die Integration erfolgreich ist, hat das Feld connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    {
   "Id": "1|CN=MPATAI,CN=Users,DC=test-ldap,DC=com"
   }

Beispiel: Ticket aktualisieren

In diesem Beispiel wird der angegebene Nutzerdatensatz in der User-Entität aktualisiert.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie User aus der Liste Entity aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
           "PostalCode": "560040"
         }
         

5. Klicken Sie auf entityId und geben Sie dann 1|CN=admin,CN=Users,DC=test-ldap,DC=com in das Feld Standardwert ein.

   Anstelle der entityId können Sie auch die filterClause auf 1|CN=admin,CN=Users,DC=test-ldap,DC=com festlegen.

   Wenn die Integration erfolgreich ist, enthält das Feld connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

   {
   "Id": "1|CN=admin,CN=Users,DC=test-ldap,DC=com"
   }
         

Beispiel: Nutzerdatensatz löschen

In diesem Beispiel wird ein Nutzerdatensatz aus der User-Entität gelöscht.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie User aus der Liste Entity aus.
3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf entityId und geben Sie dann 1|CN=admin,CN=Users,DC=test-ldap,DC=com in das Feld Standardwert ein.
5. Wenn die User-Entität zusammengesetzte Primärschlüssel hat, können Sie anstelle der entityId auch die filterClause festlegen. Beispiel: Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com' and DN='CN=admin,CN=Users,DC=test-ldap,DC=com'