Configuração

Introdução

Para se conectar ao Jira usando esse pacote de atividades, você deve primeiro criar as credenciais exigidas pelo Escopo do Jira para autenticar todas as chamadas subsequentes. Atualmente, o escopo oferece suporte a dois tipos de autenticação:

• Token de API: um token de autenticação é gerado pelo Jira para seu usuário. Este método é compatível com automações totalmente Não Unattended .
• OAuth 2.0: um ID e um segredo do cliente são gerados pelo Jira e podem ser usados para todos os usuários dentro de uma organização. Este método exibe, no Runtime, uma tela de login na qual um usuário pode inserir suas credenciais de login para o Jira ou qualquer um de seus provedores de SSO. Um token é produzido e salvo localmente. Esse token tem duração curta e pode precisar ser atualizado posteriormente. Por esse motivo, esse método é compatível com Attended e algumas automações Unattended .

Please follow the steps below to prepare a set of credentials for your activities.

Credenciais

Option 1: API Token

1. Siga as instruções do Atlassian aqui para gerar um token de API.
2. Adicione um Escopo do Jira ao seu fluxo de trabalho e altere o parâmetro Tipo de Autenticação para Api Token.
3. Preencha a propriedade URL do servidor com a URL da instância do Jira da sua organização. Para instâncias do Cloud, isso geralmente está na forma de https://<your org>.atlassian.net.
4. Por fim, preencha a propriedade Api Token com o token gerado na etapa 1 e a propriedade Nome de usuário com o e-mail usado para fazer login na instância designada do Jira. O Escopo do Jira agora está pronto para uso.

Option 2: OAuth 2.0

1. Siga as instruções do Atlassian aqui em Como habilitar o OAuth 2.0 (3LO), crie um novo "aplicativo".

   
   

   

   
   
2. Em APIS E FUNCIONALIDADES, selecione OAuth 2.0 (3LO). Insira http://127.0.0.1:10001/authorize/ no campo URL de retorno de chamada. Isso instrui o aplicativo Jira a retornar à máquina que executa as atividades após terminar a autenticação de um usuário.
   
   

   

   
   

3. Em APIS E RECURSOS , selecione Adicionar para dar acesso ao aplicativo às APIs do Atlassian. Selecione o botão Adicionar na API REST da plataforma Jira.

   
   

   

   
   
4. O botão Adicionar será substituído por um que diz Configurar. Clique aqui para escolher as permissões dadas ao aplicativo. Adicione read:jira-work, manage:jira-project, manage:jira-configuration, read:jira-user, e write:jira-work.
   
   

   

   
   
   
   

   

   
   

5. Navegue de volta para Detalhes do aplicativo e copie seu ID e segredo do cliente. Elas agora podem ser usadas em um fluxo de trabalho.

   
   

   

   
   
6. Adicione um Escopo do Jira ao seu fluxo de trabalho e altere o parâmetro Tipo de Autenticação para OAuth 2.0.
7. Preencha a propriedade URL do servidor com a URL da instância do Jira da sua organização. Para instâncias do Cloud, isso geralmente está na forma de https://<your org>.atlassian.net.

8. Por fim, preencha as propriedades ID do Cliente e Segredo do Cliente com os valores copiados na etapa 5. O Escopo do Jira agora está pronto para uso.

   Para transformar o tipo de variável de String em SecureString, no parâmetro padrão para o SegredoDoCliente, é possível usar esse comando:

   (new System.Net.NetworkCredential("","*YOUR_SECRET*")).SecurePassword

   
   

   

   
   
9. Se você seguir as etapas acima no Studio e receber a mensagem de erro RemoteException wrapping System.Net.HttpListenerException: The network location cannot be reached. For information about network troubleshooting, see Windows Help ao tentar executar o escopo do Jira, a solução é abrir um cmd.exe como Administrator e executar este comando:

   netsh http add iplisten ipaddress=127.0.0.1

   
   

   

   
   

10. Após a primeira execução do Escopo do Jira, você recebe uma janela de solicitação de autorização em seu navegador padrão onde precisa especificar o site do Jira e clicar em Aceitar.