LDAP

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

• Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

  No entanto, é possível que um conector não aceite ou não tenha entidades. Nesse caso, a lista Entities estará vazia.

• Operação: uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:
  • Lista
  • Receber
  • Criar
  • Atualizar
  • Excluir

  Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não oferecer suporte a nenhuma das operações de entidade, essas operações sem suporte não serão listadas na lista Operations.

• Ação: uma ação é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer alterações em uma ou mais entidades e varia de um conector para outro. Normalmente, uma ação tem alguns parâmetros de entrada, . No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.

Ações

Esta seção lista todas as ações aceitas pelo conector LDAP.

Ação MoveToDN

Essa ação move objetos de um DN (nome distinto) para outro.

Parâmetros de entrada da ação MoveToDN

Parâmetros de saída da ação DownloadFile

Essa ação retorna o status 200 (OK) com um corpo de resposta indicando os resultados.

Para entender como configurar a ação MoveToDN, consulte Exemplos de ação.

Ação GetAttributes

Essa ação recebe todos os nomes e valores de atributo de um DN.

Parâmetros de entrada da ação GetAttributes

Parâmetros de saída da ação GetAttributes

Essa ação retorna o status 200 (OK) com um corpo de resposta indicando os resultados.

Para entender como configurar a ação GetAttributes, consulte Exemplos de ação.

Ação "AddMembersToGroup"

Esta ação adiciona usuários a um grupo.

Parâmetros de entrada da ação GetAttributes

Parâmetros de saída da ação AddMembersToGroup

Essa ação retorna o status 200 (OK) com um corpo de resposta indicando os resultados.

Para entender como configurar a ação AddMembersToGroup, consulte Exemplos de ações.

Exemplos de ação

Esta seção descreve como realizar algumas das ações neste conector.

Exemplo: mover um objeto de um DN para outro

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação MoveToDN e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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"
   }
     

Este exemplo move um objeto de um DN para outro. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: acessar atributos de um DN

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação GetAttributes e clique em Concluído.
3. Na seção Entrada de tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Campo Default Value:

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

Este exemplo recebe o atributo do DN especificado. Se a ação for bem-sucedida, seu Resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

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

Exemplo: adicionar usuários a um grupo

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação AddMembersToGroup e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no 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\"}]"
   }

Este exemplo adiciona um DN de usuário ao grupo com o ID 1|CN=Cert Publishers,CN=Users,DC=test-ldap,DC=com. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

[{
  "Success": "True"
  }]

Exemplos de operações de entidade

Exemplo: listar usuários

Este exemplo lista todos os usuários na entidade User.

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione User na lista Entity.
3. Selecione a operação LIST e clique em Concluído.
4. Também é possível filtrar o conjunto de resultados. Para filtrar o conjunto de resultados, na coluna Task Input da tarefa Conectores, defina a filterCláusula conforme necessário.

   Por exemplo, definir a cláusula de filtro como Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com', lista apenas os registros cujo ID corresponde a esses critérios.

Exemplo: receber um registro de usuário

Este exemplo recebe um detalhe do usuário da entidade User.

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione User na lista Entity.
3. Selecione a operação GET e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em EntityId e insira 1|CN=admin,CN=Users,DC=test-ldap,DC=com no campo Valor padrão.

   Aqui, 1|CN=admin,CN=Users,DC=test-ldap,DC=com é um dos valores da chave primária da entidade User.

Exemplo: criar um registro de usuário

Neste exemplo, criamos um registro de usuário na entidade User.

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione User na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

   Se a integração for bem-sucedida, o campo connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: atualizar um tíquete

Este exemplo atualiza o registro do usuário especificado na entidade User.

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione User na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Entrada de tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Campo Default Value:

   {
           "PostalCode": "560040"
         }
         

5. Clique em entityId e insira 1|CN=admin,CN=Users,DC=test-ldap,DC=com no campo Valor padrão.

   Como alternativa, em vez de especificar o entityId, você também pode definir a filterClause como 1|CN=admin,CN=Users,DC=test-ldap,DC=com.

   Se a integração for bem-sucedida, o campo connectorOutputPayload da tarefa do conector terá um valor semelhante a este:

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

Exemplo: excluir um registro de usuário

Este exemplo exclui um registro de usuário da entidade User.

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione User na lista Entity.
3. Selecione a operação Delete e clique em Concluído.
4. Na seção Entrada da tarefa da tarefa Connectors, clique em entityId e insira 1|CN=admin,CN=Users,DC=test-ldap,DC=com no campo Valor padrão.
5. Como alternativa, se a entidade User tiver chaves primárias compostas, em vez de especificar a entityId, é possível definir o filterFilter. Por exemplo, Id='1|CN=admin,CN=Users,DC=test-ldap,DC=com' and DN='CN=admin,CN=Users,DC=test-ldap,DC=com'.