Integrazione con Atlassian Jira Cloud - Amazon Quick
Prima di iniziareConfigura l'Atlassian Developer ConsoleConfigura l'integrazione in Amazon QuickOperazioni disponibiliGestisci e risolvi i problemi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Integrazione con Atlassian Jira Cloud

Usa il connettore di azione Atlassian Jira Cloud per creare, aggiornare, cercare e gestire problemi, progetti, sprint e utenti di Jira direttamente in Amazon Quick tramite linguaggio naturale.

La configurazione di questa integrazione prevede due passaggi. Innanzitutto, crei un'app OAuth 2.0 (3LO) nell'Atlassian Developer Console e ne configuri le autorizzazioni. Quindi, crei l'integrazione in Amazon Quick e la connetti alla tua app Atlassian. Per informazioni sui metodi di autenticazione supportati da Amazon Quick, consultaMetodi di autenticazione.

Prima di iniziare

Assicurati di disporre di quanto segue prima di configurare l'integrazione.

Configura l'Atlassian Developer Console

Se prevedi di utilizzare l'autenticazione utente (3LO), crea un'app OAuth 2.0 nell'Atlassian Developer Console prima di configurare Amazon Quick. Completa tutti i passaggi seguenti prima di passare alla console Amazon Quick.

Se prevedi di utilizzare solo l'autenticazione del servizio (chiave API), puoi saltare questa sezione e procedere Configura l'integrazione in Amazon Quick con.

Per ulteriori informazioni sulle app OAuth 2.0 (3LO), consulta le app OAuth 2.0 (3LO) nella documentazione per sviluppatori di Atlassian.

Crea un'app OAuth 2.0 (3LO)

Amazon Quick utilizza un'app Atlassian OAuth 2.0 (3LO) per autenticarsi con il tuo prodotto Atlassian Cloud per conto dei tuoi utenti. Crea questa app nell'Atlassian Developer Console prima di configurare Amazon Quick.

  1. Apri l'Atlassian Developer Console e accedi con il tuo account Atlassian.

  2. Scegli Crea, quindi scegli l'integrazione 2.0. OAuth

  3. Per Nome, inserisci un nome descrittivo per l'integrazione, ad esempioyour-app-name connector.

  4. Leggi e accetta i termini per gli sviluppatori di Atlassian.

  5. Scegli Create (Crea).

Configurazione delle autorizzazioni

Dopo aver creato l'app OAuth 2.0, aggiungi le autorizzazioni API di cui Amazon Quick ha bisogno per interagire con il tuo prodotto Atlassian.

  1. Dalla tua app nella Atlassian Developer Console, scegli Autorizzazioni nella barra di navigazione a sinistra.

  2. Trova l'API per il tuo prodotto Atlassian (ad esempio, Jira API o Confluence API) e scegli Aggiungi. Il pulsante cambia in Configura dopo l'aggiunta dell'API.

  3. Scegli Configura. La pagina degli ambiti si apre con le schede Ambiti classici e Ambiti granulari.

  4. Nella scheda Ambiti classici, scegli Modifica ambiti. Seleziona gli ambiti classici richiesti e scegli Salva.

  5. Scegli la scheda Ambiti granulari, quindi scegli Modifica ambiti. Seleziona gli ambiti granulari richiesti e scegli Salva.

Per gli ambiti specifici richiesti per l'integrazione, consulta la sezione sugli ambiti che segue.

Configura le autorizzazioni API

Aggiungi i seguenti ambiti alla tua app OAuth 2.0 per l'integrazione delle azioni di Jira Cloud.

Ambiti classici

Nella scheda Ambiti classici, scegli Modifica ambiti e seleziona i seguenti ambiti.

Integrazione con Jira Action: ambiti classici
Scope Description
read:jira-work Leggi i dati dei progetti e dei problemi di Jira, cerca i problemi e gli oggetti associati a problemi come allegati e registri di lavoro.
manage:jira-project Crea e modifica le impostazioni del progetto e crea nuovi oggetti a livello di progetto (ad esempio versioni e componenti).
manage:jira-configuration Intraprendi azioni amministrative con Jira (ad esempio, crea progetti e campi personalizzati, visualizza i flussi di lavoro, gestisci i tipi di link ai problemi).
read:jira-user Visualizza le informazioni sull'utente in Jira a cui l'utente ha accesso, inclusi nomi utente, indirizzi email e avatar.
write:jira-work Crea e modifica problemi in Jira, pubblica commenti come utente, crea registri di lavoro ed elimina problemi.
manage:jira-webhook Recupera, registra, aggiorna ed elimina i webhook Jira dichiarati dinamicamente.

Ambiti granulari

Scegli la scheda Ambiti granulari, quindi scegli Modifica ambiti. Utilizza la barra di ricerca per trovare gli ambiti di seguito. Ad esempio, cerca per trovare gli sprint:jira-software oscilloscopi relativi allo sprint.

Integrazione con Jira Action: ambiti granulari
Scope Description
read:board-scope:jira-software Leggi le configurazioni della scheda.
read:sprint:jira-software Leggi le informazioni sullo sprint.
write:sprint:jira-software Crea e modifica gli sprint.
delete:sprint:jira-software Eliminare gli sprint.
write:board-scope:jira-software Gestisci le configurazioni della scheda.
read:project:jira Leggi i dettagli del progetto.

Configurazione dell’autorizzazione

Imposta l'URL di callback in modo che Atlassian possa reindirizzare gli utenti ad Amazon Quick dopo aver autorizzato l'app.

  1. Dalla tua app nella Atlassian Developer Console, scegli Autorizzazione nella barra di navigazione a sinistra.

  2. Accanto a OAuth 2.0 (3LO), scegli Aggiungi.

  3. Per Callback URLs, inserisci. https://region.quicksight.aws.amazon.com/sn/oauthcallback Sostituisci region con la AWS regione in cui è distribuita l'istanza Amazon Quick, ad esempious-east-1.

  4. Scegli Save changes (Salva modifiche).

Registra le tue credenziali

Prima di uscire dall'Atlassian Developer Console, verifica di avere i seguenti valori. Ne hai bisogno per la configurazione di Amazon Quick.

  1. Dalla tua app nell'Atlassian Developer Console, scegli Impostazioni nella barra di navigazione a sinistra.

  2. In Dettagli di autenticazione, copia i valori Client ID e Secret.

Credenziali richieste dalla Atlassian Developer Console
Valore Dove trovarlo
ID client Pagina delle impostazioni, in Dettagli di autenticazione
Segreto Pagina delle impostazioni, in Dettagli di autenticazione

Configura l'integrazione in Amazon Quick

Dopo aver preparato le credenziali di autenticazione, crea l'integrazione in Amazon Quick.

  1. Nella console Amazon Quick, scegli Integrazioni.

  2. Scegli la scheda Azioni.

  3. In Configura una nuova integrazione di app per Actions, trova Atlassian Jira Cloud e scegli il pulsante Aggiungi (più «+»).

  4. Nella procedura guidata di creazione dell'integrazione, compila i seguenti campi:

    • Nome: nome descrittivo per l'integrazione con Jira.

    • Descrizione (opzionale): note su come verrà utilizzata questa connessione.

    • Tipo di connessione: scegli Rete pubblica.

  5. In Impostazioni di autenticazione, scegli il metodo di autenticazione e compila i campi richiesti:

    1. Per l'autenticazione utente, configura i seguenti campi:

      • URL di base: l'URL dell'istanza Jira per le chiamate API. Questo non è lo stesso URL a cui accedono gli utenti. Assomiglia al seguente:https://api.atlassian.com/ex/jira/yourInstanceId. Per trovare l'ID della tua istanza, vai ahttps://your-domain.atlassian.net/_edge/tenant_info.

      • ID cliente: ID cliente dalla pagina Impostazioni dell'app Atlassian OAuth .

      • Client secret: nascosto dalla pagina Impostazioni dell'app OAuth Atlassian.

      • URL del token: https://auth.atlassian.com/oauth/token

      • URL di autorizzazione — https://auth.atlassian.com/authorize

      • URL di reindirizzamento: questo campo è precompilato con il tuo URL di callback Amazon Quick.

    2. Per l'autenticazione del servizio, configura i seguenti campi:

      • Chiave API: token API Jira.

      • URL di base: l'URL dell'istanza Jira per le chiamate API.

      • Email: indirizzo e-mail associato all'account utente.

  6. Scegli Crea e continua.

  7. (Facoltativo) Nella pagina di integrazione Condividi, scegli gli utenti con cui condividere l'integrazione.

Importante

Jira Cloud può restituire risposte di successo HTTP 200 anche quando i token API vengono revocati o configurati in modo errato. Per ulteriori informazioni, consulta JRACLOUD-82932. Se l'integrazione sembra connettersi correttamente ma le azioni falliscono in modo imprevisto, verifica che il token API sia valido e non sia stato revocato.

Operazioni disponibili

Dopo aver configurato l'integrazione, sono disponibili le seguenti azioni.

Azioni disponibili in Jira Cloud
Azione Description
Aggiungi allegato Aggiungi un allegato a un problema.
Aggiungi commento Aggiungi un nuovo commento.
Modifica lo stato del problema Modifica lo stato dell'attività di un problema.
Crea problema Crea un nuovo problema o sottoattività.
Creazione di un progetto Crea un nuovo progetto.
Crea Sprint Crea uno sprint in un progetto.
Elimina commento Rimuovi commento.
Elimina problema Eliminare un problema in un progetto.
Eliminazione del progetto Rimuovi progetto.
Elimina Sprint Elimina uno sprint in un progetto.
Modifica problema Modifica problema.
Trova utenti Cerca un utente Jira.
Ottieni tutte le etichette Visualizza tutte le etichette.
Ottieni tutti gli utenti Elenca tutti gli utenti Jira.
Ottieni il contenuto degli allegati Visualizza il contenuto di un allegato.
Ottieni commenti Visualizza i commenti sui problemi.
Ottieni un problema Visualizza i dettagli di un problema in un progetto.
Visualizza i tipi di problemi relativi al progetto Visualizza i tipi di problemi del progetto.
Ottieni priorità Visualizza le priorità dei problemi.
Ottieni il progetto Visualizza i dettagli del progetto.
Ottieni Sprint Visualizza i dettagli di uno sprint in un progetto.
Sposta i problemi in Backlog Sposta i problemi nel backlog.
Sposta i problemi in Sprint e Rank Assegna un problema a uno sprint.
Problemi di ricerca Cerca problemi.
Cerca progetti Trova progetti visibili.
Stati della ricerca Cerca gli stati dei problemi.
Aggiorna commento Modifica commento.
Aggiorna progetto Modifica progetto.
Aggiorna Sprint Aggiorna i dettagli dello sprint.
Nota

Le azioni che puoi utilizzare dipendono dalle autorizzazioni configurate nell'istanza di Jira Cloud e dal metodo di autenticazione.

Gestisci e risolvi i problemi

Per modificare, condividere o eliminare la tua integrazione, consulta. Gestione delle integrazioni esistenti

Problemi di autenticazione

  • Configurazione errata dell'app: verifica che l' OAuth app nell'Atlassian Developer Console includa gli ambiti richiesti e che l'URI di reindirizzamento corrisponda alla tua configurazione Amazon Quick.

  • Token API scaduto o revocato: se utilizzi l'autenticazione del servizio, verifica che il token API non sia scaduto o non sia stato revocato. A causa di un comportamento noto di Jira Cloud (JRACLOUD-82932), è possibile che l'integrazione si connetta correttamente anche con token non validi.

  • URL di base errato: l'URL di base per le chiamate API non è lo stesso dell'URL di accesso a Jira Cloud. Verifica di utilizzare il formato URL dell'API:https://api.atlassian.com/ex/jira/yourInstanceId. Per trovare l'ID della tua istanza, vai ahttps://your-domain.atlassian.net/_edge/tenant_info.

Messaggi di errore comuni

  • Access denied. You do not have permission to perform this action— L'utente autenticato non dispone delle autorizzazioni richieste in Jira Cloud. Contatta il tuo amministratore di Jira Cloud per verificare e concedere le autorizzazioni appropriate.

  • OAuth 2.0 authorization failed— Verifica che l'ID client, il segreto del client e OAuth gli ambiti siano configurati correttamente sia nell'Atlassian Developer Console che in Amazon Quick.