LDAP

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Actions

Cette section liste toutes les actions compatibles avec le connecteur LDAP.

Action MoveToDN

Cette action déplace des objets d'un DN (nom distinctif) vers un autre.

Paramètres d'entrée de l'action MoveToDN

Paramètres de sortie de l'action DownloadFile

Cette action renvoie l'état 200 (OK) avec un corps de réponse indiquant les résultats.

Pour savoir comment configurer l'action MoveToDN, consultez Exemples d'actions.

Action GetAttributes

Cette action récupère tous les noms et valeurs d'attributs d'un DN.

Paramètres d'entrée de l'action GetAttributes

Paramètres de sortie de l'action GetAttributes

Cette action renvoie l'état 200 (OK) avec un corps de réponse indiquant les résultats.

Pour savoir comment configurer l'action GetAttributes, consultez Exemples d'actions.

Action AddMembersToGroup

Cette action ajoute des utilisateurs à un groupe.

Paramètres d'entrée de l'action GetAttributes

Paramètres de sortie de l'action AddMembersToGroup

Cette action renvoie l'état 200 (OK) avec un corps de réponse indiquant les résultats.

Pour savoir comment configurer l'action AddMembersToGroup, consultez Exemples d'actions.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : Déplacer un objet d'un DN vers un autre

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action MoveToDN, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "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"
   }
     

Cet exemple déplace un objet d'un DN vers un autre. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

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

Exemple : Récupérer les attributs d'un DN

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action GetAttributes, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

Cet exemple récupère l'attribut du DN spécifié. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

[{
    "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
  }]  
  

Exemple : Ajouter des utilisateurs à un groupe

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action AddMembersToGroup, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "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\"}]"
   }

Cet exemple ajoute un DN utilisateur au groupe dont l'ID est 1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

[{
  "Success": "True"
  }]

Exemples d'opérations d'entité

Exemple : Lister des utilisateurs

Cet exemple liste tous les utilisateurs de l'entité User.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez User dans la liste Entity.
3. Sélectionnez l'opération LIST, puis cliquez sur OK.
4. Vous pouvez également filtrer l'ensemble de résultats. Pour filtrer l'ensemble de résultats, dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir filterClause selon vos besoins.

   Par exemple, si vous définissez la clause de filtre sur Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com', vous n'affichez que les enregistrements dont l'ID correspond à ce critère.

Exemple : Récupérer un enregistrement utilisateur

Cet exemple récupère les détails d'un utilisateur à partir de l'entité User.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez User dans la liste Entity.
3. Sélectionnez l'opération GET, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 1|CN=admin,CN=Users,DC=test-ldap,DC=com dans le champ Valeur par défaut.

   Ici, 1|CN=admin,CN=Users,DC=test-ldap,DC=com est l'une des valeurs de clé primaire de l'entité User.

Exemple : Créer un enregistrement utilisateur

Cet exemple crée un enregistrement utilisateur dans l'entité User.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez User dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

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

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

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

Exemple : Mettre à jour une demande

Cet exemple met à jour l'enregistrement utilisateur spécifié dans l'entité User.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez User dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
           "PostalCode": "560040"
         }
         

5. Cliquez sur entityId, puis saisissez 1|CN=admin,CN=Users,DC=test-ldap,DC=com dans le champ Valeur par défaut.

   Sinon, au lieu de spécifier entityId, vous pouvez définir filterClause sur 1|CN=admin,CN=Users,DC=test-ldap,DC=com.

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

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

Exemple : Supprimer un enregistrement utilisateur

Cet exemple supprime un enregistrement utilisateur de l'entité User.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez User dans la liste Entity.
3. Sélectionnez l'opération Delete, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez 1|CN=admin,CN=Users,DC=test-ldap,DC=com dans le champ Valeur par défaut.
5. Si l'entité User comporte des clés primaires composites, vous pouvez définir filterClause au lieu de spécifier entityId. Exemple : Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com' and DN='CN=admin,CN=Users,DC=test-ldap,DC=com'