Accedi per gli utenti della tua app

La tua app viene fornita con account

Le app basate su Kliv hanno i propri utenti: clienti, membri o colleghi di chiunque utilizzi il tuo prodotto. Ogni app riceve un sistema di accesso completo per quegli utenti, integrato fin dall'inizio. Non integri un provider di autenticazione né gestisci tu stesso l'archiviazione delle password: descrivi chi dovrebbe essere in grado di accedere e Kliv si occuperà del resto.

Una distinzione da tenere presente: questa pagina riguarda gli utenti della tua app. L'accesso per il tuo team, ovvero le persone che creano l'app con te su Kliv, incluso qualsiasi SSO aziendale usato dalla tua organizzazione, è separato ed è coperto in Gestione utenti.

Metodi di accesso

Gli utenti della tua app possono accedere con:

  • E-mail e password: l'account tradizionale con un indirizzo e-mail verificato
  • Accedi con Google e Accedi con Facebook: accesso social con un clic con un account già in loro possesso
  • Passkey (WebAuthn): accesso senza password utilizzando i dati biometrici del dispositivo o una chiave di sicurezza
  • Autenticazione a due fattori (TOTP): un codice basato sul tempo proveniente da un'app di autenticazione come secondo passaggio

Durante una conversazione, spiega a Kliv quali metodi dovrebbe offrire la tua app. "Consenti agli utenti di registrarsi tramite e-mail o Google e supportare le passkey" è sufficiente.

Organizzazioni e ruoli

Gli utenti non sono necessariamente un semplice elenco piatto. Gli utenti della tua app possono appartenere a organizzazioni e all'interno di un'organizzazione ogni utente ha un ruolo. Questa è la forma naturale dei prodotti del team e delle app B2B: un'azienda si iscrive, invita le sue persone e ciò che ogni persona può fare dipende dal suo ruolo. Descrivi i ruoli che ti servono e Kliv li imposta.

Accesso e accesso ai dati

L'accesso non è solo un cancello sulla porta: determina ciò che ogni utente può raggiungere. L'accesso ai dati segue le regole di sicurezza a livello di riga del database, quindi un utente che ha effettuato l'accesso legge e scrive solo le righe consentite da tali regole. Vedi Database per come funziona la sicurezza a livello di riga.

Lo stesso vale per gli agenti. Se la tua app include un agente, lo stato di accesso di un utente definisce l'ambito di ciò che l'agente può leggere per suo conto: un agente che risponde alla domanda di un utente non può attingere a righe che l'utente non può vedere. Vedi Agenti e i tuoi dati.

Usare le tue credenziali Google o Facebook

L’accesso con Google e Facebook funziona subito con le chiavi gestite da Kliv, senza registrare nulla presso il provider. Le tue chiavi sono facoltative: servono a far comparire il nome della tua app, anziché quello di Kliv, nella schermata di consenso del provider.

Se usi le tue chiavi, registra presso il provider un URI di reindirizzamento per ogni indirizzo da cui i visitatori accedono:

https://<indirizzo del tuo sito>/api/v2/auth/oauth/<provider>/complete

Ad esempio: https://example.com/api/v2/auth/oauth/google/complete. Ne serve uno per indirizzo: uno per ogni dominio personalizzato, più uno per l’indirizzo <chiave-sito>.kliv.site del tuo sito se i visitatori lo usano. Un indirizzo www che reindirizza al dominio principale non ne ha bisogno.

Non devi comporli a mano. In Impostazioni del sito → Accesso social → Usa le tue credenziali OAuth trovi gli URI esatti del tuo sito, ciascuno con un pulsante per copiarlo.

Dove aggiungerli:

  • Google: in Google Cloud Console, apri il tuo client OAuth e aggiungili in URI di reindirizzamento autorizzati (Authorized redirect URIs). Origini JavaScript autorizzate può restare vuoto.
  • Facebook: nella tua app sviluppatore Meta, apri le impostazioni di Facebook Login e aggiungili in URI di reindirizzamento OAuth validi (Valid OAuth Redirect URIs).

Accedi con Apple supporta solo le chiavi gestite da Kliv.

L’accesso dagli indirizzi di anteprima non funziona con le tue chiavi, quindi fai le prove sul sito pubblicato.

Documentazione correlata