In dit artikel laten we zien hoe je Logto kunt gebruiken als een OpenID Connect (OIDC) identiteit provider voor Outline.
Het beste deel is dat zowel Logto als Outline open-source zijn. In dit artikel laten we zien hoe je Logto kunt gebruiken als een OpenID Connect (OIDC) identiteit provider voor Outline.
Om te beginnen, zorg ervoor dat je het volgende hebt:
Als je Logto zelf host, raadpleeg dan de Logto "Aan de slag"-documentatie om je Logto-instantie op te zetten.
Open de Logto Console door de URL https://cloud.logto.io/ in te voeren als je Logto Cloud gebruikt, of de endpoint die je hebt ingesteld voor zelfhosting.
Navigeer vervolgens naar het tabblad "Toepassingen" en klik op "Toepassing maken".
In het modaal dat verschijnt, kies "Traditionele Web" en geef een toepassingsnaam op, zoals "Outline". Klik vervolgens op "Toepassing maken”.
Je wordt doorgestuurd naar een tutorialpagina in Logto. Klik op "Overslaan" in de rechterbovenhoek om door te gaan naar de pagina met toepassingsdetails.
Voer in de sectie "Redirect-URI's" de volgende waarde in:
Bijvoorbeeld, als je Outline host op http://localhost:3000, moet de waarde zijn:
Klik op de knop "Wijzigingen opslaan" onderaan. Zodra dit is gelukt, houd deze pagina open omdat het nuttig zal zijn voor de Outline-configuratie.
Volg de stappen beschreven in de Outline hosting handleiding totdat je de laatste stap van de authenticatieconfiguratie bereikt. Aangezien Outline standaard OIDC-compatibele authenticatieproviders ondersteunt, kun je de meeste vereiste configuratiewaarden eenvoudig vinden op de Logto-toepassingsdetailpagina.
Zie de volgende tabel voor de benodigde configuratiedetails:
| Outline Omgevingsvariabele | Logto Weergavenaam |
|---|---|
| OIDC_CLIENT_ID | App ID |
| OIDC_CLIENT_SECRET | App Secret |
| OIDC_AUTH_URI | Autorisatie-eindpunt |
| OIDC_TOKEN_URI | Token-eindpunt |
| OIDC_USERINFO_URI | Gebruikersinfo-eindpunt |
Hier is nog een tabel met aanvullende variabelen:
| Outline Omgevingsvariabele | Omschrijving |
|---|---|
| OIDC_USERNAME_CLAIM | Ingesteld op gebruikersnaam |
| OIDC_DISPLAY_NAME | Optioneel - pas naar behoefte aan |
| OIDC_SCOPES | Houd standaard; geen noodzaak om in te stellen |
Aangezien Outline vereist dat gebruikers een e-mail verstrekken, moet je e-mailinloggen configureren of een sociale inlog die een betrouwbare e-mailadres biedt, zoals Google-sign-in.
Zie Verbinders configureren om meer te leren over het configureren van verbindingsstukken in Logto.
Start de Outline-instantie en krijg toegang tot het eindpunt. Je zou in het midden een knop moeten zien met de tekst "Doorgaan met OpenID Connect"; deze kan worden aangepast door de OIDC_DISPLAY_NAME omgevingsvariabele in te stellen.
Klik op de knop en je wordt doorgestuurd naar de Logto inlogervaring.
Als alles correct is geconfigureerd, zul je, zodra je het inlog- of registratieproces in Logto hebt voltooid, worden teruggeleid naar Outline. Je kunt dan je persoonlijke informatie in de linkerbenedenhoek van de pagina zien.
Als je problemen tegenkomt tijdens de integratie, aarzel dan niet om contact met ons op te nemen via e-mail op [email protected] of sluit je aan bij onze Discord-server!