La funzionalità Integrazioni con API esterne permette di configurare il collegamento con i servizi forniti da provider esterni.
Creare una nuova integrazione
Per creare una nuova Integrazione cliccate sul pulsante Gestisci, posto nella testata della maschera, e selezionate la voce Crea. Nella sezione che comparirà indicate tutti i parametri necessari al completamento dell'operazione.
I campi compilabili sono:
· Codice - Il codice univoco dell'elemento configurativo.
· Descrizione - La descrizione esplicativa dell'elemento configurativo.
· Disabilitato - Indica se l'elemento configurativo è disabilitato, il valore predefinito è false.
· Provider - Il provider selezionato per l'elemento configurativo.
Attualmente i provider disponibili sono:
o Google (utente specifico)
o Google (account di servizio)
o Microsoft Graph (utente specifico)
o Microsoft Graph (account di servizio).
Nel paragrafo successivo trovate una spiegazione dettagliata della differenza tra i provider di tipo utente specifico e quelli di tipo account di servizio.
· API abilitate - La lista di API abilitate per l'elemento configurativo.
Attualmente è possibile selezionare una delle seguenti API abilitate:
o Calendar.
La documentazione di ogni tipologia di API abilitata è disponibile nel modulo di riferimento del servizio.
Per questa funzionalità, il provider viene differenziato ulteriormente tra utente specifico e account di servizio, poiché per ragioni tecniche sono necessarie autorizzazioni e informazioni differenti.
Utente specifico
Per utente specifico si intende un tipo di integrazione con i servizi esterni di un provider, configurata tramite l'account aziendale di una singola risorsa.
In questo caso, l'integrazione funziona solo per le risorse che dispongono di un elemento configurativo collegato al proprio account; per tutte le altre, l'integrazione non è disponibile.
Account di servizio
Per account di servizio si intende un tipo di integrazione con i servizi esterni di un provider, configurata tramite un account condiviso dell'organizzazione.
In questo caso, l'integrazione è attiva per tutte le risorse dell'impianto, indipendentemente dal loro account individuale.
Avviare la procedura di autorizzazione
Dopo aver creato l'elemento configurativo, premi Avvia la procedura di autorizzazione per concedere al provider le autorizzazioni necessarie al completamento dell'integrazione con il servizio esterno.
Dopo aver premuto il pulsante Avvia la procedura di autorizzazione, il sistema apre la maschera di configurazione che reindirizza al sito del provider, dove potete abilitare le autorizzazioni necessarie per completare l'integrazione con le agende esterne.
Configurazione Utente specifico
Per l'utente specifico premete Concedi autorizzazioni: il sistema reindirizza al sito del provider, dove potrete accettare le autorizzazioni necessarie all'integrazione.
Configurazione Account di servizio
Seguite le istruzioni indicate nella maschera di configurazione e premete Concedi autorizzazioni.
Microsoft
Indicate il tenant ID dell'organizzazione, quindi premete Concedi autorizzazioni.
Il sistema reindirizza al sito del provider, dove dovrete accettare le autorizzazioni necessarie per completare l'integrazione.
Nel capitolo successivo è spiegato come acquisire il tenant ID dell'organizzazione.
Acquisizione Microsoft Entra Tenant ID
Per acquisire il tenant ID di Microsoft Entra, richiesto per l'integrazione tramite account di servizio per Microsoft Graph, seguite questi passaggi:
1. Accedete al portale di Azure.
2. Assicuratevi di aver eseguito l'accesso al tenant per il quale desiderate ottenere l'ID. In caso contrario, cambiate directory per lavorare nel tenant corretto.
3. Sotto l'intestazione Servizi di Azure selezionate Microsoft Entra ID. Se non viene visualizzato Microsoft Entra ID, usate la casella di ricerca per trovarlo.
4. Trovate l'ID tenant nella sezione Informazioni di base della schermata Panoramica.
5. Copiate l'ID tenant selezionando l'icona Copia negli Appunti visualizzata accanto. Potete incollare questo valore in un documento di testo o in un'altra posizione.
Maggiori informazioni sono disponibili nella documentazione ufficiale di Microsoft.
Configurazione completata con successo
Al termine del processo di autorizzazione, il sistema mostra la maschera di configurazione finale, che conferma l'avvenuta configurazione.
Nella schermata precedente sono riportati la data e l'ora di sincronizzazione (in fuso orario UTC) e l'indicazione che la configurazione è pronta e già autorizzata.
Se necessario, puoi comunque rieseguire la procedura di autorizzazione premendo Riesegui la procedura di autorizzazione. Per esempio in caso di errori durante l'utilizzo del servizio esterno.
Verificare l'integrazione
Potete verificare l'integrazione, specificando un indirizzo e-mail su cui eseguire il test.
Per eseguire il test, cliccate nuovamente sul pulsante Gestisci nella testata della maschera e selezionate Modifica. A questo punto potete compilare il campo con l'indirizzo e-mail dell'account su cui eseguire il test e premere Avvia test.
