Semplifica l'autenticazione di Outline con Logto
In questo articolo, dimostreremo come usare Logto come provider di identità OpenID Connect (OIDC) per Outline.
Founder
Introduzione
- Logto è una soluzione di identità senza sforzo con tutte le funzionalità di cui hai bisogno. Supporta vari metodi di accesso, inclusi nome utente, email, numero di telefono e accessi social popolari come Google e GitHub.
- Outline serve come base di conoscenza per team in crescita.
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.
Prerequisiti
Per iniziare, assicurati di avere quanto segue:
- Un'istanza di Logto in esecuzione o accesso a un account Logto Cloud.
- Un ambiente di hosting di Outline con accesso alle variabili di ambiente.
Configura Logto
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.
Configura 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 |
Solo per hosting autonomo: Configura l'accesso email in Logto
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.
Punto di controllo: Testa l'integrazione tra Logto e Outline
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!