Il mese scorso abbiamo rilasciato ufficialmente la funzione di single sign-on (SSO) su Logto. Questa funzione ti consente di integrare la tua applicazione con qualsiasi provider SSO che supporta i protocolli OpenID Connect (OIDC) e SAML attraverso Logto. Oltre ai connettori SSO generici OIDC e SAML, abbiamo fornito alcuni connettori SSO aziendali incorporati, tra cui Okta, Azure AD e Google Workspace. In questo tutorial, ti mostreremo come integrare la tua applicazione Logto con Okta SSO in pochi minuti. ## Prerequisiti Prima di iniziare, devi avere un account Okta. Se non ne hai uno, puoi registrarti per un account sviluppatore Okta gratuito [qui](https://developer.okta.com/signup/). Ovviamente, devi anche avere un account Logto. Se non ne hai uno, sei molto benvenuto a registrarti per un account Logto. Logto è gratuito per uso personale. Tutte le funzionalità sono disponibili per i tenant di sviluppo gratuito, inclusa la funzione SSO. È necessaria anche un'applicazione Logto ben integrata. Se non ne hai una, segui la [guida all'integrazione](https://docs.logto.io/docs/recipes/integrate-logto/) per creare un'applicazione Logto. ## Crea un nuovo connettore SSO Okta in Logto 1. Visita la tua [Logto Cloud Console](https://cloud.logto.io) e naviga alla pagina **Enterprise SSO**. ![Logto Cloud Console](https://uploads.strapi.logto.io/1/enterprise_sso_2d489f2958.webp) 2. Clicca il pulsante **Aggiungi Enterprise SSO** e seleziona **Okta** come provider SSO. okta connector

Prima di procedere al passo successivo, dobbiamo raccogliere alcune informazioni da parte di Okta. ## Crea un'applicazione Okta 1. Visita il portale amministrativo Okta ed effettua l'accesso a un account amministratore. 2. Naviga alla scheda **Applicazioni**, tutte le applicazioni saranno elencate qui. 3. Clicca il pulsante **Aggiungi Applicazione** in alto a sinistra per iniziare una nuova sessione di creazione dell'applicazione. 4. Seleziona **OIDC - OpenID Connect** come metodo di accesso e **Applicazione Web** come tipo di applicazione. ![Crea applicazione Okta](https://uploads.strapi.logto.io/1/create_application_d8a3828d98.webp) 5. Clicca il pulsante **Avanti** per procedere al passaggio successivo. ## Configura l'applicazione Okta 1. Compila le informazioni generali dell'applicazione. | Nome Campo | Descrizione | | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | Nome | Il nome dell'applicazione. | | Logo | Il logo dell'applicazione. | | Tipo di concessione | Il tipo di concessione dell'applicazione. Il client Logto avvierà un flusso SSO per conto di un utente, usa il tipo di concessione predefinito **Codice di Autorizzazione**. | ![Impostazioni Applicazione](https://uploads.strapi.logto.io/1/application_settings_498fed2a88.webp) 2. Compila gli **URL di reindirizzamento di accesso** dell'applicazione. Questi URL vengono utilizzati per reindirizzare l'utente all'applicazione Logto dopo che il flusso SSO è stato completato. Puoi trovare il valore dell'URI di reindirizzamento in fondo alla pagina del connettore SSO Okta di Logto. ![URI di reindirizzamento](https://uploads.strapi.logto.io/1/redirect_uri_431aa27fc7.webp) 3. Assegna gli utenti all'applicazione. Okta fornisce diversi modi per controllare l'accesso all'applicazione. Puoi assegnare l'applicazione a tutti gli utenti dell'organizzazione Okta, oppure puoi assegnare l'applicazione a un gruppo specifico. ![Assegna utenti](https://uploads.strapi.logto.io/1/assign_users_e6e1d99968.webp) 4. Clicca il pulsante **Salva** per completare la creazione dell'applicazione. ## Configura il connettore SSO Okta in Logto 1. Copia **Client ID** e **Client Secret** dalla pagina dell'applicazione Okta e incollali nella pagina del connettore SSO Okta di Logto. ![Client ID e Client Secret](https://uploads.strapi.logto.io/1/client_credentials_68b35fdf49.webp) 2. Copia il tuo URL dell'organizzazione Okta e incollalo nella pagina del connettore SSO Okta di Logto come **Issuer URL**. Puoi trovare l'URL dell'organizzazione nell'angolo in alto a destra del portale amministrativo Okta. issuer

3. FACOLTATIVO: Puoi utilizzare il campo `Scope` per aggiungere ambiti aggiuntivi alla tua richiesta OAuth. Questo ti consentirà di richiedere più informazioni al server OAuth di Okta. Ti preghiamo di consultare la [documentazione di Okta](https://developer.okta.com/docs/reference/api/oidc/#scopes) per maggiori dettagli sugli ambiti disponibili. Indipendentemente dalle impostazioni degli ambiti personalizzati, Logto invierà sempre gli ambiti `openid`, `profile` e `email` all'IdP. Questo per garantire che Logto possa recuperare correttamente le informazioni sull'identità dell'utente e l'indirizzo email. 4. Naviga alla scheda **Esperienza SSO** e compila il campo **Dominio email aziendale**. Questo abiliterà il connettore SSO come metodo di autenticazione per quegli utenti. Ad esempio, se compili `logto.io` come dominio email aziendale, tutti gli utenti con un indirizzo email che termina con `@logto.io` saranno obbligati a utilizzare il connettore SSO Okta per accedere all'applicazione Logto. ![Esperienza SSO](https://uploads.strapi.logto.io/1/email_domain_c9ed10e8a5.webp) ## Abilita il SSO nell'esperienza di accesso di Logto 1. Naviga alla pagina **Esperienza di Accesso**. 2. Clicca sulla scheda **Registrati e accedi**. 3. Scorri verso il basso alla sezione **OPZIONI AVANZATE** e abilita l'interruttore **Enterprise SSO**. ![Abilita SSO](https://uploads.strapi.logto.io/1/sie_config_14ed0d2a3f.webp) ## Testa l'integrazione SSO Utilizza l'anteprima dal vivo dell'esperienza di accesso per testare l'integrazione SSO. Puoi trovare il pulsante di anteprima dal vivo in alto a destra nella sezione **Anteprima Esperienza di Accesso**. Un'integrazione SSO riuscita reindirizzerà l'utente alla pagina di accesso Okta. Dopo che l'utente ha effettuato l'accesso con successo, sarà reindirizzato di nuovo all'app demo di Logto.