Como configurar a integração do Personio no ADManager Plus:

Pré-requisitos:

O Personio usa OAuth2.0 para autorizar solicitações de API. Você precisará ter o client_id (ID do cliente) e o client_secret (Segredo do cliente) para recuperar as informações desejadas e realizar tarefas no Personio. Consulte a documentação da API do Personio para obter mais detalhes.

Privilégios:

• Para importar usuários do Personio (ação de entrada): Certifique-se de que a conta usada para autorização tenha permissão para ler todas as contas de usuário.
• Para realizar qualquer ação ou consulta no Personio (ação de saída): Certifique-se de que a conta usada para autorização tenha permissão para realizar a ação desejada.

Configuração de autorização

• Faça login no ADManager Plus e navegue até a guia Automação.
• No painel esquerdo, em Configuração, clique em Integrações de Aplicações.
• Em Aplicações Corporativas, clique em Personio.
• Ative o botão Ativar Integração com o Personio.
• Na página Configuração do Personio, clique em Autorização.
• Insira os valores de client_id e client_secret gerados no Personio nos respectivos campos.
• Clique em Definir.

Configuração de webhook de entrada

Webhooks de entrada permitem que você busque dados do usuário do Personio e os envie para o ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como fonte de dados durante a configuração da automação para realizar a ação desejada na lista de usuários recebida da resposta da API. Para configurar um webhook de entrada para o Personio:

• Em Webhook de entrada, clique em Configuração de endpoint do Personio.
• Na guia Configuração de endpoint, um ENDPOINT DE USUÁRIOS do Personio vem pré-configurado com campos de URL de endpoint, Método da API, Cabeçalhos e Parâmetros para buscar contas de usuário no Personio. No entanto, se você quiser usar um novo endpoint para importar usuários, é possível configurar um usando o botão + Adicionar endpoint de API e preenchendo os campos obrigatórios de acordo com a documentação da API do Personio. Clique aqui para saber como.

  Nota:

  • O par de valores de chave da API é pré-configurado como um cabeçalho para autenticar solicitações de API conforme definido durante a configuração da autorização.
  • Macros: Você pode adicionar macros à sua configuração de endpoint para alterá-la dinamicamente de acordo com suas necessidades usando o componente de seleção de macros..
  •  
  • Consulte a documentação da API do Personio e configure cabeçalhos e parâmetros adicionais, se necessário.
• Ao terminar, clique em Testar e Salvar. Uma janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos usando a chamada da API. Clique em Prosseguir.

  Nota:

  • Consulte a documentação da API do Personio para aprender sobre os parâmetros que devem ser configurados para buscar somente parâmetros específicos.
  • Você pode configurar múltiplos endpoints para o Personio usando o botão + Adicionar endpoint da API. Clique aqui para saber como.
• Clique em Fonte de Dados - Mapeamento de Atributos de LDAP para combinar os endpoints e mapear os atributos de LDAP do AD com os respectivos atributos no Personio.

  [O ADManager Plus também permite que você personalize o formato do atributo a partir do Personio.]

• Clique em + Adicionar nova configuração e execute as seguintes ações:
  • Insira o Nome e a Descrição da configuração e selecione a Categoria de Automação no menu suspenso.
  • No campo Selecionar endpoint, selecione o endpoint desejado e uma chave primária que seja exclusiva a um usuário (por exemplo, employeeIdentifier).

    Nota: Quando vários endpoints são configurados, esse atributo deve conter o mesmo valor em todos eles.

  • No campo Mapeamento de Atributos, selecione o atributo no menu suspenso Nome do Atributo de LDAP e mapeie-o com a respectiva coluna no Personio.
  • Se você quiser criar um novo formato personalizado para ele, clique em Atributo de Mapeamento.
• Clique em Salvar.

Configuração de webhook de saída

Webhooks de saída permitem que você atualize as mudanças feitas no AD enviando as informações do ADManager Plus para o Personio, ou busque ou encaminhe os detalhes necessários a partir do Personio e sincronize-os com o AD. Para configurar um webhook de saída para o Personio:

• Em Webhook de saída, clique em Configuração de webhook do Personio.
• Clique em + Adicionar webhook.
• Insira um nome e uma descrição para esse webhook.
• Decida a ação a ser executada e consulte a documentação da API do Personio para obter os detalhes da API, como URL, cabeçalhos e parâmetros.
• No menu suspenso, selecione o método HTTP que permitirá que você execute a ação desejada no endpoint.
• Insira o URL do endpoint.
• Configure os Cabeçalhos, Parâmetros e o Tipo de mensagem no formato apropriado com base na chamada de API que você gostaria de realizar.
• Clique em Testar e Salvar.
• Em seguida, uma janela pop-up exibirá uma lista de usuários e grupos do AD para testar a chamada de API configurada. Selecione o usuário ou grupo desejado no qual essa solicitação de API deve ser testada e clique em OK. Ela fará uma chamada em tempo real para o URL do endpoint e os objetos selecionados serão modificados de acordo com a configuração.
• A resposta do webhook e os detalhes da solicitação serão então exibidos. Verifique o comportamento esperado da API e clique em Salvar.

(Navegue até a guia Gerenciamento > Gerenciamento avançado > Orquestração.)