Configurar o Jira spoke para a nuvem Jira

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 7 min. de leitura

    • Integre sua ServiceNow instância com a Jira instância de nuvem para autenticar as solicitações de ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub
    • Ativar o Jira spoke
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode configurar o spoke Jira para sua instância de nuvem Jira usando a autenticação básica ou a autenticação OAuth de acordo com seus requisitos.

    Opção 1: usando a autenticação básica

    Integre a instância [ ServiceNow e a instância de nuvem Jira usando uma chave de API para autenticar solicitações ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode integrar uma instância ServiceNow com várias instâncias Jira. Para esta integração, crie um registro de alias de conexão e credencial e um registro de conexão para cada instância Jira.

    Gerar um token de API de conta do Atlassian

    Gere um token de API de conta Atlassian para autenticar solicitações de spokes associados a uma conta Atlassian.

    Antes de Iniciar

    Verifique se você tem uma conta Atlassian.

    Função necessária: Atlassian credenciais de administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Conclua essas etapas na sua conta Atlassian. Consulte a documentação do portal Atlassian Developer para obter instruções sobre como gerar seu token de API.
    Nota:
    Este procedimento é aplicável somente se vocêestiver [ usando a assinatura JIRA Cloud.

    Procedimento

    1. Fazer login em Atlassian Iniciar como administrador.
    2. Acesse a foto de perfil da sua conta e selecione Configurações da conta.
      Página inicial do Atlassian com o menu suspenso da imagem de perfil selecionada. Opção Configurações de conta enfatizada.
    3. Acesse Segurança.
    4. Na seção Token de API, selecione Criar e gerenciar tokens de API.
    5. Selecione o token de API.
    6. No formulário, forneça um nome de integração para o campo Rótulo.
    7. Selecione Criar.
      O modal Criar um token de API com o botão Criar enfatizado.
      O token de API é gerado.
    8. Selecione Copiar e registre o valor do token de API para uso posterior.
      Modal de confirmação do seu novo token de API com o botão Copiar enfatizado.

    O que Fazer Depois

    Use o token de API para configurar a conexão em nuvem para um spoke do Jira ou do Jira Service Management.

    Configurar uma conexão para o spoke do JIRA

    Adicione e configure uma conexão do Jira para autenticar ServiceNow solicitações no spoke do Jira.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Automação de Processo > Flow Designer.
    2. Clique na guia Conexões.
    3. Localize o alias de conexão do Jira e clique em Exibir detalhes.
      • Para configurar a conexão padrão e o registro de alias de credencial que é enviado junto com o spoke do Jira, clique em Exibir detalhes.
      • Para gerenciar mais de um registro de conexão de spoke do JIRA, você deve criar um novo registro de alias secundário clicando em Adicionar conexão. Para obter mais informações sobre como usar várias conexões, consulte Suporte a várias conexões.
      Se você estiver configurando o spoke pela primeira vez, clique em Configurar. Caso contrário, clique em Editar.
    4. No formulário Conexão, preencha os campos.
      Campo Descrição
      Nome da conexão Nome de identificação exclusiva da conexão. Por exemplo, JIRA Spoke Cloud Basic Conn.
      URL de Conexão URL da sua instância do Jira neste formato: https://<provider-domain-name> .atlassian.net .
      Tipo de servidor Selecione nuvem.
      Nome de usuário Insira o endereço de e-mail do usuário.
      Chave de API Insira o token de API que você gerou para sua instância do Jira Cloud.

      Configuração de conexão para Jira Cloud.

    5. Clique em Criar Conexão.

    Opção 2: usando a autenticação OAuth

    Integre a instância ServiceNow à sua conta Jira usando o OAuth para autenticar ServiceNow solicitações.

    Antes de Iniciar

    Função necessária: administrador

    Criar uma integração OAuth 2.0 na conta Jira

    Crie uma integração OAuth 2.0 no console do desenvolvedor Atlassian para autenticar as solicitações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Fazer login em Atlassian Console do desenvolvedor como administrador.
    2. Em Meus apps, clique em Criar e selecione Integração OAuth 2.0.
      Crie uma integração OAuth 2.0.
    3. No formulário, forneça o nome da integração e clique em Criar.
      Forneça o nome da integração.
      A integração é criada e o valor do ID da aplicação é exibido.
    4. Clique em Autorização.
      1. Clique em Adicionar em Ação.
        Autorização para acessar APIs.
      2. Em URL de retornode chamada , forneça a URL da sua instância ServiceNow neste formato: https://<ServiceNow-Instance-Name> .service-now.com/oauth_redirect.do .
        Por exemplo, https://example.service-now.com/oauth_redirect.do
        Adicionar URL de retorno de chamada.
      3. Clique em Salvar mudanças.
    5. Clique em “Configurações”.

      Em Detalhes da autenticação, copie os valores de ID do cliente e Segredodo cliente.

      Copie os valores de ID de cliente e Segredodo cliente .
    6. Clique em Permissões.
      1. Em Escopos clássicos, certifique-se de selecionar esses escopos.
        • gerenciar: jira-configuration
        • gerenciar: jira-project
        • gerenciar: jira-webhook
        • leitura: jira-work
        • leitura: jira-user
        • gravação: jira-work
      2. Em Escopos granulares, certifique-se de selecionar esses escopos.
        • excluir: sprint: jira-software
        • leitura: detalhes do problema: jira
        • leitura: jql: jira
        • leitura:sprint:jira-software
        • write:sprint:jira-software
        • leitura:board-scope:jira-software
        • leitura:projeto:jira
      Você pode configurar outros escopos de acordo com seus requisitos.

    Obter o valor do ID da nuvem

    Obtenha o valor do ID de nuvem da Jira instância de nuvem. Este valor é necessário durante a configuração do registro de conexão em sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Fazer login em Atlassian Administração como administrador.
    2. Clique em Selecionar na organização necessária.
    3. No produto JIRA Software, clique em Gerenciar acesso ao produto.
      Uma nova janela é aberta e o URL está neste formato: https://admin.atlassian.com/s/<Cloud-ID> /apps .
    4. Copie o valor do ID da nuvem para uso posterior.

    Criar um registro de aplicação na instância ServiceNow

    Use as informações geradas ao criar a integração do OAuth 2.0 para criar um registro de aplicação em sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de aplicação OAuth?.
    3. Selecione Conectar-se a um provedor OAuth de terceiros.
    4. No formulário, preencha estes valores.
      Campo Descrição
      Nome Nome para identificar o registro da aplicação. Por exemplo, registro do app OAuth na nuvem Jira.
      ID de cliente ID de cliente gerado quando a integração do OAuth 2.0 foi criada no Atlassian Console do desenvolvedor.
      Segredo do cliente Segredo do cliente gerado quando a integração do OAuth 2.0 foi criada no Atlassian Console do desenvolvedor.
      Tipo de concessão padrão Tipo de concessão usado para estabelecer o token. Selecione Código de autorização.
      URL de Autorização Endpoint do código de autorização do OAuth. Insira: https://auth.atlassian.com/authorize.
      URL de Token Endpoint do token do servidor OAuth. Insira: https://auth.atlassian.com/oauth/token.
      URL de redirecionamento Endpoint de retorno de chamada do OAuth. O sistema gera o URL ao salvar o registro da aplicação.
      Atualizar URL do Token URL para atualizar um token. Insira: https://auth.atlassian.com/oauth/token.
      Nota:
      Este campo está oculto no layout do formulário. Configure o layout do formulário para mostrar este campo.
    5. Na guia Escopos de Entidade OAuth, crie esses registros de escopo de entidade.
      Nome Escopo de OAuth
      excluir: sprint: jira-software excluir: sprint: jira-software
      gerenciar: jira-configuration gerenciar: jira-configuration
      gerenciar: jira-project gerenciar: jira-project
      gerenciar: jira-webhook gerenciar: jira-webhook
      offline_access offline_access
      leitura: detalhes do problema: jira leitura: detalhes do problema: jira
      leitura: jira-user leitura: jira-user
      leitura: jira-work leitura: jira-work
      leitura: jql: jira leitura: jql: jira
      leitura:sprint:jira-software leitura:sprint:jira-software
      gravação: jira-work gravação: jira-work
      write:sprint:jira-software write:sprint:jira-software
      leitura:board-scope:jira-software leitura:board-scope:jira-software
      leitura:projeto:jira leitura:projeto:jira
    6. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    7. Clique na guia Perfis de entidade OAuth e abra o registro padrão.
      Por exemplo, Jira OAuth Profile.
    8. Em Escopos de Perfil de Entidade OAuth, certifique-se de que os mesmos escopos de entidade sejam fornecidos.
      Caso contrário, insira novas linhas e selecione os mesmos escopos de entidade fornecidos anteriormente na guia Escopos de entidade OAuth.
    9. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

    Criar registro de credencial para o spoke Jira

    Crie um registro de credencial para a conta Jira. O alias de conexão e credencial do spoke Jira usa essa credencial para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar?
    3. Selecione Credenciais OAuth 2.0.
    4. No formulário, preencha estes valores.
      Campo Descrição
      Nome Nome para identificar o registro de credenciais do spoke Jira. Por exemplo, credencial do OAuth na nuvem do Jira.
      Perfil de Entidade OAuth Registro de perfil de entidade OAuth padrão criado quando o registro da aplicação é configurado.
    5. Clique em Enviar.

    Criar um registro de conexão para o spoke Jira

    Crie um registro de conexão para a conta Jira. O alias de conexão e credencial usa essa conexão para executar ações em Jira.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Abra o registro de alias para Jira que foi enviado com o spoke.
    3. Na guia Conexões, clique em Novo.
      O sistema exibe um formulário de conexão HTTP(s) em branco.
    4. Insira esses valores e clique em Enviar.
      Campo Valor necessário
      Nome Insira qualquer nome para identificar exclusivamente o registro de conexão. Por exemplo, insira Jira Cloud OAuth Conexão.
      Credenciais Selecione o registro de credencial criado para o JIRA. Por exemplo, selecione a credencial do OAuth na nuvem do Jira.
      URL de Conexão Insira o URL da sua instância do Jira neste formato: https://api.atlassian.com/ex/jira/<Cloud-ID> .

      Para obter informações sobre como obter o valor do Cloud ID, consulte Obter o valor do ID da nuvem.
    5. Na lista relacionada Atributos, forneça estes valores.
      1. Insira o valor 2 para api_version.
      2. Insira a nuvem de valores para server_type.
      Valores de atributo.
    6. Clique em Enviar.
    7. Navegar até Todos > Conexões e Credenciais > Credenciais.
    8. Abra o registro de credencial que você criou para o spoke Jira.
      Por exemplo, credencial do OAuth do Jira.
    9. Clique no link relacionado Obter token OAuth.
      Em uma nova janela, o sistema solicita acesso à sua conta Atlassian.
    10. Clique em Aceitar.
      O acesso é concedido à conta Atlassian e uma mensagem de confirmação é exibida na instância ServiceNow de que o token de atualização está disponível.