Integrazione con Jira Cloud - Amazon Quick
Cosa puoi farePrima di iniziareCrea un token API JiraConfigura l'integrazione con JiraConfigura l'autenticazioneOperazioni disponibiliCondividi le integrazioniGestisci le integrazioni con Jira

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 Jira Cloud

Connetti Amazon Quick alla tua istanza Jira Cloud per gestire problemi, progetti e altri oggetti Jira. Puoi creare, aggiornare e interrogare contenuti Jira senza uscire dal tuo ambiente Amazon Quick. Questa integrazione richiede il livello Amazon Quick Pro o superiore.

Cosa puoi fare

Con l'integrazione con Jira Cloud, puoi eseguire azioni all'interno delle tue istanze Jira tramite l'API REST di Jira.

Connettore Action

Crea, aggiorna e interroga problemi, progetti e altri oggetti di Jira tramite l'API REST di Jira.

Nota

Questa integrazione supporta solo l'esecuzione delle azioni. Non puoi utilizzarla per creare knowledge base o accedere ai dati di Jira per scopi di ricerca.

Prima di iniziare

È necessario quanto segue per configurare l'integrazione con Jira:

  • Istanza Jira Cloud con autorizzazioni appropriate.

  • Credenziali dell'account utente Jira o del token API.

  • Amazon Quick Author o versione successiva.

  • Accesso amministrativo per configurare OAuth le applicazioni (per l'autenticazione degli utenti).

Crea un token API Jira

Per utilizzare l'autenticazione tramite chiave API, crea un token API nel tuo account Atlassian.

  1. Vai alle impostazioni del tuo account Atlassian e scegli Sicurezza.

  2. Crea un nuovo token API per l'integrazione con Amazon Quick.

  3. Copia il token generato da utilizzare nella configurazione dell'integrazione Amazon Quick.

  4. Prendi nota dell'URL e dell'indirizzo e-mail dell'utente dell'istanza Jira Cloud. L'URL dell'istanza Jira Cloud è un valore speciale per le chiamate API che puoi trovare navigando su. https://your-domain.atlassian.net/_edge/tenant_info

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.

Configura l'integrazione con Jira

Segui questi passaggi per connettere Amazon Quick alla tua istanza Jira Cloud.

  1. Nella console Amazon Quick, scegli Integrazioni.

  2. Fai clic su Aggiungi (più il pulsante «+»).

  3. Completa i dettagli dell'integrazione:

    • Nome: inserisci un nome descrittivo per la tua integrazione con Jira.

    • Descrizione (opzionale): descrivi lo scopo di questa integrazione.

  4. Scegli il tipo di connessione (autenticazione utente o servizio).

  5. Completa le impostazioni di connessione in base al metodo di autenticazione:

    • Per l'autenticazione utente (OAuth):

      • URL di base: l'URL dell'istanza di Jira Cloud. Questo deve essere fornito nel seguente formato:https://api.atlassian.com/ex/jira/instanceid. Il tuo instanceid può essere trovato navigando su. https://your-domain.atlassian.net/_edge/tenant_info

      • ID cliente: l'ID client dell' OAuth app Atlassian.

      • Client Secret: il segreto del client dell'app Atlassian OAuth .

      • URL del token: endpoint del token Atlassian OAuth .

      • URL di autenticazione: endpoint di autorizzazione Atlassian. OAuth

      • URL di reindirizzamento: URI di reindirizzamento. OAuth

    • Per l'autenticazione del servizio (chiave API):

      • URL di base: l'URL dell'istanza di Jira Cloud.

      • Chiave API: il tuo token API Jira.

      • Email: indirizzo e-mail associato al tuo account utente Jira.

  6. Seleziona Crea e continua.

  7. Seleziona gli utenti con cui condividere l'integrazione.

  8. Fare clic su Avanti.

Configura l'autenticazione

L'integrazione con Jira Cloud supporta due metodi di autenticazione. Scegli il metodo più adatto alla tua organizzazione.

Autenticazione utente (OAuth)

Da utilizzare OAuth quando si desidera che le azioni vengano eseguite con identità utente individuali. Configura questi campi:

  • URL di base: l'URL dell'istanza di Jira Cloud.

  • ID cliente: l'ID client dell' OAuth app Atlassian.

  • Client Secret: il segreto del client dell'app Atlassian OAuth .

  • URL del token: endpoint del token Atlassian OAuth .

  • URL di autenticazione: endpoint di autorizzazione Atlassian. OAuth

  • URL di reindirizzamento: URI di reindirizzamento. OAuth

Ambiti richiesti OAuth :

  • read:jira-user- Leggi le informazioni sull'utente.

  • read:jira-work- Leggi i numeri, i progetti e gli elementi di lavoro.

  • write:jira-work- Crea e modifica problemi ed elementi di lavoro.

  • manage:jira-project- Gestisci le impostazioni del progetto.

  • manage:jira-configuration- Gestisci la configurazione di Jira.

  • manage:jira-webhook- Gestisci i webhook.

  • 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.

Autenticazione del servizio (chiave API)

Utilizza l'autenticazione tramite chiave API per service-to-service le connessioni. Configura questi campi:

  • URL di base: l'URL dell'istanza di Jira Cloud.

  • Chiave API: il tuo token API Jira.

  • Email: indirizzo e-mail associato al tuo account utente Jira.

Nota

A causa di un comportamento noto di Jira Cloud, l'integrazione potrebbe sembrare connessa correttamente anche con token API revocati o non validi. Se le azioni falliscono inaspettatamente dopo la configurazione, verifica che il token API sia ancora valido nelle impostazioni dell'account Atlassian.

Operazioni disponibili

Dopo aver creato l'integrazione con Jira, puoi utilizzare queste azioni per interagire con Jira Cloud:

  • Crea, leggi, aggiorna ed elimina i problemi di Jira.

  • Gestisci le transizioni dei problemi e i flussi di lavoro.

  • Problemi di interrogazione utilizzando JQL (Jira Query Language).

  • Gestisci progetti, componenti e versioni.

  • Aggiungi commenti e allegati ai problemi.

  • Gestisci le assegnazioni degli utenti e gli osservatori.

  • Accedi ai metadati del progetto e del problema.

Nota

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

Condividi le integrazioni

Puoi condividere il tuo Jira Action Connector con altri utenti della tua organizzazione.

  1. Dopo aver creato l'integrazione, scegli Condividi integrazione.

  2. Seleziona gli utenti o i gruppi con cui desideri condividere l'integrazione.

  3. Imposta le autorizzazioni appropriate per l'accesso condiviso.

  4. Conferma le impostazioni di condivisione.

Gestisci le integrazioni con Jira

Puoi eseguire queste attività di gestione per le tue integrazioni con Jira:

  • Modifica le impostazioni di integrazione: aggiorna le impostazioni di autenticazione o la configurazione dell'istanza Jira.

  • Condividi l'accesso all'integrazione: rendi l'integrazione disponibile per altri utenti della tua organizzazione.

  • Monitora le metriche di utilizzo: visualizza le metriche dell'attività di integrazione e dell'utilizzo delle API.

  • Rivedi le azioni disponibili: consulta l'elenco completo delle azioni Jira disponibili.

  • Elimina integrazione: rimuove l'integrazione e revoca l'autenticazione associata.