In questo articolo, dimostreremo come usare Logto come provider di identità OpenID Connect (OIDC) per Outline.
La parte migliore è che entrambi Logto e Outline sono open-source. In questo articolo, dimostreremo come utilizzare Logto come provider di identità OpenID Connect (OIDC) per Outline.
Per iniziare, assicurati di avere quanto segue:
Se stai ospitando Logto autonomamente, consulta la documentazione "Inizia" di Logto per configurare la tua istanza di Logto.
Apri la Console Logto inserendo l'URL https://cloud.logto.io/ se stai usando Logto Cloud, o l'endpoint che hai configurato per l'hosting autonomo.
Successivamente, vai alla scheda "Applicazioni" e clicca su "Crea applicazione".
Nel modale che appare, scegli "Web tradizionale" e fornisci un nome per l'applicazione, come "Outline". Poi clicca su "Crea applicazione".
Sarai indirizzato a una pagina di tutorial in Logto. Clicca su "Salta" nell'angolo in alto a destra per procedere alla pagina dei dettagli dell'Applicazione.
Nella sezione "Redirect URIs", inserisci il seguente valore:
Ad esempio, se stai ospitando Outline su http://localhost:3000, il valore dovrebbe essere:
Clicca sul pulsante "Salva modifiche" in fondo. Una volta riuscito, tieni aperta questa pagina poiché sarà utile per la configurazione di Outline.
Segui i passaggi delineati nella guida all'hosting di Outline fino a raggiungere il passaggio di configurazione dell'autenticazione. Poiché Outline supporta di default i provider di autenticazione compatibili con OIDC, puoi facilmente trovare la maggior parte dei valori di configurazione richiesti sulla pagina dei dettagli dell'applicazione Logto.
Fai riferimento alla seguente tabella per i dettagli di configurazione necessari:
| Variabile di Ambiente di Outline | Nome Visualizzato in Logto |
|---|---|
| OIDC_CLIENT_ID | ID Applicazione |
| OIDC_CLIENT_SECRET | Segreto App |
| OIDC_AUTH_URI | Endpoint Autenticazione |
| OIDC_TOKEN_URI | Endpoint Token |
| OIDC_USERINFO_URI | Endpoint Informazioni Utente |
Ecco un'altra tabella contenente variabili aggiuntive:
| Variabile di Ambiente di Outline | Descrizione |
|---|---|
| OIDC_USERNAME_CLAIM | Imposta su nome utente |
| OIDC_DISPLAY_NAME | Facoltativo - Personalizza secondo necessità |
| OIDC_SCOPES | Mantieni predefinito; non necessario impostare |
Poiché Outline richiede che venga fornita l'email dell'utente, è necessario configurare l'accesso tramite email o un accesso social che fornisca un indirizzo email affidabile, come l'accesso tramite Google.
Consulta Configura connettori per saperne di più su come configurare i connettori in Logto.
Avvia l'istanza di Outline e accedi al suo endpoint. Dovresti vedere un pulsante al centro etichettato "Continua con OpenID Connect"; può essere personalizzato impostando la variabile di ambiente OIDC_DISPLAY_NAME.
Clicca sul pulsante e sarai indirizzato all'esperienza di accesso di Logto.
Se tutto è stato configurato correttamente, una volta completato il processo di accesso o registrazione in Logto, sarai reindirizzato a Outline. Potrai quindi vedere le tue informazioni personali visualizzate nell'angolo in basso a sinistra della pagina.
Se incontri problemi durante l'integrazione, non esitare a contattarci via email a [email protected] o unisciti al nostro server Discord!