Viime kuussa julkaisimme virallisesti yhden kirjautumisen (SSO) ominaisuuden Logto-sovelluksessa. Tämä ominaisuus mahdollistaa sovelluksesi integroimisen minkä tahansa SSO-palveluntarjoajan kanssa, joka tukee OpenID Connect (OIDC) ja SAML-protokollaa Logton kautta. Yleisien OIDC- ja SAML SSO-liittimien lisäksi olemme tarjonneet joitakin sisäänrakennettuja yritys-SSO-liittimiä, mukaan lukien Okta, Azure AD ja Google Workspace. Tässä oppaassa näytämme, kuinka integroida Logto-sovelluksesi Okta SSO:n kanssa minuuteissa. ## Edellytykset Ennen kuin aloitamme, sinulla tulee olla Okta-tili. Jos sinulla ei ole sellaista, voit rekisteröityä ilmaiseksi Okta-kehittäjätiliksi [tässä](https://developer.okta.com/signup/). Tietenkin tarvitset myös Logto-tilin. Jos sinulla ei ole sitä, olet erittäin tervetullut rekisteröitymään Logto-tilille. Logto on ilmainen henkilökohtaiseen käyttöön. Kaikki ominaisuudet ovat saatavilla ilmaisille kehittäjäkäyttäjille, mukaan lukien SSO-ominaisuus. Hyvin integroitua Logto-sovellusta tarvitaan myös. Jos sinulla ei ole sellaista, seuraa [integraatio-opasta](https://docs.logto.io/docs/recipes/integrate-logto/) luodaksesi Logto-sovelluksen. ## Luo uusi Okta SSO -liitin Logtossa 1. Vieraile [Logto Cloud Console](https://cloud.logto.io) -sivullasi ja navigoi **Enterprise SSO** -sivulle. ![Logto Cloud Console](https://uploads.strapi.logto.io/1/enterprise_sso_2d489f2958.webp) 2. Klikkaa **Lisää yritys-SSO** -painiketta ja valitse **Okta** SSO-palveluntarjoajana. okta connector

Ennen kuin siirrymme seuraavaan vaiheeseen, meidän on kerättävä tietoja Okta-puolelta. ## Luo Okta-sovellus 1. Vieraile Okta-hallinnan portaalissa ja kirjaudu sisään ylläpitäjätilille. 2. Navigoi **Sovellukset** -välilehdelle, kaikki sovellukset löytyvät täältä. 3. Klikkaa **Lisää sovellus** -painiketta vasemmassa yläkulmassa aloittaaksesi uuden sovelluksen luontiprosessin. 4. Valitse **OIDC - OpenID Connect** kirjautumistavaksi ja **Web-sovellus** sovellustyypiksi. ![Luo Okta-sovellus](https://uploads.strapi.logto.io/1/create_application_d8a3828d98.webp) 5. Klikkaa **Seuraava** -painiketta siirtyäksesi seuraavaan vaiheeseen. ## Määritä Okta-sovellus 1. Täytä sovelluksen yleiset tiedot. | Kentän nimi | Kuvaus | | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | Nimi | Sovelluksen nimi. | | Logo | Sovelluksen logo. | | Grant Type | Sovelluksen tarjoustyyppi. Logto-asiakas käynnistää SSO-prosessin käyttäjän puolesta, käytä oletuksena **Valtuutuskoodi** -tarjoustyyppiä. | ![Sovelluksen Asetukset](https://uploads.strapi.logto.io/1/application_settings_498fed2a88.webp) 2. Täytä sovelluksen **Kirjautumisen uudelleenohjaus URIt**. Näitä URI:a käytetään ohjaamaan käyttäjä takaisin Logto-sovellukseen SSO-prosessin päätyttyä. Löydät uudelleenohjaus URI-arvon Logton Okta SSO -liitin sivun alareunasta. ![Uudelleenohjaus URI](https://uploads.strapi.logto.io/1/redirect_uri_431aa27fc7.webp) 3. Määritä käyttäjät sovellukseen. Okta tarjoaa muutamia tapoja hallita sovelluksen käyttöoikeutta. Voit määrittää kaikki käyttäjät Okta-organisaatiossa sovellukseen, tai voit määrittää sovelluksen tietyille ryhmille. ![Määritä käyttäjät](https://uploads.strapi.logto.io/1/assign_users_e6e1d99968.webp) 4. Klikkaa **Tallenna** -painiketta viimeistelläksesi sovelluksen luomisen. ## Määritä Okta SSO -liitin Logtossa 1. Kopioi **Asiakas ID** ja **Asiakas Salaisuus** Okta-sovelluksen sivulta ja liitä ne Logton Okta SSO-liittimen sivulle. ![Asiakas ID ja Asiakas Salaisuus](https://uploads.strapi.logto.io/1/client_credentials_68b35fdf49.webp) 2. Kopioi Okta-organisaatiosi URL ja liitä se Logton Okta SSO-liittimen sivulle **Liikkeellelaskijan URL**:na. Saatat löytää organisaation URL:n Okta-hallinnan portaalin oikeasta yläkulmasta. issuer

3. VAPAAEHTOINEN: Voit käyttää `Scope` -kenttää lisätäksesi ylimääräisiä laajuuksia OAuth-pyyntöösi. Tämä sallii pyytää enemmän tietoa Okta OAuth-palvelimelta. Ole hyvä ja viittaa [Okta dokumentaatioon](https://developer.okta.com/docs/reference/api/oidc/#scopes) saadaksesi enemmän tietoa saatavilla olevista laajuuksista. Riippumatta mukautetuista laajuusasetuksista, Logto lähettää aina `openid`, `profile` ja `email` laajuudet IdP:hen. Tämä on varmistaa, että Logto voi hakea käyttäjän henkilöllisyystiedot ja sähköpostiosoitteen oikein. 4. Navigoi **SSO-kokemus**-välilehdelle ja täytä **Yrityksen sähköpostidomain**-kenttä. Tämä mahdollistaa SSO-liittimen käyttöä autentikointimenetelmänä kyseisille käyttäjille. Esimerkiksi, jos täytät `logto.io` yrityksen sähköpostidomainiksi, kaikki käyttäjät, joiden sähköpostiosoite päättyy `@logto.io`, rajoitetaan käyttämään Okta SSO-liitintä kirjautuakseen Logto-sovellukseen. ![SSO-kokemus](https://uploads.strapi.logto.io/1/email_domain_c9ed10e8a5.webp) ## Ota SSO käyttöön Logto -sovelluksen kirjautumiskokemuksessa 1. Navigoi **Kirjautumiskokemus**-sivulle. 2. Klikkaa **Rekisteröityminen ja kirjautuminen** -välilehteä. 3. Vieritä alas osioon **ETEENPÄIN KEHITETYT ASETUKSET** ja ota käyttöön **Yritys SSO** -kytkin. ![Ota SSO käyttöön](https://uploads.strapi.logto.io/1/sie_config_14ed0d2a3f.webp) ## Testaa SSO-integraatiota Käytä kirjautumiskokemuksen live-esikatselua testataksesi SSO-integraatiota. Löydät live-esikatselupainikkeen **Kirjautumiskokemus esikatselu** -osion oikeasta yläkulmasta. Onnistunut SSO-integraatio ohjaa käyttäjän Okta-kirjautumissivulle. Kun käyttäjä on kirjautunut onnistuneesti, käyttäjä ohjataan takaisin Logto:n demo-sovellukseen.