LDAP

Entidades, operaciones y acciones

Todos los conectores de integración proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se te muestra como entidades, operaciones y acciones.

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades en la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o no tenga ninguna entidad. En ese caso, la lista Entities estará vacía.

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Al seleccionar una entidad de la lista disponible, se genera una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Acciones

En esta sección se enumeran todas las acciones admitidas por el conector LDAP.

Acción MoveToDN

Esta acción mueve objetos de un nombre distintivo (DN) a otro.

Parámetros de entrada de la acción MoveToDN

Parámetros de salida de la acción DownloadFile

Esta acción devuelve el estado 200 (OK) con un cuerpo de respuesta que indica los resultados.

Para saber cómo configurar la acción MoveToDN, consulta los ejemplos de acciones.

Acción GetAttributes

Esta acción obtiene todos los nombres y valores de los atributos de un DN.

Parámetros de entrada de la acción GetAttributes

Parámetros de salida de la acción GetAttributes

Esta acción devuelve el estado 200 (OK) con un cuerpo de respuesta que indica los resultados.

Para saber cómo configurar la acción GetAttributes, consulta los ejemplos de acciones.

Acción AddMembersToGroup

Esta acción añade usuarios a un grupo.

Parámetros de entrada de la acción GetAttributes

Parámetros de salida de la acción AddMembersToGroup

Esta acción devuelve el estado 200 (OK) con un cuerpo de respuesta que indica los resultados.

Para saber cómo configurar la acción AddMembersToGroup, consulta los ejemplos de acciones.

Ejemplos de acciones

En esta sección se describe cómo realizar algunas de las acciones de este conector.

Ejemplo: mover un objeto de un DN a otro

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción MoveToDN y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el 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"
   }
     

En este ejemplo se mueve un objeto de un DN a otro. Si la acción se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: obtener atributos de un DN

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción GetAttributes y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

En este ejemplo se obtiene el atributo del DN especificado. Si la acción se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: añadir usuarios a un grupo

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción AddMembersToGroup y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el 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\"}]"
   }

En este ejemplo, se añade un DN de usuario al grupo con el ID 1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

[{
  "Success": "True"
  }]

Ejemplos de operaciones de entidades

Ejemplo: mostrar usuarios

En este ejemplo se muestran todos los usuarios de la entidad User.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona User en la lista Entity.
3. Selecciona la operación LIST y, a continuación, haz clic en Hecho.
4. También puedes filtrar el conjunto de resultados. Para filtrar el conjunto de resultados, en la sección Entrada de tarea de la tarea Conectores, define filterClause según tus necesidades.

   Por ejemplo, si se define la cláusula de filtro como Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com', solo se mostrarán los registros cuyo ID coincida con este criterio.

Ejemplo: Obtener un registro de usuario

En este ejemplo se obtienen los detalles de un usuario de la entidad User.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona User en la lista Entity.
3. Selecciona la operación GET y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en EntityId y, a continuación, introduzca 1|CN=admin,CN=Users,DC=test-ldap,DC=com en el campo Valor predeterminado.

   En este caso, 1|CN=admin,CN=Users,DC=test-ldap,DC=com es uno de los valores de clave principal de la entidad User.

Ejemplo: crear un registro de usuario

En este ejemplo se crea un registro de usuario en la entidad User.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona User en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

   Si la integración se realiza correctamente, el campo connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: actualizar una incidencia

En este ejemplo se actualiza el registro del usuario especificado en la entidad User.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona User en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
           "PostalCode": "560040"
         }
         

5. Haga clic en entityId y, a continuación, introduzca 1|CN=admin,CN=Users,DC=test-ldap,DC=com en el campo Valor predeterminado.

   También puede definir filterClause como 1|CN=admin,CN=Users,DC=test-ldap,DC=com en lugar de especificar entityId.

   Si la integración se realiza correctamente, el campo connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: eliminar un registro de usuario

En este ejemplo se elimina un registro de usuario de la entidad User.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona User en la lista Entity.
3. Selecciona la operación Delete y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en entityId y, a continuación, introduzca 1|CN=admin,CN=Users,DC=test-ldap,DC=com en el campo Valor predeterminado.
5. Por otro lado, si la entidad User tiene claves primarias compuestas, en lugar de especificar el entityId, puedes definir el filterClause. Por ejemplo, Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com' and DN='CN=admin,CN=Users,DC=test-ldap,DC=com'.