# Jira Service Management ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/marketplace-jiraservicemanagement-logo-24.png) ## Integre o Jira ao ADManager Plus para simplificar o gerenciamento do ciclo de vida de usuários **Provisionamento de identidade** **Gerenciamento de tickets** 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. ## Configuração A configuração do Jira Service Management com o ADManager Plus inclui as etapas a seguir. ## Nota: 1. Se os dados necessários já estiverem presentes no ticket ou na solicitação do Jira Service Management, você pode pular as etapas 1 e 2. 2. A autenticação pode ser feita via OAuth ou autenticação básica. - Crie campos personalizados a serem incluídos no formulário. - Monte o formulário no Jira Service Management. - Gere a chave de API no Jira Service Management. - No Postman, configure o endpoint do Jira Service Management e recupere os parâmetros de resposta dos campos personalizados necessários. - Configure o endpoint no ADManager Plus. ## Etapas para criar campos personalizados no Jira Service Management Crie um campo personalizado e associe-o ao formulário correspondente no Jira Service Management. 1. Faça login no portal do Jira Service Management. 2. Clique em **Projects** e selecione o seu projeto. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-01.png) 3. No canto superior direito, abra o ícone **Settings** e escolha **Issues**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-02.png) 4. No painel à esquerda, acesse **Custom fields**, e selecione **Create custom field** no canto superior direito. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-03.png) 5. Selecione o **Field Type** desejado. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-04.png) 6. Informe o **Name** e a **Description** do campo e clique em **Create**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-05.png) 7. Marque as telas em que o campo deve ser exibido e clique em **Update**. 8. Repita o procedimento para cada campo adicional. ## Etapas para criar um formulário no Jira Service Management Crie um formulário no Jira para agilizar a abertura de tickets de onboarding de usuários. 1. Navegue até o Dashboard do Jira Service Management. 2. No painel à esquerda, clique em **Project settings > Forms**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-06.png) ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-07.png) 3. Selecione **Project settings > Forms** e clique em **Create blank**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-08.png) 4. Clique em **Add field** e selecione o tipo de campo desejado. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-09.png) 5. No painel de detalhes à direita, preencha as informações necessárias e associe o campo de formulário ao respectivo campo personalizado. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-10.png) 6. Repita este procedimento para todos os campos que desejar incluir. **Nota:** - Descrição é um campo obrigatório em formulários do Jira Service Management. - Crie um campo de formulário e vincule-o ao campo associado em **Linked Jira Field**. 7. Depois de adicionar os campos necessários, clique em **Save Changes**. 8. Selecione **Settings** no canto superior esquerdo. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-11.png) 9. Ative **Create new issue** e selecione o tipo de solicitação desejado no menu suspenso. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-12.png) 10. Clique em **Save Changes** e você encontrará o link para o formulário abaixo do tipo de solicitação. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-13.png) 11. Quando esse formulário for enviado, um novo ticket será criado. ## Etapas para configurar o token de API no Jira Service Management 1. Faça login no portal do Jira Service Management. 2. Selecione a foto do perfil no canto superior direito e clique em **Manage account**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-14.png) 3. Navegue até a guia **Security** e selecione **Create and manage API tokens**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-15.png) 4. Clique em **Create API token**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-16.png) 5. Insira um nome para o token em *Label* e clique em **Create**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-17.png) 6. Selecione **Copiar** para copiar o token de API. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-18.png) ## Etapas para configurar a aplicação OAuth no Jira Service Management Autentique-se no ADManager Plus e obtenha os tokens necessários para acesso seguro às informações de tickets. 1. Navegue até **Jira API documentation (developer.atlassian.com) > Profile > Developer console**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-19.png) 2. Selecione **Create** e escolha **OAuth 2.0 integration**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-20.png) 3. Insira um nome para a aplicação e marque a caixa de termos e condições. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-21.png) 4. Clique em **Create**. ## Etapas para definir permissões no Jira Service Management Permita que o ADManager Plus consulte os tickets, garantindo acesso e gerenciamento eficientes das informações relevantes. 1. Navegue até **Jira API documentation (developer.atlassian.com) > Profile > Developer console**. 2. Selecione **My apps** e escolha ADManager Plus. 3. No painel à esquerda, escolha **Permissions**. 4. Clique em **Configure** ao lado de Jira API. 5. Selecione Edit Scopes, marque read:jira-work e clique em **Save**. 6. Vá para a guia **Granular scopes tab** e clique em **Edit Scopes**. 7. Pesquise pelos escopos read:issue-details:jira e read:issue:jira, marque-os e clique em **Save**. - read:issue-details:jira - read:issue:jira ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-22.png) ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-23.png) ## Etapas para gerar o ID do cliente e o Segredo no Jira Service Management Autentique-se no ADManager Plus, aprimorando as capacidades de integração e garantindo acesso seguro às funções de RH e gerenciamento de identidade. 1. Navegue até **Jira API documentation (developer.atlassian.com) > Profile > Developer console**. 2. Selecione **My apps** e escolha ADManager Plus. 3. No painel à esquerda, escolha **Settings**. 4. Copie o Client ID e o Secret e cole-os nos campos correspondentes. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-24.png) ## Etapas para definir a URL de resposta no Jira Service Management Configure o Jira Service Management para enviar o token de acesso ao ADManager Plus, garantindo a integração entre ambos os sistemas. 1. Navegue até **Jira api documentation (developer.atlassian.com) > Profile > Developer console**. 2. Selecione **My apps** e escolha ADManager Plus. 3. No painel à esquerda, escolha **Authorization**. 4. Cole a URL de retorno do ADManager Plus no *campo Callback URL*. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-25.png) ## Etapas para configurar endpoints do Jira Service Management no Postman Obtenha o ID de nuvem e o nome do campo personalizado e mapeie-os para os atributos LDAP correspondentes, garantindo sincronização eficiente e consistência de dados entre os sistemas. - **Faça login usando Autenticação básica como tipo de autenticação** 1. Acesse o Postman ([https://www.postman.com](https://www.postman.com)). 2. Em *Type*, selecione **Basic Auth**. 3. Insira seu **Username** (endereço de e-mail) e cole o token de API gerado no campo **Password**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-26.png) - **Faça login usando OAuth como tipo de autenticação** 1. Acesse o Postman ([https://www.postman.com](https://www.postman.com)). 2. Preencha todos os parâmetros exigidos e clique em **Get New Access Token**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-27.png) 3. Ao clicar em **Get New Access Token**, você será redirecionado para a página de login do Jira Service Management. 4. Faça login com suas credenciais do Jira Service Management e conclua a autenticação. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-28.png) 5. Após a autenticação bem-sucedida, o servidor retornará o código de status HTTP 200, indicando que as credenciais são válidas. A resposta incluirá o token de acesso, seu prazo de expiração e, se o parâmetro offline_access estiver habilitado, um token de atualização. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-29.png) 6. Envie uma solicitação HTTP para o seguinte endpoint e obtenha o ID de nuvem: [https://api.atlassian.com/oauth/token/accessible-resources](https://api.atlassian.com/oauth/token/accessible-resources) ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-30.png) 7. Use o ID de nuvem obtido na etapa anterior para recuperar os IDs dos campos personalizados, configurando o endpoint abaixo e incluindo a JQL como parâmetro: [https://api.atlassian.com/ex/jira/{cloudid}/rest/api/3/search](https://api.atlassian.com/ex/jira/%7Bcloudid%7D/rest/api/3/search) **Nota:** O parâmetro JQL pode ser ajustado para filtrar tickets ou solicitações por status, tipo ou outros critérios. Para mais detalhes, clique [AQUI](https://support.atlassian.com/jira-software-cloud/docs/jql-fields/). ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-31.png) 8. Pesquise os IDs de campos personalizados na resposta e extraia o valor necessário para o mapeamento de atributos. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-32.png) ## Etapas para configurar a autorização no ADManager Plus 1. No ADManager Plus, navegue até a guia **Automation** e clique em **Applications Integrations**. 2. Em Enterprise Applications, clique em **Jira Service Management**. 3. Na seção **Authorization**, escolha o **Authorization Type** no menu suspenso. - Se selecionar OAuth 2.0 como o tipo de autorização: - **Client ID and Client Secret:** Insira um ID válido e a chave secreta gerada no portal do Jira Service Management. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-33.png) - Se optar pela Autenticação básica: - Informe o **Nome de usuário** e **Senha** e clique em **Configure**. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-34.png) ## Etapas para configurar endpoints no ADManager Plus 1. No ADManager Plus, navegue até a guia **Automation** e clique em **Applications Integrations**. 2. Em Enterprise Applications, clique em **Jira Service Management**. 3. Na seção **Jira Service Management Endpoint Configuration**, substitua {cloudid} pelo ID exclusivo gerado na sua instância do Jira Service Management. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-35.png) **Nota:** O parâmetro JQL pode ser ajustado para filtrar tickets ou solicitações por status, tipo ou outros critérios. Para mais detalhes, clique [AQUI](https://support.atlassian.com/jira-software-cloud/docs/jql-fields/). ## Etapas para configurar o Mapeamento de atributos LDAP no ADManager Plus 1. No ADManager Plus, navegue até a guia **Automation** e clique em **Applications Integrations**. 2. Em Enterprise Applications, clique em **Jira Service Management**. 3. Clique em **Data Source - LDAP Attribute Mapping** para vincular endpoints e mapear atributos LDAP do AD aos atributos correspondentes no Jira Service Management. 4. Insira o **Nome da configuração** e a **Descrição**, e selecione a **Categoria de automação** no menu suspenso. 5. No campo **Select Endpoint**, marque **JIRA ISSUES ENDPOINT** e selecione **issues.id** no menu suspenso. ![Jira Service Management](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/jira-service-management-active-directory-integration-with-admanager-plus-36.png) 6. No campo **JIRA ISSUES ENDPOINT**, selecione o atributo **LDAP Attribute Name** no menu suspenso e associe-o à coluna correspondente no Jira Service Management. 7. Clique em **Save**.