• auth
  • authentication
  • identity
  • integration
  • outline
  • oidc
  • oauth

Förenkla Outline-autentisering med Logto

I den här artikeln kommer vi att visa hur man använder Logto som en OpenID Connect (OIDC) identitetsleverantör för Outline.

Gao
Gao
Founder

Introduktion

  • Logto är en enkel identitetslösning med alla funktioner du behöver. Den stöder olika inloggningsmetoder, inklusive användarnamn, e-post, telefonnummer och populära sociala inloggningar som Google och GitHub.
  • Outline fungerar som en kunskapsbas för växande team.

Det bästa är att både Logto och Outline är öppen källkod. I den här artikeln kommer vi att visa hur man använder Logto som en OpenID Connect (OIDC) identitetsleverantör för Outline.

Förutsättningar

För att komma igång, se till att du har följande:

  • En fungerande Logto-instans eller tillgång till ett Logto Cloud-konto.
  • En Outline-värdmiljö med tillgång till miljövariabler.

Konfigurera Logto

Om du själv värdar Logto, hänvisa till Logtos "Kom igång"-dokumentation för att ställa in din Logto-instans.

Öppna Logto Console genom att ange URL:en https://cloud.logto.io/ om du använder Logto Cloud, eller den slutpunkt du har ställt in för egenvärd.

Navigera sedan till fliken "Applications" och klicka på "Create application".

Applications tab

I modalen som visas, välj "Traditional Web" och ange ett applikationsnamn, såsom "Outline". Klicka sedan på "Create application".

Create application

Du kommer att riktas till en tutorialsida i Logto. Klicka på "Skip" längst upp till höger för att fortsätta till sidan med applikationsdetaljer.

Applications details

I sektionen "Redirect URIs", ange följande värde:

Till exempel, om du värdar Outline på http://localhost:3000, ska värdet vara:

Save changes

Klicka på knappen "Save Changes" längst ner. När det är klart, håll denna sida öppen då den kommer att vara användbar för Outline-konfigurationen.

Konfigurera Outline

Följ stegen som beskrivs i Outline-värdguiden tills du når autentiseringskonfigurationssteget. Eftersom Outline stöder OIDC-kompatibla autentiseringsleverantörer som standard, kan du enkelt hitta de flesta av de nödvändiga konfigurationsvärdena på Logto-applikationsdetaljsidan.

Se följande tabell för de nödvändiga konfigurationsdetaljerna:

Outline miljövariabelLogto displaynamn
OIDC_CLIENT_IDApp ID
OIDC_CLIENT_SECRETApp Secret
OIDC_AUTH_URIAuthorization Endpoint
OIDC_TOKEN_URIToken Endpoint
OIDC_USERINFO_URIUserinfo Endpoint

Här är en annan tabell som innehåller ytterligare variabler:

Outline miljövariabelBeskrivning
OIDC_USERNAME_CLAIMSätt till användarnamn
OIDC_DISPLAY_NAMEValfri - anpassa efter behov
OIDC_SCOPESBehåll standard; behöver inte sättas

Endast själv-värd: Konfigurera e-postinloggning i Logto

Eftersom Outline kräver att användares e-post tillhandahålls, behöver du konfigurera e-postinloggning eller en social inloggning som tillhandahåller pålitlig e-postadress, såsom Google-inloggning.

Se Konfigurera connectors för att lära dig mer om att konfigurera connectors i Logto.

Kontrollpunkt: Testa Logto och Outline-integration

Starta Outline-instansen och gå till dess slutpunkt. Du bör se en knapp i mitten märkt "Continue with OpenID Connect"; den kan anpassas genom att ställa in miljövariabel OIDC_DISPLAY_NAME.

Outline sign-in page

Klicka på knappen, och du kommer att dirigera till Logto-inloggningsupplevelsen.

Logto sign-in experience

Om allt har konfigurerats korrekt, när du slutför inloggnings- eller registreringsprocessen i Logto, kommer du att omdirigeras tillbaka till Outline. Du kan sedan se din personliga information visas i det nedre vänstra hörnet av sidan.

Outline home

Om du stöter på några problem under integrationen, tveka inte att kontakta oss via e-post på [email protected] eller gå med i vår Discord-server!

Vidare läsning