Passo 1 | Inizia con l’SSO
Il Single Sign-On (SSO) consente alle persone di accedere alla tua app Base44 tramite un provider di identità esterno che supporta OpenID Connect (OIDC), come Google, Microsoft, GitHub, Okta, Apple o Kakao, invece di creare un login separato per la tua app. Per trovare l’ID della tua app Base44 e l’URI di reindirizzamento:- Vai all’editor della tua app in Base44.
- Controlla la barra degli indirizzi del browser e trova l’app ID tra
/apps/e/editor/nell’URL. - Costruisci il tuo URI di reindirizzamento sostituendo
{{APP_ID}}in questo formato con l’ID della tua app:https://app.base44.com/api/apps/{{APP_ID}}/auth/sso/callback
Esempio: dall'URL dell'app all'URI di reindirizzamento
Esempio: dall'URL dell'app all'URI di reindirizzamento
https://app.base44.com/apps/686404784ac37377589a1f7f/editor/...Qui, 686404784ac37377589a1f7f è l’app ID. Inseriscilo nel formato:https://app.base44.com/api/apps/686404784ac37377589a1f7f/auth/sso/callbackQuesto è l’URI di reindirizzamento che inserirai nel tuo provider SSO.- Quando scegli un provider, Base44 elenca ogni callback URL della tua app così puoi copiarli. Registra ciascuno nel tuo provider di identità come URI di reindirizzamento consentito. Alcuni provider, come ClassLink, rifiutano un accesso quando l’URI di reindirizzamento non corrisponde esattamente a un valore registrato.
- Per impostazione predefinita, un accesso SSO passa attraverso
app.base44.comanche quando la tua app ha un dominio personalizzato. Per mantenerlo sul tuo dominio, attiva Use this app’s custom domain as the SSO callback. È disattivato per impostazione predefinita, e ti serve un dominio personalizzato verificato nella scheda Domains prima di poterlo attivare. Quando lo attivi, registra anche il callback URL del dominio personalizzato nel tuo provider. - La maggior parte dei provider, inclusi Google, Microsoft e Okta, funziona con l’impostazione predefinita. Attiva il callback del dominio personalizzato per i provider che richiedono che l’URI di reindirizzamento corrisponda al tuo dominio, come ClassLink, Clever e le policy Azure o Entra più restrittive.
- Se la tua app usa il provider SSO del workspace invece del proprio, Base44 mostra un callback URL per il login delle app del workspace. Chiedi all’admin del workspace di aggiungere quell’URL al provider di identità del workspace. Scopri di più su come imporre l’SSO su tutte le app del workspace.
Passo 2 | Scegli il tuo provider
Inizia scegliendo il provider di identità che il tuo team utilizza già. Puoi selezionare un’opzione integrata (Google, Microsoft, GitHub o Okta), oppure usare la configurazione avanzata / manuale per collegare qualsiasi provider OIDC, incluso Kakao, o il tuo IdP.Google Workspace
Microsoft 365 / Entra ID
GitHub
Okta
Configurazione avanzata / manuale
Google Workspace
Usa Google Workspace come provider SSO con un’applicazione Web OAuth 2.0. Prima crea un client OAuth 2.0 nella Google Cloud Console per il tuo progetto, poi aggiungi le credenziali in Base44. Per configurare l’SSO di Google Workspace in Base44:- Fai clic su Dashboard nell’editor della tua app.
- Fai clic su Settings.
- Fai clic su Authentication.
- Fai clic su Set Up accanto a Single sign-on (SSO).
- In Select SSO Provider, scegli Google Workspace.
- Inserisci il tuo Client ID e Client Secret di Google.
- Mantieni Scope come
openid email profile. - Lascia Discovery URL impostato sul valore predefinito.
- Fai clic su Enable SSO.

Impostazioni SSO di Google Workspace nella tua app Base44
Microsoft
Usa Microsoft Entra ID (Azure AD) come provider SSO tramite il tuo portale Azure. Per configurare l’SSO per un intero workspace enterprise anziché per una singola app, consulta SSO per Microsoft Entra ID. Base44 supporta configurazioni Microsoft sia single-tenant sia multi-tenant. Il valore inserito nel campo Tenant ID determina quali account possono accedere. Per configurare l’SSO di Microsoft in Base44:- Fai clic su Dashboard nell’editor della tua app.
- Fai clic su Settings.
- Fai clic su Authentication.
- Fai clic su Set Up accanto a Single sign-on (SSO).
- In Select SSO Provider, scegli Microsoft Azure AD.
- Inserisci il Client ID di Azure (Application (client) ID) e il Client Secret.
- Nel campo Tenant ID, inserisci un valore in base agli account che vuoi consentire:
- Il tuo directory (tenant) ID di Azure: Solo persone della tua organizzazione.
common: Account Microsoft personali e account di lavoro/scuola (Microsoft 365).organizations: Solo account di lavoro e scuola (Microsoft 365).
- Mantieni Scope come
openid email profile. - Il campo Discovery URL si compila automaticamente in base al tenant ID inserito. Verifica che sia corretto prima di continuare.
- Fai clic su Enable SSO.

Impostazioni SSO di Microsoft Azure AD nella tua app Base44
GitHub
Usa un’app OAuth di GitHub come provider SSO. Crea un’app OAuth nelle GitHub Developer Settings, poi collegala in Base44. Per configurare l’SSO di GitHub in Base44:- Fai clic su Dashboard nell’editor della tua app.
- Fai clic su Settings.
- Fai clic su Authentication.
- Fai clic su Set Up accanto a Single sign-on (SSO).
- In Select SSO Provider, scegli GitHub.
- Inserisci il tuo Client ID e Client Secret di GitHub.
- Mantieni Scope come
user:email. - Mantieni i valori predefiniti di Auth Endpoint, Token Endpoint e Userinfo Endpoint per GitHub.
- Fai clic su Enable SSO.

Impostazioni SSO di GitHub nella tua app Base44
Okta
Usa Okta come provider SSO. Nella Okta Admin Console, crea un’applicazione Web OIDC per la tua app Base44, poi aggiungi le credenziali in Base44. Per configurare l’SSO di Okta in Base44:- Fai clic su Dashboard nell’editor della tua app.
- Fai clic su Settings.
- Fai clic su Authentication.
- Fai clic su Set Up accanto a Single sign-on (SSO).
- In Select SSO Provider, scegli Okta.
- Inserisci quanto segue:
- Client ID: Il tuo client ID di Okta.
- Client Secret: Il tuo client secret di Okta.
- Okta Domain: Inseriscilo nella forma che corrisponde alla tua organizzazione Okta:
- Il tuo sottodominio Okta, ad esempio
your-company. - Il tuo dominio URL Okta personalizzato completo, ad esempio
login.your-company.com. - L’issuer URL incluso il percorso del server di autorizzazione, ad esempio
https://login.your-company.com/oauth2/default, se la tua organizzazione Okta usa API Access Management con server di autorizzazione personalizzati.
- Il tuo sottodominio Okta, ad esempio
- Scope: Mantieni
openid email profile. - Discovery URL: Viene generato dal tuo dominio Okta e contrassegnato come Auto. Puoi modificarlo se devi puntare Base44 altrove, e allora viene mostrato come Modified. Per tornare al valore generato, fai clic su Reset to auto.
- Fai clic su Enable SSO.

Impostazioni SSO di Okta nella tua app Base44
Advanced / Manual Configuration
Usa Advanced / Manual Configuration per collegare qualsiasi provider di identità compatibile con OIDC non coperto dalle opzioni integrate. Sono inclusi provider come Kakao, purché supportino OIDC e li configuri con i dati corretti forniti dal tuo provider. Per configurare la modalità Advanced / Manual Configuration in Base44:- Fai clic su Dashboard nell’editor della tua app.
- Fai clic su Settings.
- Fai clic su Authentication.
- Fai clic su Set Up accanto a Single sign-on (SSO).
- In Select SSO Provider, scegli Advanced / Manual Configuration.
- Compila i seguenti campi con i valori del tuo provider:
- Name: Un nome per questa configurazione SSO (ad esempio,
Auth0,Keycloak,Kakaoo il nome del tuo provider di identità). - Client ID: Il tuo client ID OIDC.
- Client Secret: Il tuo client secret OIDC.
- Scope: Inserisci
openid email profile. - Discovery URL: Il discovery URL del tuo provider, se disponibile.
- Auth Endpoint, Token Endpoint, Userinfo Endpoint, Jwks Uri: Se non usi un discovery URL, incolla ciascun endpoint dalla documentazione del tuo provider.
- Name: Un nome per questa configurazione SSO (ad esempio,
- (Facoltativo) Disattiva una di queste impostazioni se il tuo provider la rifiuta. Entrambe sono attive per impostazione predefinita:
- Use PKCE (recommended): Aggiunge la challenge PKCE standard di OAuth 2.1 all’accesso. Disattivalo solo per i provider che rifiutano parametri OAuth sconosciuti, come ClassLink o i deployment Shibboleth e ADFS più vecchi.
- Request offline access: Chiede al tuo provider un refresh token. Disattivalo solo per i provider che lo rifiutano, come quelli sopra. Non ha effetto per i provider che usano
response_mode=form_post, come Apple.
- Fai clic su Enable SSO.

Configurazione SSO Advanced / Manual nella tua app Base44
Passo 3 | Testa l’accesso SSO
Dopo aver configurato l’SSO, accedi alla tua app con l’SSO per verificare che tutto funzioni. Per testare l’accesso SSO:- Esci dalla tua app se hai già effettuato l’accesso.
- Vai alla schermata di accesso della tua app.
- Fai clic su Log in with SSO o seleziona il provider che hai configurato.
- Accedi usando un indirizzo email di un dominio approvato.
Concessione automatica dell’accesso alla tua app
Concedi alle persone l’accesso alla tua app non appena effettuano l’accesso tramite SSO, senza invito. L’ammissione automatica è un’impostazione per singola app che sovrascrive il valore predefinito del workspace. È disattivata per impostazione predefinita. Per impostare il valore predefinito del workspace per tutte le app private solo SSO, consulta concessione automatica dell’accesso alle app private. Per concedere automaticamente l’accesso alla tua app:- Fai clic su Dashboard nell’editor della tua app.
- Fai clic su Settings.
- Fai clic su Authentication.
- Accanto al tuo provider SSO, fai clic su Configure.
- Attiva o disattiva Auto-admit SSO users.
- Fai clic su Save SSO Settings, oppure Enable SSO se l’app usa il provider SSO del workspace.
- Disattivare l’ammissione automatica impedisce l’accesso a nuove persone. Non rimuove chi ha già accesso. Per impedire a qualcuno di accedere di nuovo, rimuovilo o sospendilo nel tuo provider di identità.
- Se il tuo workspace impone l’SSO su tutte le app, Auto-admit SSO users ha effetto immediato. Se l’impostazione è disabilitata, verifica che l’app sia privata e che l’SSO sia l’unico metodo di accesso abilitato.
Offrire altri metodi di accesso
Un’app che usa l’SSO può permettere di accedere anche con Google, Microsoft, Facebook, Apple o email e password. Usalo quando un’app serve persone dentro e fuori dalla tua azienda. Per esempio, il tuo staff accede tramite l’identity provider aziendale. Clienti, pazienti o collaboratori senza un account aziendale accedono invece con Google. Scegli i domini email che devono continuare a usare l’SSO, come il dominio della tua azienda. Chi ha un’email su uno di questi domini può accedere solo con l’SSO. Tutti gli altri possono usare qualsiasi metodo di accesso offerto dalla tua app. Puoi farlo dopo aver configurato e attivato l’SSO per la tua app. Questa opzione è disattivata per impostazione predefinita. Per offrire altri metodi di accesso insieme all’SSO:- Vai all’editor della tua app.
- Clicca Dashboard.
- Clicca Settings.
- Clicca Authentication.
-
In Single sign-on (SSO), digita un dominio in Email domains that must use SSO, poi premi Invio. Ripeti per ogni dominio, inclusi i sottodomini come
mail.example.com, che non corrispondono aexample.com. -
Attiva Allow other sign-in methods alongside SSO.

Consentire altri metodi di accesso insieme all'SSO
- Attiva ogni metodo di accesso che vuoi offrire insieme all’SSO, come Google o email e password.
- (Facoltativo) Se la tua app usa pagine di login personalizzate, clicca Send to chat in Single sign-on (SSO). L’IA aggiunge alle pagine di login e registrazione il pulsante SSO e un pulsante per ogni metodo di accesso che hai attivato.
- Per smettere di offrire altri metodi di accesso, disattiva Allow other sign-in methods alongside SSO. L’accesso con Google, Microsoft, Facebook e Apple smette di funzionare, quindi chi si è registrato con uno di questi non può più accedere in quel modo. L’accesso con email e password continua a funzionare finché è attivo: disattivalo anche se vuoi che l’SSO sia l’unico modo per entrare. Se rimuovi tutti i domini dall’elenco, Base44 disattiva l’impostazione per te.
- Se qualcuno con un’email su uno dei tuoi domini prova un altro metodo di accesso, vede un messaggio che gli chiede di accedere con l’SSO.
- Chi ha già effettuato l’accesso resta connesso quando modifichi questa impostazione.
Scope e dati dell’utente
Quando qualcuno accede con l’SSO, Base44 legge alcuni dati dal tuo provider di identità. Li usa per creare il record utente nella tua app. Sapere cosa legge Base44 ti aiuta a scegliere gli scope e a pianificare come la tua app gestisce i ruoli.Scegliere gli scope
Base44 invia il campo Scope al tuo provider esattamente come lo inserisci. Base44 ha bisogno dell’indirizzo email di ogni persona. Includi quindi sempre gli scope che lo restituiscono:openid email profile per i provider OIDC o user:email per GitHub.
Puoi aggiungere qualsiasi altro scope consentito dal tuo provider, come uno scope per una delle sue API. Gli scope aggiuntivi non cambiano ciò che Base44 salva sulla persona. Sono utili quando le funzioni backend della tua app chiamano il provider con l’access token della persona. Lo ottieni con il modulo SSO dell’SDK.
Dati salvati da Base44
Base44 salva solo 2 dati del tuo provider nel record utente della persona: email e nome. Non salva nient’altro, come immagini del profilo, gruppi, ruoli o claim personalizzati, e non puoi configurare mappature personalizzate. Il ruolo di una persona nella tua app viene sempre da Base44, ad esempio il ruolo che le assegni quando la inviti.- Email: Obbligatoria. Base44 legge il claim
emaildall’ID token, oppure dall’endpoint userinfo del provider se l’ID token non lo include. Per Microsoft Entra, Base44 usa lo user principal name della persona quando manca il claimemaile si tratta di un indirizzo email. Se Base44 non trova un’email, l’accesso fallisce conEmail not returned by OAuth provider. - Nome: Base44 legge il claim
name, oppure il nome o lo username GitHub, e lo salva come nome completo della persona. Se manca un nome, Base44 usa la parte dell’email prima della @. Il nome viene salvato solo al primo accesso, quindi le modifiche successive nel provider non lo aggiornano.
FAQ
Fai clic su una domanda per saperne di più sull’SSO.Devo configurare l'SSO se uso un solo login?
Devo configurare l'SSO se uso un solo login?
Cos'è un URI di reindirizzamento e dove lo uso?
Cos'è un URI di reindirizzamento e dove lo uso?
https://app.base44.com/api/apps/{{APP_ID}}/auth/sso/callback{{APP_ID}} con l’ID effettivo della tua app Base44.Cos'è un discovery URL e devo aggiungerlo?
Cos'è un discovery URL e devo aggiungerlo?
- Per Google, non devi inserire un discovery URL. Base44 lo gestisce automaticamente.
- Per Microsoft (Azure / Entra ID), il discovery URL si compila automaticamente in base al tenant ID inserito. Il formato è
https://login.microsoftonline.com/{TENANT_ID}/v2.0/.well-known/openid-configuration, dove{TENANT_ID}è il tuo directory tenant ID,commonoorganizations. - Per Okta, il discovery URL si compila automaticamente dal tuo sottodominio, ma molte configurazioni richiedono un URL diverso (di solito nel formato
/oauth2/default) affinché Okta restituisca la tua email. Consulta le note di configurazione Okta per il formato esatto. - Per GitHub, puoi lasciare vuoto il campo discovery URL.
- Per i provider Advanced / Manual come Kakao, segui la documentazione del tuo provider. Se ti forniscono un discovery URL, incollalo nel campo Discovery URL. In caso contrario, inserisci i singoli endpoint.
Cosa faccio se vedo un errore durante l'accesso via SSO?
Cosa faccio se vedo un errore durante l'accesso via SSO?
- Il tuo redirect URI in Base44 corrisponde esattamente a quello nella dashboard del tuo provider.
- Il tuo client ID, il client secret e il discovery URL, se ne usi uno, sono corretti.
- Lo scope è
openid email profile, o uno scope email equivalente, sia nella configurazione del tuo provider sia in Base44.
Perché il login Google mostra ancora "base44.com" invece del nome della mia app dopo aver configurato l'SSO personalizzato?
Perché il login Google mostra ancora "base44.com" invece del nome della mia app dopo aver configurato l'SSO personalizzato?
base44.com come nome o badge dell’app, il tuo progetto Google personalizzato non è ancora stato approvato del tutto. Una volta approvato il progetto da Google, appare il nome o il branding della tua app invece di base44.com.Come posso assicurarmi che il nome della mia app appaia nel login Google invece di "base44.com"?
Come posso assicurarmi che il nome della mia app appaia nel login Google invece di "base44.com"?
base44.com.Quali applicazioni usano comunemente SSO o OAuth?
Quali applicazioni usano comunemente SSO o OAuth?