Configurar o Jira spoke para Jira Nuvem

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

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

    Antes de Iniciar

    • Solicitar uma assinatura de IntegrationHub
    • Ativar o spoke Jira
    • 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 autenticação básica

    Integre a instância [ ServiceNow e a instância do Cloud 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 da 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 do Jira Cloud.

    Procedimento

    1. Fazer login em Atlassian Início como administrador.
    2. Vá para 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 de configurações de conta enfatizada.
    3. Vá para Segurança.
    4. Na seção Token de API, selecione Criar e gerenciar tokens de API.
    5. Selecione 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 solicitações ServiceNow 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 o registro de alias de conexão e credencial padrão que é enviado junto com o spoke do Jira, clique em Exibir detalhes.
      • Para gerenciar mais de um registro de conexão do 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, o spoke do Jira 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 o 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 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 Minhas aplicações, 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 do app é 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 de cliente e Segredodo cliente.

      Copie os valores de Client ID e Client Secret.
    6. Clique em Permissões.
      1. Em Escopos clássicos, certifique-se de selecionar esses escopos.
        • manage: jira-configuration
        • gerenciar: jira-project
        • manage: jira-webhook
        • read: jira-work
        • leitura: jira-user
        • write: jira-work
      2. Em Escopos granulares, certifique-se de selecionar esses escopos.
        • excluir: sprint: jira-software
        • read:issue-details:jira
        • leitura: jql: jira
        • ler:sprint:jira-software
        • write:sprint:jira-software
      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 instância de nuvem Jira. Este valor é necessário durante a configuração do registro de conexão na 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 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 da aplicação OAuth na nuvem Jira.
      ID de cliente ID do 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 console do desenvolvedor Atlassian.
      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 do 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 do OAuth
      excluir: sprint: jira-software excluir: sprint: jira-software
      manage: jira-configuration manage: jira-configuration
      gerenciar: jira-project gerenciar: jira-project
      manage: jira-webhook manage: jira-webhook
      offline_access offline_access
      read:issue-details:jira read:issue-details:jira
      leitura: jira-user leitura: jira-user
      read: jira-work read: jira-work
      leitura: jql: jira leitura: jql: jira
      ler:sprint:jira-software ler:sprint:jira-software
      write: jira-work write: jira-work
      write:sprint:jira-software write:sprint:jira-software
    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, Perfil OAuth do Jira.
    8. Em Escopos de perfil de entidade OAuth, certifique-se de fornecer os mesmos escopos de entidade.
      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 credencial do spoke Jira. Por exemplo, Credencial OAuth da 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 esta 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 da conexão. Por exemplo, insira Jira Cloud OAuth Connection.
      Credencial Selecione o registro de credencial criado para o Jira. Por exemplo, selecione a credencial OAuth da nuvem do Jira.
      URL de conexão Insira a 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 esses valores.
      1. Insira o valor 2 para api_version.
      2. Insira a nuvem de valor 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 Jira OAuth.
    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 sua instância ServiceNow de que o token de atualização está disponível.