Per gli amministratori: Configura Lucid Cards per Jira

Configura la tua istanza Jira Cloud per la sincronizzazione live

Per completare i passaggi seguenti è necessario disporre dei permessi di amministratore sia di Jira che di Lucidspark. È necessario che l'amministratore che imposta l'integrazione disponga di una licenza Lucidspark. Si consiglia inoltre di utilizzare un account di servizio Jira o un account di amministrazione Jira.

Per configurare l'istanza di Jira Cloud per la sincronizzazione live con Lucid, un amministratore di account può completare i seguenti passaggi in Lucid: 

1. Dalla home page di Lucid, fai clic su Amministratore in basso a sinistra nel menu di navigazione.
2. Clicca su Integrazione di app nel menu a sinistra. 
3. Dal menu a tendina, seleziona Lucidspark.
4. Individua il riquadro Lucid Cards for Jira Cloud e clicca su Impostazioni.
5. Seleziona Aggiungi nuova istanza.
   

Si aprirà la pagina delle Impostazioni di Jira Cloud, nella quale dovrai seguire i seguenti passaggi:

1. Dal menu a tendina "Autorizza per", seleziona la tua istanza Jira per Lucidspark.
2. Clicca suAccetta.
   
3. Clicca su Connect per autenticarti con le credenziali della tua istanza Jira.
4. Seleziona Invia.

L'integrazione è ora impostata per la sincronizzazione in tempo reale. 

Abilita l'istanza di Jira Data Center

Segui i passaggi seguenti per configurare un'istanza di Jira Data Center. Consigliamo di usare OAuth 2.0 per le nuove integrazioni. Se il tuo account era precedentemente connesso tramite Application Links (OAuth 1.0), non è necessario cambiare, la connessione attuale continuerà a funzionare. Se hai bisogno di supporto per OAuth 1.0, consulta questo post della community.

Sebbene i menu di Jira mostrati in questa sezione possano variare a seconda della versione di Jira Data Center, il processo generale di configurazione è lo stesso.

Assicurati che la tua istanza di Jira sia accessibile dai server di Lucid

Assicurati di avere un DNS pubblico e di consentire le richieste in entrata dagli IP statici elencati di seguito.

Se sei sull'ambiente FedRAMP, assicurati di consentire le richieste in entrata e in uscita dagli IP statici elencati di seguito.

Collega Lucidspark al Data Center Jira usando OAuth 2.0

Avrai bisogno sia dei permessi amministrativi di Jira che di Lucidspark, oltre a una licenza Lucidspark, per completare i seguenti passaggi.

Passo 1: Crea un'applicazione OAuth 2.0 in Jira Data Center

Nella tua istanza di Jira Data Center, crea un link per l'applicazione OAuth 2.0 in arrivo:

1. In Jira, naviga nelle impostazioni di Jira.
2. Vai su Candidature.
3. Scegli i link dell'Applicazione.
4. Seleziona Crea link.
5. Scegli Applicazione Esterna con direzione "Incoming".
6. Seleziona Continua.
7. Imposta il nome dell'applicazione.
   • Il nome che scegli dovrebbe rappresentare la funzionalità Schede Lucid per Jira; come "Lucidspark".
   • Imposta l'URL di Redirect su "https://lucid.app/jiradatacenter/oauth2/callback".
8. Imposta i permessi dell'applicazione per includere ADMIN.
9. Salva e copia l'ID Client e il Client Secret generati.

Passo 2: Configura la connessione in Lucid

1. In Lucid, seleziona Admin dal menu in basso a sinistra della home page.
2. Dal menu a sinistra, seleziona Integrazione con l'app.
3. Dal menu a tendina, clicca su Lucidspark.
4. Individua la tessera "Schede Lucid for Jira Data Center".
5. Clicca su Impostazioni sulla casella (o Installa se non hai ancora configurato l'integrazione).
6. Seleziona Aggiungi nuova istanza ( oppure Inizia la configurazione se non hai ancora configurato l'integrazione).
7. Verifica che l'URL di Redirect corrisponda a quello che hai configurato in Jira sul link dell'applicazione.
8. Inserisci l'ID del cliente e il segreto del cliente da Jira.
9. Inserisci l'URL dell'istanza del tuo Data Center Jira.
   • Ad esempio, questo potrebbe assomigliare a qualcosa di simile a "https://jira.yourcompany.com".
   • Se un reverse proxy è configurato per intercettare il traffico in entrata prima che raggiunga la tua istanza, puoi fornire l'URL di quel reverse proxy. Quel proxy inverso deve consentire il traffico in entrata dai nostri indirizzi IP elencati qui.

Passo 3: Autorizza la connessione

1. Clicca su Abilita per avviare il flusso di autorizzazione OAuth 2.0.

Verrai reindirizzato alla tua istanza di Data Center Jira per approvare l'accesso. Dopo aver approvato, verrai reindirizzato a Lucid. L'integrazione è ora impostata per la sincronizzazione in tempo reale.

Una volta completata la configurazione amministrativa, gli utenti finali possono autenticarsi con le proprie credenziali Jira per importare e creare problemi Jira in Lucidspark. Ogni utente sarà reindirizzato alla schermata di consenso del Centro Dati Jira durante la prima connessione.

Per gli account che utilizzano l'autenticazione SSO con Jira

I server di Lucid devono essere in grado di raggiungere la tua istanza Jira Data Center. Se la tua istanza di Data Center Jira è protetta da un provider SSO, questo può causare problemi poiché SSO è progettato per autenticare gli utenti in un browser e spesso non può essere completato da un servizio backend che effettua chiamate API.

Risolvere questo problema dipende dal tuo SSO specifico e dalla configurazione della rete. Dovrai configurare il tuo SSO o infrastruttura di rete in modo che il traffico server-to-server di Lucid bypassi l'intercettazione SSO. Gli approcci comuni includono l'esclusione basata su percorso al livello SSO o l'instradamento del traffico di Lucid completamente attorno all'SSO. 

Usare OAuth 1.0 con SSO

Per i link alle applicazioni OAuth 1.0, consulta la soluzione alternativa di Atlassian in questo post della community.

Configura la tua istanza Atlassian Government Cloud per la sincronizzazione live

Avrai bisogno sia dei permessi amministrativi di Jira che di Lucidspark per completare i seguenti passaggi. Richiediamo che l'amministratore che configura questa integrazione abbia una licenza Lucidspark. Consigliamo anche di utilizzare un account amministratore Jira.

Per configurare l'istanza Atlassian Government Cloud per la sincronizzazione live con Lucid, un amministratore di account può completare i seguenti passaggi in Lucid: 

1. Dalla home page di Lucid, fai clic su Amministratore in basso a sinistra nel menu di navigazione.
2. Clicca su Integrazione app nel menu sinistro. 
3. Dal menu a tendina, seleziona Lucidspark.
4. Clicca su Aggiungi nuova istanza Atlassian Government Cloud.
5. Leggi i permessi e clicca su Accetta.

L'integrazione è ora impostata per la sincronizzazione in tempo reale. 

FAQ

Perché dovrei abilitare l'integrazione con Jira Cloud o Atlassian Government Cloud come amministratore se non è necessario?
A gennaio 2023, Lucidspark utilizza webhook per sincronizzare i dati da Jira. Questo aggiornamento permette a Tavola di ricevere aggiornamenti da Jira in tempo reale. Lucidspark creerà e gestirà webhook solo dopo un'autenticazione una tantum tramite i passaggi di configurazione dell'integrazione presentati in questo articolo. Se l'integrazione viene installata individualmente da un utente prima che questi passaggi siano completati, funzionerà, ma le schede sincronizzeranno gli aggiornamenti da Jira circa ogni 2 minuti invece che in tempo reale.

Cosa devo fare se ricevo un messaggio di errore quando cerco di configurare l'integrazione Schede Lucid nel Data Center di Jira?
Quando configuri l'integrazione con Jira Data Center, se incontri un errore applicativo, consulta questo post Consigli per risolvere errori comuni durante la configurazione di Schede Lucid per Jira Data Center.

Come funziona questa integrazione e quali permessi mi servono?
Per una spiegazione approfondita di come funziona questa integrazione e dei permessi che ottieni in base al fatto che tu abbia credenziali Jira utente o amministratore, consulta la nostra risorsaSchede Lucid for Jira Technical FAQs. Questa risorsa include un'analisi approfondita di come vengono utilizzate le credenziali amministrative, dei webhook e dei loro vantaggi, e di come i dati di Jira sono protetti.

Perché vengo reindirizzato a lucid.app quando cerco di configurare l'integrazione Schede Lucid per Jira con la mia istanza Atlassian Government Cloud?
Per evitare di essere reindirizzato a lucid.app, dovrai usare SSO per accedere alla tua istanza Cloud Governativa di Atlassian prima di configurare l'integrazione di Schede Lucid per Jira.

Risorse

Per ulteriore assistenza nell'utilizzo corretto di questa integrazione, esplora le risorse aggiuntive riportate di seguito. Queste risorse sono disponibili solo in inglese.

Post della scheda Community

Risoluzione dei problemi di Jira: Impossibile modificare un campo in Lucid - messaggio di errore "Modifica non supportata"
Risoluzione dei problemi di Jira: lingue diverse aggiunte come colonne alla tabella dinamica

Dai un feedback su questo articolo