Amministrazione e configurazione del Connettore Jira di Smartsheet

Il Connettore Jira di Smartsheet sincronizza le informazioni tra Smartsheet e una o più istanze Jira creando flussi di lavoro.

Il Connettore Jira di Smartsheet è un prodotto Premium. Contatta il nostro team di vendita per informazioni sui prezzi.

Se hai acquistato il Connettore Jira di Smartsheet per il tuo piano, accedi per creare flussi di lavoro tra Smartsheet e Jira.

Accedi al Connettore Jira di Smartsheet

Terminologia e tipi di autorizzazione

• Connessione: il collegamento tra Smartsheet e un’istanza Jira specifica.
• Flusso di lavoro: il collegamento all’interno del Connettore Jira che connette gli elementi Jira a un foglio Smartsheet.

Gli utenti possono avere tre diverse autorizzazioni per interagire con il Connettore Jira di Smartsheet:

• Amministratore di sistema Smartsheet: gestisce gli Amministratori del Connettore Jira e gli Utenti del Connettore Jira dall’applicazione Smartsheet. Gli Amministratori di sistema possono inoltre abilitare un’impostazione per limitare l’accesso al Connettore.
• Amministratore Connettore Jira: stabilisce la connessione tra un’istanza Jira e il Connettore Jira di Smartsheet.
• Utente Connettore Jira: può creare flussi di lavoro per sincronizzare le informazioni tra Smartsheet e Jira.

Funzionalità per tipo di autorizzazione

La tabella seguente mostra quali autorizzazioni sono necessarie per completare attività specifiche utilizzando il Connettore Jira.

 *Gli Amministratori di sistema Smartsheet e gli Amministratori del Connettore possono creare e modificare i propri flussi di lavoro se la funzione dell’elenco di limitazione dell’accesso è abilitata. Se l’Amministratore di sistema attiva l’impostazione Restrict Users (Limita utenti) nel Connettore Jira, devi avere anche il ruolo Utente Jira in Smartsheet. Scopri di più sulla limitazione dell’accesso.

Configurazione della connessione

Devi prima configurare la connessione tra Smartsheet e l’istanza Jira, in modo che gli utenti possano creare flussi di lavoro per connettere elementi in Smartsheet e Jira. Il Connettore Jira di Smartsheet è compatibile con Jira Cloud e Jira Data Center da v6.x a v10.x.

Stabilisci la connessione utilizzando un account e-mail con licenza generico (smartsheet-jira@dominio.com) per Smartsheet e Jira. Ciò evita la necessità di ripetere le connessioni o i flussi di lavoro se la persona che gestisce il collegamento Jira lascia l’organizzazione, poiché la proprietà della connessione non può essere modificata.

Prerequisiti

Per impostare la connessione tra Smartsheet e Jira, devi disporre delle seguenti autorizzazioni:

In Jira:

• Amministratore di sistema Jira (Amministratore di prodotto o Amministratore di organizzazione)

In Smartsheet:

• Utente con licenza di Smartsheet (modello Collaboratore legacy) o Membro (modello Abbonamento utente)
• Ruolo di Amministratore di sistema Smartsheet o Amministratore Connettore Jira di Smartsheet

Basta avere il ruolo di Amministratore di sistema Smartsheet OPPURE il ruolo di Amministratore Connettore Jira di Smartsheet; Smartsheet consiglia di avere entrambi i ruoli per configurare il Connettore.

Poiché il Connettore Jira di Smartsheet consente l’implementazione di flussi di lavoro automatici, l’applicazione deve disporre delle credenziali dell’Amministratore di sistema Jira per creare o configurare un webhook con l’API REST Jira. Le credenziali dell’Amministratore di sistema Jira vengono utilizzate solo per creare e configurare i webhook.

L’account utilizzato per la configurazione deve rimanere attivo con diritti di Amministratore sia in Jira che in Smartsheet. La rimozione dello stato Amministratore di questo utente causa un errore: Missing user credentials for this endpoint (Credenziali utente mancanti per questo endpoint). Il ripristino delle autorizzazioni di Amministratore corregge la connessione e permette di riprendere la normale sincronizzazione del flusso di lavoro. Se le credenziali dell’Amministratore Jira vengono rimosse, devi ricostruire il collegamento dell’applicazione per via di modifiche del token.

Fasi di configurazione

I passaggi per stabilire una connessione variano a seconda del tipo di distribuzione Jira e della versione OAuth in uso. Segui il percorso che corrisponde alle tue condizioni:

Devi disporre delle autorizzazioni di Amministratore Jira per configurare una connessione.

Puoi creare fino a tre connessioni per istanza Jira Cloud con OAuth2.0.

Jira Cloud OAuth 1.0, OAuth 2.0 o Jira Data Center OAuth 1.0

Passaggio 1 - Registra un nuovo server Jira nel Connettore Jira di Smartsheet

Configura le impostazioni del firewall e crea la configurazione prima di configurare questa connessione.

1. Accedi al Connettore Jira di Smartsheet. Se ti viene richiesto di consentire l’accesso all’account Smartsheet, seleziona Allow (Consenti).
2. Seleziona il menu nell’angolo in alto a sinistra nella pagina e quindi seleziona Account Admin (Amministrazione dell’account).
3. Seleziona Register New Jira Server (Registra nuovo server Jira).
4. Nella pagina Settings (Impostazioni):
   1. Inserisci l’URL dell’host JIRA dell’ambiente Jira che desideri connettere al tuo ambiente Smartsheet (https://mbfcorp.atlassian.net/). 
   2. L’URL dell’API JIRA probabilmente è lo stesso del tuo host JIRA. 
   3. Per Name (Nome), accetta il nome predefinito o modificalo con un descrittore più utile. 
   4. Seleziona la tua versione JIRA: Jira Server 7 o Cloud per istanze cloud Jira.

Brandfolder Image

5. Una volta completati questi elementi, nella pagina Settings (Impostazioni), seleziona Continue (Continua).
6. Nella pagina Configuration (Configurazione), vedi Consumer Key (Chiave consumer), Consumer Name (Nome consumer) e Public Key (Chiave pubblica). Copiali; ti serviranno nei passaggi seguenti.
7. Seleziona Continue (Continua) per passare alla pagina successiva.

Passaggio 2 - Crea un collegamento dell’applicazione (AppLink) a Smartsheet in Jira

Ignora questo passaggio se utilizzi OAuth 2.0.

1. Accedi a Jira (devi avere le autorizzazioni di Amministratore Jira).

2. Vai in Settings > Products (Impostazioni > Prodotti) in Jira.
    

   Brandfolder Image

   

3. Sulla barra laterale Products (Prodotti), in Integrations (Integrazioni), seleziona Application links (Link applicazioni).

   Nelle precedenti versioni di Jira con self-hosting, scegli Settings > Applications (Impostazioni > Applicazioni) e seleziona Application links (Collegamenti applicazione).

   Brandfolder Image

   
4. Seleziona Create link (Crea link); viene visualizzato un riquadro Create link (Crea link). Compila i campi come descritto di seguito:

   • Per Jira Cloud, seleziona Direct application link (Collegamento diretto all’applicazione) e inserisci https://app.smartsheet.com per l’URL dell’applicazione. Quindi, seleziona Next (Avanti).

     Brandfolder Image

     

   • Per Jira con self-hosting versione 9 e successiva, seleziona Atlassian product (Prodotto Atlassian) e vai al sito https://app.smartsheet.com per l’URL dell’applicazione. Quindi, seleziona Continue (Continua).

     Brandfolder Image

     
5. Una volta visualizzato uno dei seguenti messaggi, seleziona Continue (Continua) e lascia invariato il nuovo URL.
   • Se non hai ricevuto risposta dall’URL inserito, potrebbe non essere valido. Se necessario, correggi l’URL riportato di seguito e seleziona Continue (Continua).
   • L’URL dell’applicazione fornito è stato reindirizzato una volta. Verifica il campo URL di reindirizzamento per assicurarti che si tratti di un URL affidabile.
6. Ora viene visualizzata una finestra a comparsa Review link (Rivedi collegamento) o Link applications (Collega applicazioni). Compila i campi come descritto di seguito:
   • Nella casella Application Name (Nome applicazione), digita Smartsheet.
   • Per Application Type (Tipo di applicazione), accetta il valore predefinito Generic Application (Applicazione generica).
   • Per Jira con self-hosting v9 e versioni successive, seleziona la casella Create incoming link (Crea collegamento in entrata).

   • Seleziona Continue (Continua).

     Brandfolder Image

     

Passaggio 3 - Modifica il collegamento dell’applicazione

Ignora questo passaggio se utilizzi OAuth 2.0.

1. Per il collegamento dell’applicazione creato nel Passaggio 2, seleziona il menu a tre punti che appare quando passi il cursore del mouse su Application link (Collegamento dell’applicazione) oppure seleziona l’icona di modifica (a seconda della versione). 

2. Viene visualizzata la finestra Configure (Configura). Seleziona Incoming Authentication (Autenticazione in entrata).
    

   Brandfolder Image

   
3. Compila i campi come descritto di seguito: 
   • Service Provider Name (Nome del fornitore di servizi) (se necessario): Smartsheet
   • Consumer Name (Nome consumer): incolla il nome consumer copiato dal Connettore Jira nel Passaggio 1
   • Consumer Key (Chiave consumer): incolla la chiave consumer copiata dal Connettore Jira nel Passaggio 1
   • Public Key/Shared Secret (Chiave pubblica/Segreta condivisa): incolla la Chiave pubblica copiata dal Connettore Jira nel Passaggio 1
   • Description (Descrizione): aggiungi una descrizione come desiderato
   • Se le opzioni Request Token URL (Richiedi URL token), Access Token URL (Accedi a URL token) o Authorize URL (Autorizza URL) sono richieste nel tuo ambiente Jira, utilizza questo URL per compilare questi campi: https://api.smartsheet.com/2.0/token
4. Nella parte inferiore dell’autenticazione in entrata, seleziona Save (Salva), quindi Close (Chiudi) nell’angolo in basso a destra.

Passaggio 4 - Completa la connessione tra Jira e Smartsheet

1. Vai alla configurazione del Connettore Jira di Smartsheet.
2. Nella schermata Connect (Connetti), seleziona Connect (Connetti) per completare la connessione lato Smartsheet.

Una schermata di dialogo ti chiederà se consenti a Smartsheet di leggere e scrivere nel tuo ambiente Jira. 

3. Se utilizzi OAuth 2.0, seleziona l’host dal menu a discesa Use app on (Usa app su). In caso contrario, vai al passaggio successivo. 

Brandfolder Image

4. Seleziona Allow (Consenti). 

La tua connessione tra Smartsheet e Jira è ora configurata. Gli utenti membri o con licenza sul tuo account possono ora creare flussi di lavoro tra gli elementi in Jira e i fogli in Smartsheet. 

Puoi connettere più ambienti Jira al tuo account Smartsheet con il Connettore Jira di Smartsheet. Ripeti le istruzioni qui sopra per ciascuna istanza Jira aggiuntiva da registrare. 

Jira Data Center OAuth 2.0

Passaggio 1 - Crea un collegamento dell’applicazione (AppLink) a Smartsheet in Jira

1. Accedi a Jira
2. Vai a Jira Settings > Applications (Impostazioni > Applicazioni).
3. Nella barra laterale Applications (Applicazioni), in Integrations (Integrazioni), seleziona Application links (Collegamenti delle applicazioni).

Se non vedi Applications (Applicazioni) in Settings (Impostazioni), vai a Products (Prodotti) e nella barra laterale Products (Prodotti), troverai Application Links (Collegamenti delle applicazioni) in Integrations (Integrazioni).

4. Seleziona Create link (Crea collegamento). Viene visualizzata la finestra Create link (Crea collegamento). Compila i campi come descritto di seguito:
   • Seleziona External Application (Applicazione esterna) come Application Type (Tipo di applicazione)
   • Seleziona Incoming (In entrata) come Direction (Direzione)
   • Seleziona Continue (Continua)

Brandfolder Image

5. Configura un link in entrata. Compila i campi come descritto di seguito:
   1. Per Name (Nome), aggiungi un descrittore utile
   2. Redirect URL (URL di reindirizzamento): {smartsheet-connector-host}/c/jira/signInCallback}. Tieni presente che smartsheet-connector-host differisce per ogni regione:

      • USA - https://connectors.smartsheet.com

      • AU - https://connectors.smartsheet.au

      • UE - https://connectors.smartsheet.eu
   3. Per Application Permission (Autorizzazione applicazione), seleziona System Admin (Amministratore di sistema)
6. Seleziona Save (Salva).

Quando completi questi passaggi, ottieni l’ID client e il Segreto client. Copiali entrambi prima dei passaggi seguenti.

Passaggio 2 - Registra un nuovo server Jira nel Connettore Jira di Smartsheet

1. Accedi al Connettore Jira di Smartsheet. Se ti viene richiesto di consentire l’accesso al tuo account Smartsheet, seleziona Allow (Consenti).
2. Seleziona il menu nell’angolo in alto a sinistra nella pagina e quindi seleziona Amministrazione account.
3. Seleziona Register New Jira Server (Registra nuovo server Jira).
4. Nella pagina Impostazioni:
   1. Inserisci l’URL dell’host JIRA dell’ambiente Jira che desideri connettere al tuo ambiente Smartsheet (https://mbfcorp.atlassian.net/).
   2. L’URL dell’API JIRA probabilmente è lo stesso del tuo host JIRA.
   3. Per Name (Nome), accetta il nome predefinito o modificalo con un descrittore più utile.
   4. Seleziona la tua versione di JIRA.
5. Una volta completati questi elementi, nella pagina Impostazioni, seleziona Continua.
6. Nella pagina Configurazione, vedi l’ID client e il Segreto client. Compila con i valori ottenuti nel Passaggio 1.

Passaggio 3 - Completa la Connessione tra Jira e Smartsheet

1. Una volta compilati ID client e Segreto client, seleziona Continua.
2. Nella schermata Connetti, seleziona Connetti per completare la connessione lato Smartsheet.

Una schermata di dialogo ti chiederà chiede se consenti a Smartsheet di leggere e scrivere nel tuo ambiente Jira. Seleziona Consenti.

La tua connessione tra Smartsheet e Jira è ora configurata. Gli utenti membri o con licenza sul tuo account possono ora creare flussi di lavoro tra gli elementi in Jira e i fogli in Smartsheet.

Limita l’accesso al Connettore Jira di Smartsheet

Se desideri restringere ulteriormente chi può creare flussi di lavoro all’interno del Connettore Jira di Smartsheet, puoi limitare l’accesso a determinati membri o utenti con licenza sul tuo account. Le azioni che puoi svolgere nel Connettore Jira dipendono dalle autorizzazioni di cui disponi sugli elementi in Smartsheet (autorizzazioni di condivisione foglio) e Jira (autorizzazioni di lettura/scrittura sul campo problema), indipendentemente dall’eventuale abilitazione di ulteriori limitazioni.

Il Connettore rispetta le autorizzazioni concesse sia in Jira che in Smartsheet. Ad esempio, supponi che la persona che ha creato un flusso di lavoro nel Connettore non disponga dell’autorizzazione per modificare dati specifici di progetto in Jira. In tal caso, il flusso di lavoro non può modificare i dati del progetto tramite il Connettore.

Per limitare l’accesso

Per limitare chi può creare flussi di lavoro con il Connettore Jira, l’Amministratore di sistema Smartsheet/Jira può attivare l’impostazione Restrict Access (Limita accesso).

1. Accedi al Connettore Jira di Smartsheet con le tue credenziali Smartsheet.
2. Seleziona l’icona del menu nell’angolo in alto a sinistra della pagina e seleziona Gestione degli utenti.

3. Seleziona la casella di spunta Restrict which users can access the Smartsheet JIRA Integration (Limita gli utenti con accesso all’integrazione JIRA per Smartsheet). 

   Brandfolder Image

   
4. Aggiungi l’indirizzo e-mail di chiunque desideri che acceda al connettore.

Per rimuovere l’accesso

Qualsiasi utente rimosso dall’elenco non sarà in grado di creare o modificare i propri flussi di lavoro.

1. Accedi al Connettore Jira di Smartsheet con le tue credenziali Smartsheet.
2. Vai a Gestione degli utenti.
3. Seleziona l’icona Elimina a destra delle informazioni sull’account di quella persona.