Como configurar uma integração local do Jira Service Management no ADManager Plus

Pré-requisitos

Certifique-se de fornecer autenticação básica (nome de usuário e senha) para recuperar as informações desejadas e executar tarefas no gerenciamento local do Jira Service. Observe também que a senha é o valor da chave de API gerado na instância do Jira.

Consulte as referências de API do Jira para mais detalhes.

Privilégios

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

Para executar qualquer ação ou consulta no Jira Service Management local (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.
• Clique em Application Integrations.
• No painel esquerdo, em Configuration, clique em Application Integrations.
• Em Enterprise Applications, clique em Jira Service Management On-prem.
• Ative o botão Enable Jira Service Management On-prem Integration.
• Na página Jira Service Management On-prem Configuration, clique em Authorization.
• Escolha Basic authentication como o tipo de autorização para a integração do API.
• Insira as credenciais Username e Password.
• Clique em Configure.

Configuração de webhook de entrada

O webhook de entrada permite ao ADManager Plus obter dados de usuários diretamente do Jira Service Management local do ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como fonte de dados durante a configuração de automações para executar a ação desejada na lista de usuários retornada pela resposta da API. Para configurar um webhook de entrada para o Jira Service Management:

• Em Inbound Webhook, clique em Jira Service Management On-prem Endpoint Configuration.
• Na guia Endpoint Configuration, você encontrará um endpoint pré-configurado (o USERS ENDPOINT do Gerenciamento de serviços Jira no local) para os campos URL do endpoint, Método de API, Cabeçalhos e Parâmetros para obter contas de usuário do Jira Service Management. Para usar esse endpoint pré-configurado, substitua {host} e {port} pelo nome de domínio da sua instância do Jira Service Management local no campo Endpoint URL. No entanto, se desejar usar um novo endpoint para importar usuários, clique em + Add API endpoint e preencha os campos obrigatórios conforme as referências de API do Jira Service Management. Clique 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: Você pode adicionar macros à configuração do seu endpoint para dinamicamente
• Consulte as referências de API do Jira Service Management e configure cabeçalhos e parâmetros adicionais, 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. Clique em Proceed.

Nota:

• Consulte as referências de API do Jira Service Management para saber os parâmetros que devem ser configurados para obter apenas parâmetros específicos.
• Você pode configurar diversos endpoints para o Jira Service Management 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 Jira Service Management.

[O ADManager Plus também permite que você personalize o formato de atributo do Jira Service Management local]

• 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, selecione o endpoint desejado e uma Chave primária exclusiva a cada usuário (por exemplo, employeeIdentifier).
  Nota: Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles.
  • No campo Attribute Mapping, selecione o atributo no menu suspenso LDAP Attribute Name e mapeie-o com a respectiva coluna no Jira Service Management.
  • Se quiser criar um formato personalizado, clique em Mapping Attribute.
  • Clique em Save.

Configuração de webhook de saída

O webhook de saída permite que você atualize as alterações feitas no Active Directory (AD) usando o ADManager Plus para o Jira Service Management ou busque ou encaminhe os detalhes necessários do Jira Service Management e os sincronize com o AD.

Para configurar um webhook de saída para o Jira Service Management local:

• Em Outbound Webhook, clique em Jira Service Management On-prem Webhook Configuration.
• Clique em + Add Webhook.
• Insira um nome e uma descrição para este webhook.
• Decida sobre a ação que deve ser executada e consulte as referências de API do Jira Service Management para obter os detalhes de API, tais como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários.
• 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, os 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 Save.