Clerk Auth donne à votre application son propre système d’authentification dédié propulsé par Clerk. Contrairement à Replit Auth, qui utilise le système de connexion de Replit et crée des comptes Replit, Clerk Auth provisionne un tenant Clerk séparé pour votre application. Les utilisateurs de votre application créent des comptes directement dans votre application — pas des comptes Replit — et vous avez un contrôle total sur la marque, les méthodes de connexion et l’expérience de connexion.Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
Clerk Auth vs. Replit Auth — Avec Clerk Auth (cette page), votre application obtient son propre tenant d’authentification avec une marque entièrement personnalisable et des comptes utilisateurs indépendants de Replit. Avec Replit Auth, les utilisateurs se connectent avec des comptes Replit et voient des pages de connexion à la marque Replit. Choisissez Clerk Auth lorsque vous souhaitez votre propre marque sur l’expérience de connexion ou lorsque vous avez besoin de comptes utilisateurs séparés de Replit.
Clerk Auth vs. Replit Auth en un coup d’œil
| Clerk Auth | Replit Auth | |
|---|---|---|
| Comptes utilisateurs | Les utilisateurs créent des comptes dans votre application (aucun compte Replit requis) | Les utilisateurs se connectent avec un compte Replit |
| Marque | Entièrement personnalisable — nom, icône et couleurs de votre application | Page de connexion à la marque Replit |
| Identifiants SSO | Apportez vos propres identifiants OAuth par fournisseur | Utilise les applications OAuth partagées de Replit |
| Environnements | Environnements de Développement et de Production séparés | Environnement unique |
| Parrainages | Pas d’intégration de parrainage Replit | Les inscriptions comptent dans les Parrainages Replit |
| Idéal pour | Applications à marque personnalisée, produits professionnels/commerciaux | Configuration rapide, applications où la marque Replit est acceptable |
Démarrage
Pour ajouter Clerk Auth à votre application, incluez-le dans votre invite Agent :Comment Clerk Auth fonctionne avec Replit
Lorsqu’Agent configure Clerk Auth pour votre application, il :- Crée un tenant Clerk dédié — Votre application obtient sa propre application Clerk avec des environnements de Développement et de Production séparés
- Provisionne les identifiants — Les clés API et les secrets sont stockés sous forme de variables d’environnement
- Configure un proxy — L’authentification fonctionne de manière transparente sur votre domaine publié
- Configure les routes de connexion et d’inscription — Des composants React Clerk préconstruits sont ajoutés à votre application
- Ajoute un middleware côté serveur — Vos routes API sont protégées par le middleware Express de Clerk
Vous n’avez pas besoin de créer un compte Clerk ni de gérer une infrastructure. Tout est géré automatiquement pour vous par Replit.
Capacités
Ce qui est pris en charge
Clerk Auth fournit à votre application :- Comptes utilisateurs indépendants — Les utilisateurs de votre application ne sont pas des utilisateurs Replit ; ils existent uniquement dans le tenant Clerk de votre application
- Pages de connexion entièrement personnalisées — Le nom, le logo, les couleurs, les polices et le contenu de votre application sur les pages de connexion et d’inscription sont configurés dans le code de votre application
- SSO à marque personnalisée — Fournissez vos propres identifiants OAuth par fournisseur pour que l’écran de consentement OAuth du fournisseur affiche le nom et la marque de votre application au lieu des valeurs génériques par défaut
- Authentification par e-mail et mot de passe — Inscription et connexion intégrées avec vérification par e-mail
- Connexion sociale (SSO) — Laissez les utilisateurs se connecter avec Google, GitHub, Apple ou X (Twitter)
- Gestion des utilisateurs — Consultez, recherchez et modérez les utilisateurs depuis le panneau Auth
- Gestion des sessions — Jetons de session sécurisés gérés automatiquement
- Environnements de Développement et de Production — Testez l’authentification en développement avant de passer en production
Vous pouvez gérer la plupart des configurations Clerk Auth depuis l’outil Auth dans l’Éditeur de projet — aucun compte Clerk requis, et pas besoin de toucher au tableau de bord Clerk.
Ce qui n’est pas pris en charge
Les capacités suivantes ne sont pas disponibles dans Clerk Auth aujourd’hui (comparées à l’application Clerk externe que vous configurez vous-même). Consultez cette FAQ pour la présentation complète.- Connexion par numéro de téléphone — Connexion et vérification par SMS
- Prise en charge MFA — Authentification multi-facteurs pour les utilisateurs finaux
- Couverture complète des fournisseurs SSO — Seuls Google, GitHub, Apple et X sont pris en charge aujourd’hui
- Tenants d’organisation — Les fonctionnalités d’organisation et d’appartenance à une équipe de Clerk
Gestion des utilisateurs
Le panneau Auth dans l’Éditeur de projet vous donne une vue complète de vos utilisateurs authentifiés. Étant donné que Clerk Auth crée un magasin d’utilisateurs séparé pour votre application, les utilisateurs listés ici sont des comptes dans votre application — pas des comptes Replit.
- Voir tous les utilisateurs avec des détails comme l’e-mail, le nom, la dernière connexion et la date de création du compte
- Rechercher et filtrer pour trouver des utilisateurs spécifiques
- Bannir ou débannir des utilisateurs pour contrôler l’accès à votre application
- Trier les utilisateurs selon différents critères
- Changer d’environnement — Basculer entre Développement et Production pour gérer les utilisateurs dans chacun
Personnaliser votre page de connexion
La marque visuelle de vos pages de connexion et d’inscription — le nom de l’application, le logo, les couleurs, les polices et le contenu — est configurée dans le code de votre application, pas dans le panneau Auth. Pour le modifier, demandez à Agent :appearance et localization passées à <ClerkProvider> et le fichier logo dans le répertoire public/ de votre application. Agent maintient ces éléments synchronisés avec le reste du thème de votre application.
Le nom de l’application affiché sur l’écran de consentement de Google, Apple, GitHub ou X (l’écran qui apparaît après qu’un utilisateur clique sur « Se connecter avec Google », etc.) est séparé — il provient de l’application OAuth enregistrée auprès de ce fournisseur et n’est pas modifié en éditant le code de votre page de connexion. Pour le modifier, configurez des identifiants OAuth personnalisés pour ce fournisseur.
Configuration des fournisseurs de connexion
Clerk Auth prend en charge Google, GitHub, Apple et X comme fournisseurs de connexion sociale. Depuis l’onglet Configurer dans le panneau Auth, vous contrôlez quels fournisseurs apparaissent sur votre page de connexion et — en Production — si chaque fournisseur utilise des identifiants OAuth gérés par Replit ou vos propres identifiants personnalisés pour une connexion personnalisée.
- Changer d’environnement — Basculer entre Développement et Production en haut de la liste des fournisseurs SSO et configurer les fournisseurs pour chaque environnement séparément.
- Activer ou désactiver un fournisseur — Utilisez le bouton bascule pour contrôler si le fournisseur apparaît sur votre page de connexion. Les fournisseurs désactivés sont masqués aux utilisateurs.
- Configurer des identifiants OAuth personnalisés (Production uniquement) — Voir Configuration des identifiants OAuth pour un fournisseur SSO ci-dessous.
Configuration des identifiants OAuth pour un fournisseur SSO
Par défaut, les fournisseurs utilisent des identifiants gérés par Replit — la connexion fonctionne prêt à l’emploi, mais l’écran de consentement OAuth affiche la marque Replit. Passez aux Identifiants personnalisés pour utiliser votre propre client OAuth de la console développeur du fournisseur afin que l’écran de consentement affiche le nom et la marque de votre application.- Ouvrez le panneau Auth depuis l’Éditeur de projet. Accédez à l’onglet Configurer, et dans la section Fournisseurs SSO, sélectionnez l’environnement Production.
- Sélectionnez l’icône Modifier à côté du fournisseur que vous souhaitez configurer. Les Identifiants gérés par Replit sont sélectionnés par défaut.
- Sélectionnez Identifiants personnalisés. Le panneau se développe pour afficher les champs d’identifiants et une liste de contrôle Configuration du fournisseur avec les valeurs que vous devez enregistrer côté fournisseur.
- Suivez les instructions pour terminer la configuration. Les instructions contiennent des liens directs vers la console et les documents d’aide pertinents. Vous pouvez également trouver ces documents d’aide sous Ressources supplémentaires pour votre fournisseur.
- Remplissez toutes les valeurs d’identifiants requises.
- Dans la console développeur du fournisseur, enregistrez chaque entrée listée sous la liste de contrôle Configuration du fournisseur dans le portail développeur du fournisseur. Utilisez les icônes de copie pour copier chaque valeur exactement, et cochez les éléments au fur et à mesure ou sélectionnez Tout marquer comme fait lorsque vous avez terminé.
- Sélectionnez Enregistrer les modifications.
Revérification après les changements de domaine
Les opérations liées aux domaines — comme la liaison d’un nouveau domaine externe ou l’achat d’un domaine via Replit — peuvent modifier les URL de rappel de redirection et les origines JavaScript de votre application. Dans ce cas, tout fournisseur configuré avec des identifiants personnalisés peut nécessiter l’enregistrement des nouvelles valeurs dans sa console développeur. Après un changement de domaine, revenez à l’onglet Configurer et scannez la liste des Fournisseurs SSO pour les rappels de configuration. Une icône d’avertissement et un indicateur étapes de configuration restantes à côté d’un fournisseur signifient que sa liste de contrôle Configuration du fournisseur a de nouveaux éléments à compléter.
Configuration du domaine pour la vérification des e-mails
Si votre application offre une inscription par e-mail et mot de passe, Clerk envoie un code de vérification dans la boîte de réception de chaque nouvel utilisateur. La configuration de votre domaine pour la livraison des e-mails garantit que ces codes arrivent depuis l’URL de votre application au lieu d’être retardés ou bloqués par les filtres anti-spam.Quand vous avez besoin de cette configuration
Vous devez uniquement configurer des enregistrements DNS lorsque votre application lie un domaine externe géré par un autre fournisseur (par exemple, un domaine que vous avez enregistré avec Cloudflare, GoDaddy, Namecheap ou similaire). Aucune configuration n’est requise si votre application est servie depuis :- Un sous-domaine
.replit.app - Un domaine acheté via Replit
Ajouter des enregistrements DNS pour l’envoi d’e-mails
Pour autoriser votre application à envoyer des e-mails de vérification depuis votre domaine externe, ajoutez un ensemble d’enregistrements DNS chez votre fournisseur de domaine.- Dans l’Éditeur de projet, ouvrez Publication.
- Sélectionnez Domaines.
- Trouvez votre domaine externe lié et sélectionnez Gérer.
- Sous Configuration DNS d’authentification requise, copiez les enregistrements CNAME que Replit affiche — ce sont les enregistrements dont Clerk a besoin pour envoyer des e-mails de vérification depuis votre domaine.
- Connectez-vous à votre fournisseur DNS (Cloudflare, GoDaddy, Namecheap, etc.) et ajoutez chaque enregistrement exactement comme indiqué.
Dépannage
- E-mails de vérification qui n’arrivent pas — Confirmez que chaque enregistrement a été ajouté exactement comme indiqué dans le panneau Gérer, y compris les points finaux où requis par votre fournisseur DNS. Vérifiez le dossier spam du destinataire.
- Enregistrements toujours non détectés — Attendez la propagation DNS (jusqu’à 48 heures) et revérifiez le panneau Gérer pour les enregistrements toujours signalés comme manquants.
Bonnes pratiques de sécurité
- Validez toujours côté serveur — Vérifiez l’authentification dans vos routes API, pas seulement dans l’interface utilisateur
- Utilisez des variables d’environnement — Ne codez jamais en dur des clés ou des secrets dans votre code
- Gardez le middleware proxy en premier — Le proxy Clerk doit être monté avant les analyseurs de corps dans votre application Express
- Ne redirigez pas la page d’accueil vers la connexion — Gardez votre page de destination accessible aux visiteurs non authentifiés
FAQ
Ai-je besoin d’un compte Clerk pour utiliser Clerk Auth ?
Non. Le tenant Clerk derrière Clerk Auth est créé et géré automatiquement par Replit lorsqu’Agent configure votre application — vous n’avez pas besoin de vous inscrire à Clerk ni de gérer une infrastructure Clerk vous-même.Puis-je accéder au tableau de bord Clerk pour l’instance Clerk gérée par Replit ?
Non. L’instance Clerk gérée par Replit n’est pas exposée via le tableau de bord Clerk. Gérez-la depuis l’outil Auth dans l’Éditeur de projet à la place — c’est là que vous configurez les fournisseurs, consultez les utilisateurs et basculez entre les environnements de Développement et de Production.Clerk Auth est-il gratuit ?
Clerk Auth est gratuit pour l’instant. Une tarification à l’utilisation pourra être introduite plus tard, en ligne avec les autres services à l’utilisation sur Replit. Tous les frais futurs seront appliqués via votre facturation Replit existante — vous n’aurez pas besoin d’une facture ou d’un mode de paiement Clerk séparé.Clerk Auth a-t-il une limite MAU comme les plans Clerk externes ?
Non. Clerk Auth n’impose pas de limite d’utilisateurs actifs mensuels (MAU), contrairement aux plans Clerk externes qui plafonnent les MAU par niveau.Comment Clerk Auth se compare-t-il à Clerk externe ?
Le tenant Clerk géré par Replit derrière Clerk Auth présente quelques nuances par rapport aux applications Clerk que vous créez dans votre propre compte Clerk (Clerk externe). Le tableau ci-dessous met en évidence les différences actuelles — cela reflète l’état actuel de Clerk Auth, et l’ensemble des fonctionnalités prises en charge continuera d’évoluer.| Clerk Auth | Clerk externe | |
|---|---|---|
| Configuration | Provisionné automatiquement par Replit | Configuré par vous-même |
| Propriété du tenant Clerk | Géré par Replit, appartient à votre application | Appartient à votre compte Clerk |
| Structure des frais | Actuellement gratuit (prévu d’avoir un paiement à l’utilisation à l’avenir) | Abonnement + paiement à l’utilisation |
| Facturation | Facturation Replit (actuellement gratuite) | Facturation sur votre compte Clerk |
| Limite MAU | Illimitée | Limitation par niveaux |
| Configuration du proxy et du domaine | Automatisée pour replit.app et les domaines achetés, manuelle pour les domaines liés | Manuelle |
| Fournisseurs SSO | Pris en charge sur certains fournisseurs : Google, Apple, GitHub, X | Prend en charge plus de fournisseurs |
| Interface de gestion des utilisateurs | Outil Auth dans l’Éditeur de projet | Tableau de bord de l’application Clerk |
| SMS | Non pris en charge | Pris en charge |
| MFA | Non pris en charge | Pris en charge |
| Tenants d’organisation | Non pris en charge | Pris en charge |
Quelle configuration courante de Clerk Auth dois-je gérer manuellement ?
La plupart de la configuration de Clerk Auth est automatisée, mais quelques configurations nécessitent que vous preniez des mesures en dehors de l’outil Auth :- Identifiants OAuth personnalisés pour les fournisseurs SSO — Si vous souhaitez que l’écran de consentement du fournisseur affiche le nom et la marque de votre application (au lieu des valeurs par défaut de Replit), enregistrez une application OAuth dans la console développeur du fournisseur et collez les identifiants dans le panneau Auth. Voir Configuration des identifiants OAuth pour un fournisseur SSO.
- Enregistrements DNS pour la vérification des e-mails sur les domaines externes — Si votre application lie un domaine externe géré par un autre fournisseur, vous devrez ajouter des enregistrements DNS pour que les e-mails de vérification soient livrés depuis votre domaine. Voir Configuration du domaine pour la vérification des e-mails.
Puis-je apporter ma propre application Clerk au lieu d’utiliser celle gérée par Replit ?
Oui. Si votre application a déjà une application Clerk gérée par Replit provisionnée, supprimez-la d’abord avant de connecter votre propre application Clerk externe :- Ouvrez le panneau Auth dans l’Éditeur de projet.
- Accédez à l’onglet Configurer.
- Faites défiler vers le bas de la page et cliquez sur Supprimer l’application Clerk.
Ressources supplémentaires
- Migration d’une application existante vers Clerk Auth — Bonnes pratiques pour migrer une application en production avec des données utilisateur existantes vers Clerk Auth sans interruption de la continuité des comptes
- Configurer Google SSO — Configurer des identifiants Google OAuth personnalisés
- Configurer GitHub SSO — Configurer des identifiants GitHub OAuth personnalisés
- Configurer Apple SSO — Configurer des identifiants Apple Sign In personnalisés
- Configurer X (Twitter) SSO — Configurer des identifiants X OAuth personnalisés
- Documentation Clerk — Référence pour les développeurs intégrant une application Clerk externe