# Jira on-premises ![Gerenciamento de serviços Jira no local](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/images/marketplace-jira-service-logo-24.png) ## Automatize workflows de identidade e acelere a resolução de tickets com a integração ADManager Plus—Jira. ITOM · Provisionamento de identidade · Gerenciamento de tickets ## Visão geral O Jira é uma renomada plataforma SaaS, reconhecida pelo seu software de gerenciamento de projetos e rastreamento de problemas em nuvem. Integrar o Jira ao ADManager Plus oferece às organizações uma solução eficiente e simplificada para gerenciar o ciclo de vida de usuários. Com essa integração, a sua empresa ganha uma solução ágil e descomplicada para gerenciar todo o ciclo de vida de usuários. ### Provisionamento de usuário automatizado Mantenha os dados dos usuários sempre sincronizados e atualizados em todas as plataformas, eliminando o gerenciamento de dados manual e reduzindo o risco de erros no gerenciamento de contas. ### Relatórios avançados Os recursos avançados de geração de relatórios e auditoria permitem que os administradores de TI monitorem as atividades dos usuários, acompanhem todas as alterações e criem relatórios de conformidade de forma eficiente. ## 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](https://docs.atlassian.com/software/jira/docs/api/REST/7.6.1/#api/2/issue-deleteIssue) 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. **Nota:** O ADManager Plus oferece um conjunto pré-configurado de APIs para efetuar as ações básicas da integração. Se a ação que você precisa não estiver disponível, consulte as referências de API das referências de API do Jira Service Management local para a configuração de webhooks de entrada/saída para executar as ações requeridas. ### 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](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) 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: 1. Em *Inbound Webhook*, clique em **Jira Service Management On-prem Endpoint Configuration**. 2. 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](https://docs.atlassian.com/software/jira/docs/api/REST/7.6.1/#api/2/issue-deleteIssue). Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) 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](https://docs.atlassian.com/software/jira/docs/api/REST/7.6.1/#api/2/issue-deleteIssue) e configure cabeçalhos e parâmetros adicionais, se necessário. 3. 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](https://docs.atlassian.com/software/jira/docs/api/REST/7.6.1/#api/2/issue-deleteIssue) 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](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como. 4. 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] 5. 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: 1. Em *Outbound Webhook*, clique em **Jira Service Management On-prem Webhook Configuration**. 2. Clique em **+ Add Webhook**. 3. Insira um nome e uma descrição para este webhook. 4. Decida sobre a ação que deve ser executada e consulte as [referências de API do Jira Service Management](https://docs.atlassian.com/software/jira/docs/api/REST/7.6.1/#api/2/issue-deleteIssue) para obter os detalhes de API, tais como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários. 5. Selecione, no menu suspenso, o método HTTP que permitirá executar a ação desejada no endpoint. 6. Insira a URL do endpoint. 7. Configure os **cabeçalhos**, os **parâmetros** e o **tipo de mensagem** no formato apropriado para a chamada de API desejada. 8. Clique em **Test and Save**. 9. 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. 10. Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em **Save**. **Nota:** Os webhooks configurados podem ser integrados aos [Modelos de orquestração](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html), possibilitando [automações agendadas](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) ou [acionadas por eventos](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) para executar consecutivamente uma sequência de ações em um grupo de usuários ou em um grupo de usuários ou em usuários individuais.