📙OAuth2
Questa sezione descrive le procedure di configurazione per l'utilizzo del protocollo OAuth2 al fine di autenticare il gestionale in servizi esterni
A partire dalla versione 2.4.24, il gestionale OpenSTAManager supporta l'autenticazione OAuth2 per l'accesso agli account di posta elettronica attraverso il pannello OAuth2 del modulo Account email.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252Fw5dZ1PLMVYmjF3nh8VPl%252Fimage.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=8cb60625&sv=1)
Per abilitare l'autenticazione OAuth2 per un account email è necessario utilizzare la relativa checkbox Abilita OAuth2 e selezionare il Provider tra quelli disponibili. A seguito di queste azioni, comparirà un link dinamico a questa documentazione che descrive le procedure da utilizzare per ottenere Client ID e Secret sulla base del provider selezionato.
📙 Google
L'accesso all'account Google tramite OAuth2 richiede la seguente configurazione nel modulo Account email:
Configurazione IMAP | Configurazione SMTP |
|
|
La configurazione dell'accesso OAuth2 per account Google si effettua all'indirizzo https://console.developers.google.com/, dove è necessario accedere con l'account interessato.
📙 Creazione progetto
Una volta raggiunta la Google Cloud Platform, si deve procedere a generare un Nuovo progetto appositamente denominato "OpenSTAManager"; in alternativa, se è disponibile un progetto pre-esistente, è possibile utilizzarlo.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FfnehV09slzTXXMt7nvTh%252Fimage.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=ecf66927&sv=1)
Dopo la creazione del progetto in questione, nella sezione Credenziali del menù di navigazione laterale è possibile procedere alla generazione della schermata e delle credenziali di accesso OAuth2.
📙 Impostazione schermata OAuth2
Il menu di navigazione laterale permette di accedere alla sezione per la configurazione della Schermata di consenso OAuth: qui è necessario selezionare User Type Esterno se non si ha accesso a Google Workspace.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252Fh8EHoPjE9mNGhQ3RYn44%252FImmagine%25202021-07-26%2520150911.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=bd7243e6&sv=1)
Una volta selezionato il tipo, sarà possibile configurare la schermata più nel dettaglio. Segue un esempio pratico (e incompleto) della configurazione: la parte rilevante per l'utilizzo ai fini del gestionale corrisponde ai Domini autorizzati, che devono contenere il dominio di installazione del gestionale. Le altre informazioni sono liberamente impostabili, compresi Ambiti e Utenti di prova.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252F93E1kr5RO0VzTJHfwsn3%252Fconsenso.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=a7e8be59&sv=1)
📙 Creazione credenziali
Una volta abilitata la schermata di consenso sopra indicata, è necessario attivare le credenziali di accesso OAuth attraverso l'opzione Crea credenziali -> ID client OAuth del menu Credenziali.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FSGo3taPYkNojQXionOtt%252FImmagine%25202021-07-26%2520150634.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=b60ddf37&sv=1)
Segue un esempio di impostazione delle informazioni necessarie per la creazione delle credenziali, dove in particolare nel campo URI di reindirizzamento autorizzati è necessario indicare l'indirizzo completo al file oauth2.php del gestionale in utilizzo. Nell'esempio, considerando OpenSTAManager disponibile a https://osmcloud.it/
: https://osmcloud.it/oauth2.php
.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FXIASGr4IdC6WQfgkdpvB%252Fimage%2520%2815%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=54282444&sv=1)
Una volta compilate le informazioni richieste, comparirà una schermata che riferisce Client ID e Secret: è necessario copiare i contenuti indicati nei rispettivi campi del modulo Account email.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252Fc7ryRAW4ItyojX3V3Z6T%252Fcreato.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=521a1b89&sv=1)
📙 Completamento configurazione
Una volta completati i passaggi precedenti, sarà possibile utilizzare il pulsante Completa configurazione del modulo Account email per completare l'inizializzazione dell'account via OAuth2.
📙 Microsoft
L'accesso all'account Microsoft tramite OAuth2 richiede la seguente configurazione nel modulo Account email:
Configurazione IMAP | Configurazione SMTP |
|
|
La configurazione dell'accesso OAuth2 per account Microsoft si effettua all'indirizzo https://portal.azure.com/, dove è necessario accedere con l'account interessato.
📙 Registrazione App
Una volta all'interno del portale Azure, si deve navigare alla sezione Azure Active Directory dove viene presentata una panoramica dell'account di riferimento. In questa schermata è possibile individuare il campo ID tenant, che bisogna copiare per il rispettivo campo nel modulo Account email.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FB5ORtX8Gz1wl9UJzQvdo%252Factive-directory.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=b063b168&sv=1)
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FEshMDPHetlYGBqdOBUqs%252Ftenant.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=5caf4342&sv=1)
Una volta completata l'informazione di cui sopra, è necessario procedere alla registrazione di una applicazione dedicata per il servizio.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FTqwVUOgjKPRshub565a7%252Fregistra.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=951d14d6&sv=1)
Al momento della compilazione delle informazioni, è fondamentale impostare correttamente il campo URI di reindirizzamento.
Nell'esempio, considerando OpenSTAManager disponibile in https://osmcloud.it/miainstallazione/,
si dovrà inserire:
https://osmcloud.it/miainstallazione/oauth2.php
.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FO7s6UNvD0cniPxDQfdR7%252Fspaces_udbmyQrl0FL3lcDlHZWD_uploads_MVHHqiAe9HFUPmpML3DJ_dati.png%3Falt%3Dmedia%26token%3D56c218fe-e6b1-4c10-a7b3-4de174746570&width=768&dpr=4&quality=100&sign=b196506a&sv=1)
Una volta completato questo passaggio, viene reso disponibile il Client ID sotto il nome di ID applicazione (client). La generazione del Client Secret avviene attraverso il menu laterale Certificati e segreti, che propone la creazione del segreto tramite il pulsante Nuovo segreto client: il Client Secret è quindi disponibile sotto il nome Valore del nuovo segreto.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FmIsyui7m2BIUs9GTkXec%252Fsegreto.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=dac4849c&sv=1)
📙 Autorizzazioni API
La configurazione dell'accesso Microsoft richiede inoltre la gestione delle autorizzazioni sulle informazioni che le credenziali create rendono disponibili. Ciò è possibile dal meni Autorizzazioni API, dove è necessario usare il pulsante Aggiungi un'autorizzazione e selezionare il provider Microsoft Graph.
Per l'utilizzo ai fini di invio email tramite protocollo SMTP, è necessario selezionare offline_access
e SMTP.Send.
![](https://docs.openstamanager.com/~gitbook/image?url=https%3A%2F%2F2282946136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1wvTdiHpnuBjaHw2cIat%252Fuploads%252FAAqNnlB5aaULFixrz9zP%252Fapi.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=97650982&sv=1)
📙 Completamento configurazione
Una volta completati i passaggi precedenti, sarà possibile utilizzare il pulsante Completa configurazione del modulo Account email per completare l'inizializzazione dell'account via OAuth2.
Last updated