Como configurar a integração SAP SuccessFactors no ADManager Plus

Documento de configuração: Integrando o SAP SuccessFactors ao ADManager Plus

Pré-requisitos:

O SAP SuccessFactors utiliza chaves de API para autorizar solicitações.

Privilégios:

Importar usuários (ação de entrada): A conta/chave de API deve ter permissão para ler todas as contas de usuário.

Para executar qualquer ação ou consulta no SAP SuccessFactors (ação de saída): A conta usada deve ter permissão para realizar a ação desejada.

Configuração de autorização

• Faça login no ADManager Plus e acesse Directory/Application Settings.
• Em Application Integrations, localize e selecione SAP SuccessFactors.
• Ative a opção habilitar integração SAP SuccessFactors.
• Na página de configuração do SAP SuccessFactors, clique em Authorization..
• Copie o valor da chave x-api-key do seu ambiente SuccessFactors e cole no campo Value.
• Clique em Configure

Configuração de webhook de entrada

O webhook de entrada permite ao ADManager Plus obter dados de usuários diretamente do SAP SuccessFactors. O mapeamento de atributos definido aqui poderá ser selecionado como fonte de dados ao configurar automatizações. Para configurar um webhook de entrada para o SAP SuccessFactors:

• Em Inbound Webhook, clique em SAP SuccessFactors Endpoint Configuration..
• Na aba Endpoint Configuration você encontrará o endpoint pré-configurado ENDPOINT DE USUÁRIOS SAP, SuccessFactors, com campos para a URL do endpoint, Método de API, Cabeçalhos, e Parâmetros Para usar este endpoint, substitua "Yourhost" pelo subdomínio da sua instância SuccessFactors. No entanto, se desejar usar um novo endpoint para importar usuários, clique em + Add API endpoint e preencha os campos obrigatórios Clique as referências de API do SAP SuccessFactors. Click aqui para saber como.

Nota:

• O par chave-valor da API já vem pré-configurado como cabeçalho para autenticar as solicitações de API, conforme definido durante a Configuração de Autorização.
• Macros: Utilize macros para ajustar dinamicamente o endpoint conforme sua necessidade.
• Consulte as referências de API do SAP SuccessFactors e configure cabeçalhos ou parâmetros, se necessário.
• Após concluir, clique em Test & Save. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Após verificar se os parâmetros desejados foram retornados, clique em Proceed.

Nota:

• Consulte as referências de API do SAP SuccessFactors para verificar quais parâmetros configurar e retornar apenas os dados desejados.
• Você pode criar quantos endpoints forem necessários usando o botão + Add API endpoint . Clique aqui para saber como.
• Clique em Data Source - LDAP Attribute Mapping para vincular endpoints e mapear atributos LDAP do AD aos atributos correspondentes no SAP SuccessFactors.
• Clique em + Add New Configuration e faça o seguinte:
  • Insira o Nome da configuração e a Descrição e selecione a Categoria de automação no menu suspenso.
  • No campo Select Endpoint escolha o endpoint desejado e defina uma Chave primária única para o usuário (por exemplo, employeeIdentifier).
  Nota: Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles.
  • In the Attribute Mapping selecione o atributo LDAP Attribute Name no menu suspenso e associe-o à coluna correspondente no SAP SuccessFactors.
  • Se quiser criar um formato personalizado, clique em Add New Format.
  • Clique em Save.
• Configure uma automaçã informando a ação desejada, a frequência de repetição e mapeamento de atributos criado acima.

Configuração de webhook de saída

O webhook de saída permite atualizar no SAP SuccessFactors as alterações feitas no AD via ADManager Plus e sincronizá-las com o AD. Para configurar um webhook de saída para o SAP SuccessFactors:

• Em Outbound Webhook, clique em SAP SuccessFactors Webhook Configuration.
• Clique em + Add Webhook.
• Insira um nome e uma descrição para este webhook.
• Defina a ação a ser executada e consulte as referências de API do SAP SuccessFactors para obter detalhes como URL, cabeçalhos, parâmetros e demais requisitos.
• Selecione, no menu suspenso, o método HTTP que permitirá executar a ação desejada no endpoint.
• Insira a URL do endpoint.
• Configure os Cabeçalhos, Parâmetros e o Tipo de mensagem no formato apropriado para a chamada de API desejada.
• Clique em Test and Save.
• 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 para testar a chamada de API e clique em OK. Isso enviará uma solicitação em tempo real para a URL do endpoint e aplicará as modificações configuradas aos objetos selecionados.
• Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em Salve.
• Os webhooks configurados podem ser incorporados a Modelos de Orquestraçãopermitindo automações agendadas ou acionadas por eventos—para que a ação definida no webhook de saída seja executada sequencialmente em um grupo de usuários ou em usuários individuais.
Nota: use macros para enviar os dados do objeto no qual o webhook é executado.