LDAP

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca tutte le azioni supportate dal connettore LDAP.

Azione MoveToDN

Questa azione sposta gli oggetti da un nome distinto (DN) a un altro.

Parametri di input dell'azione MoveToDN

Parametri di output dell'azione DownloadFile

Questa azione restituisce lo stato 200 (OK) con un corpo della risposta che indica i risultati.

Per capire come configurare l'azione MoveToDN, consulta Esempi di azioni.

Azione GetAttributes

Questa azione recupera tutti i nomi e i valori degli attributi di un DN.

Parametri di input dell'azione GetAttributes

Parametri di output dell'azione GetAttributes

Questa azione restituisce lo stato 200 (OK) con un corpo della risposta che indica i risultati.

Per capire come configurare l'azione GetAttributes, consulta Esempi di azioni.

Azione AddMembersToGroup

Questa azione aggiunge utenti a un gruppo.

Parametri di input dell'azione GetAttributes

Parametri di output dell'azione AddMembersToGroup

Questa azione restituisce lo stato 200 (OK) con un corpo della risposta che indica i risultati.

Per capire come configurare l'azione AddMembersToGroup, consulta Esempi di azioni.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: sposta un oggetto da un DN a un altro DN

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione MoveToDN, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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"
   }
     

Questo esempio sposta un oggetto da un nome distinto a un altro. Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: recuperare gli attributi di un DN

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione GetAttributes, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Questo esempio recupera l'attributo del DN specificato. Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: aggiungi utenti a un gruppo

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddMembersToGroup, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo 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\"}]"
   }

Questo esempio aggiunge un ND utente al gruppo con ID 1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

[{
  "Success": "True"
  }]

Esempi di operazioni sulle entità

Esempio: elencare gli utenti

Questo esempio elenca tutti gli utenti nell'entità User.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona User dall'elenco Entity.
3. Seleziona l'operazione LIST, quindi fai clic su Fine.
4. Se vuoi, puoi filtrare il set di risultati. Per filtrare il set di risultati, nella sezione Input attività dell'attività Connettori, imposta filterClause in base alle tue esigenze.

   Ad esempio, se imposti la clausola di filtro su Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com', vengono elencati solo i record il cui ID corrisponde a questi criteri.

Esempio: recuperare un record utente

Questo esempio recupera i dettagli di un utente dall'entità User.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona User dall'elenco Entity.
3. Seleziona l'operazione GET, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci 1|CN=admin,CN=Users,DC=test-ldap,DC=com nel campo Valore predefinito.

   Qui, 1|CN=admin,CN=Users,DC=test-ldap,DC=com è uno dei valori della chiave primaria dell'entità User.

Esempio: crea un record utente

Questo esempio crea un record utente nell'entità User.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona User dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

   Se l'integrazione ha esito positivo, il campo connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: aggiornare un ticket

Questo esempio aggiorna il record utente specificato nell'entità User.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona User dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
           "PostalCode": "560040"
         }
         

5. Fai clic su entityId, quindi inserisci 1|CN=admin,CN=Users,DC=test-ldap,DC=com nel campo Valore predefinito.

   In alternativa, anziché specificare entityId, puoi anche impostare filterClause su 1|CN=admin,CN=Users,DC=test-ldap,DC=com.

   Se l'integrazione ha esito positivo, il campo connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

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

Esempio: eliminare un record utente

Questo esempio elimina un record utente dall'entità User.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona User dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci 1|CN=admin,CN=Users,DC=test-ldap,DC=com nel campo Valore predefinito.
5. In alternativa, se l'entità User ha chiavi primarie composite, anziché specificare entityId, puoi impostare filterClause. Ad esempio: Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com' and DN='CN=admin,CN=Users,DC=test-ldap,DC=com'.