Connexion pour les utilisateurs de votre application

Votre application inclut des comptes

Les applications construites sur Kliv ont leurs propres utilisateurs : les clients, membres ou collègues de ceux qui utilisent votre produit. Chaque application dispose d'un système de connexion complet pour ces utilisateurs, intégré dès le départ. Vous n'avez pas à intégrer un fournisseur d'authentification ni à gérer vous-même le stockage des mots de passe : décrivez qui doit pouvoir se connecter, et Kliv s'occupe du reste.

Une distinction à garder en tête : cette page concerne les utilisateurs de votre application. La connexion de votre propre équipe (les personnes qui construisent l'application avec vous sur Kliv, y compris le SSO d'entreprise que votre organisation utilise éventuellement) est distincte et décrite dans Gestion des utilisateurs.

Méthodes de connexion

Les utilisateurs de votre application peuvent se connecter avec :

  • E-mail et mot de passe : le compte classique avec une adresse e-mail vérifiée
  • Se connecter avec Google et Se connecter avec Facebook : connexion sociale en un clic avec un compte qu'ils possèdent déjà
  • Passkeys (WebAuthn) : connexion sans mot de passe grâce à la biométrie de l'appareil ou à une clé de sécurité
  • Authentification à deux facteurs (TOTP) : un code temporel généré par une application d'authentification comme seconde étape

Dites à Kliv dans la conversation quelles méthodes votre application doit proposer. « Permets aux utilisateurs de s'inscrire avec e-mail ou Google, et prends en charge les passkeys » suffit.

Organisations et rôles

Les utilisateurs n'ont pas à former une liste à plat. Ceux de votre application peuvent appartenir à des organisations, et au sein d'une organisation chaque utilisateur a un rôle. C'est la structure naturelle des produits d'équipe et des applications B2B : une entreprise s'inscrit, invite ses collaborateurs, et ce que chacun peut faire découle de son rôle. Décrivez les rôles dont vous avez besoin et Kliv les met en place.

Connexion et accès aux données

La connexion n'est pas qu'un portail à l'entrée : elle détermine ce que chaque utilisateur peut atteindre. L'accès aux données suit les règles de sécurité au niveau des lignes de votre base de données, de sorte qu'un utilisateur connecté ne lit et n'écrit que les lignes autorisées par ces règles. Voir Base de données pour le fonctionnement de la sécurité au niveau des lignes.

Il en va de même pour les agents. Si votre application inclut un agent, l'état de connexion d'un utilisateur délimite ce que l'agent peut lire en son nom : un agent qui répond à la question d'un utilisateur ne peut pas puiser dans des lignes que cet utilisateur ne pourrait pas voir lui-même. Voir Les agents et vos données.

Utiliser vos propres identifiants Google ou Facebook

La connexion avec Google et Facebook fonctionne immédiatement avec les clés gérées par Kliv, sans rien enregistrer auprès du fournisseur. Vos propres clés sont facultatives : elles permettent d’afficher le nom de votre application, et non celui de Kliv, sur l’écran de consentement du fournisseur.

Si vous utilisez vos propres clés, enregistrez auprès du fournisseur un URI de redirection pour chaque adresse sur laquelle les visiteurs se connectent :

https://<adresse de votre site>/api/v2/auth/oauth/<fournisseur>/complete

Par exemple : https://example.com/api/v2/auth/oauth/google/complete. Il en faut un par adresse : un pour chaque domaine personnalisé, plus un pour l’adresse <clé-du-site>.kliv.site de votre site si les visiteurs l’utilisent. Une adresse www qui redirige vers votre domaine principal n’en a pas besoin.

Inutile de les composer vous-même : Paramètres du site → Connexion sociale → Utilisez vos identifiants OAuth affiche les URI exacts de votre site, chacun avec un bouton de copie.

Où les ajouter :

  • Google : dans Google Cloud Console, ouvrez votre client OAuth et ajoutez-les sous URI de redirection autorisés (Authorized redirect URIs). Origines JavaScript autorisées peut rester vide.
  • Facebook : dans votre application développeur Meta, ouvrez les paramètres de Facebook Login et ajoutez-les sous URI de redirection OAuth valides (Valid OAuth Redirect URIs).

« Se connecter avec Apple » ne prend en charge que les clés gérées par Kliv.

La connexion sur les adresses d’aperçu ne fonctionne pas avec vos propres clés : testez-la sur votre site publié.

Documentation associée