Ir para o conteudo principal
#jira

Autenticação OAuth

A autenticação OAuth permite ligar de forma segura o Jira Server ao Ducalis para uma integração perfeita. Utilize este método para importar itens, sincronizar prioridades e criar itens sem partilhar palavras-passe.

Após a ligação, pode:

Pré-requisitos

Necessita de acesso de administrador ao Jira Server para criar application links.

Ligar o Jira Server​

  1. No seu Board, clique em Connect (Ligar) no canto inferior esquerdo para abrir as definições de Sync (Sincronização).

    Localização do botão Connect no Board

  2. Clique em Connect Issue Tracker (Ligar Gestor de Itens).

    Botão Connect Issue Tracker nas definições de Sync

  3. Em Source (Origem), selecione Jira Server.

    Seleção de origem mostrando a opção Jira Server

  4. Clique em Connect Jira Server (Ligar Jira Server).

    Botão Connect Jira Server

Antes de prosseguir, crie um Application link no Jira Server. Isto liga os dois sistemas e permite ao Ducalis aceder aos seus dados do Jira de forma segura.

Esta configuração é feita uma vez—os acessos futuros são automáticos.

Endpoints de API utilizados​

O Ducalis acede a estes endpoints da API REST do Jira Server:

  • status
  • serverInfo
  • user/search
  • user
  • project
  • field
  • webhook/*
  • rest/webhooks/1.0/
  • issue/createmeta
  • search
  • issue/*
  • mypermissions
  • issuetype/project
  • project/*
  • issuetype
  • filter/favourite
  • filter/search

  1. No Jira Server, clique na ⚙️ roda dentada no canto superior direito.

  2. Selecione Applications (Aplicações) no menu pendente.

  3. Clique em Application links no menu lateral.

    Opção Application links na administração do Jira Server

  1. Introduza o URL do Ducalis: https://ducalis.io/

  2. Clique em Create New link (Criar Novo link).

    Campo de criação de novo link com URL

  3. Na janela Configure Application URL, clique em Continue (Continuar) (ignore a mensagem de aviso—o link é válido).

    Janela Configure Application URL

Preencher os detalhes da aplicação​

  1. Introduza Application name (Nome da aplicação): Ducalis (recomendado).

  2. Selecione Application Type (Tipo de aplicação): Generic Application (Aplicação Genérica).

  3. Marque Create incoming link (Criar link de entrada).

  4. Clique em Continue (Continuar).

    Formulário de detalhes da aplicação

  5. Copie a Consumer Key e a Public Key do separador do Ducalis e cole-as nos campos correspondentes.

    Campos Consumer Key e Public Key

  6. Introduza qualquer Consumer Name (Nome do Consumidor) (nome da sua empresa ou projeto).

  7. Clique em Continue (Continuar).

    Campo Consumer Name

O application link foi agora criado.

Copiar Base URL​

Antes de sair do Jira Server, copie o Base URL das definições da sua conta Jira. Irá colar isto no Ducalis.

Localização do Base URL nas definições do Jira Server

Concluir a ligação​

  1. Regresse ao Ducalis e cole o Base URL.

  2. Clique em Connect (Ligar).

    Campo Base URL na janela de ligação

  3. Clique em Allow (Permitir) para conceder permissão ao Ducalis para ler os seus dados do Jira.

    Janela de permissão OAuth

A sua integração está pronta. Escolha uma instância para importar itens.

Ecrã de seleção de instância

Interface do Jira Server 9+​

No Jira Server versão 9 e posteriores, a interface difere ligeiramente:

  1. Em Application Links, clique em Create Link (Criar Link).

    Botão Create Link no Jira Server 9+

  2. Selecione Atlassian Product (Produto Atlassian) e introduza https://ducalis.io/ como Application URL (URL da Aplicação).

    Seleção de Atlassian Product com campo Application URL

Continue com o formulário de detalhes da aplicação.

Remover integração​

Para desligar o Jira Server do Ducalis, consulte Remover uma integração de gestor de tarefas.

O que se segue​

Após a ligação, importe itens do Jira Server para começar a priorizar.

Ecrã de importação de itens
Atualizado: Esta semana