Connecter un fournisseur d’identité
Connectez Auth0, Clerk, Amazon Cognito ou WorkOS dans le tableau de bord pour que Syncanix puisse authentifier vos utilisateurs finaux via le fournisseur que vous utilisez déjà.
L’adaptateur de fournisseur d’identité est la méthode recommandée pour authentifier vos utilisateurs finaux. Vous connectez votre fournisseur une fois, par environnement, et Syncanix vérifie les jetons qu’il émet — aucun secret supplémentaire à gérer et aucune seconde connexion pour vos utilisateurs.
Où le configurer
Ouvrez Paramètres → Fédération dans le tableau de bord. Choisissez votre fournisseur, remplissez les champs ci-dessous et enregistrez. Chaque fournisseur ne demande qu’une poignée de valeurs, toutes copiées depuis le tableau de bord de votre fournisseur.
Fournisseurs pris en charge
Quatre fournisseurs d’identité bénéficient d’intégrations de premier ordre dans le tableau de bord — Auth0, Clerk, Cognito et WorkOS — et chaque section ci-dessous indique les champs exacts demandés par le tableau de bord. Au-delà, Syncanix fonctionne aussi avec tout fournisseur OIDC standard, vos propres JWT personnalisés, une session backend-for-frontend (BFF) ou l’introspection de jetons RFC 7662, configurés via le SDK plutôt que par un formulaire du tableau de bord.
Connecter Auth0
Vous trouverez les trois valeurs sur la page des paramètres de votre application Auth0.
- Domaine du tenant
- Votre domaine Auth0, par exemple acme.us.auth0.com.
- Identifiant client de l’application
- L’identifiant client de l’application Auth0 à laquelle vos utilisateurs se connectent.
- Audience de l’API (facultatif)
- À définir uniquement si vos jetons ciblent une audience d’API spécifique, par exemple https://api.acme.com.
Connecter Clerk
Copiez-les depuis les paramètres de votre instance Clerk.
- URL de l’instance
- L’URL frontend de votre Clerk, par exemple https://acme.clerk.accounts.dev.
- Identifiant client
- L’identifiant client que Clerk émet pour votre application.
Connecter Amazon Cognito
Récupérez-les depuis votre groupe d’utilisateurs Cognito et son client d’application.
- Domaine Cognito
- Votre domaine d’interface hébergée, par exemple acme.auth.eu-central-1.amazoncognito.com.
- Identifiant du client d’application
- L’identifiant du client d’application de votre groupe d’utilisateurs Cognito.
- Région AWS
- La région AWS dans laquelle s’exécute votre pool d’utilisateurs, par exemple eu-central-1.
- ID du pool d’utilisateurs
- L’ID de votre pool d’utilisateurs Cognito, par exemple eu-central-1_AbCdEf123.
Connecter WorkOS
WorkOS utilise l’authentification unique, il lui faut donc les identifiants de votre client et de votre organisation.
- Identifiant client
- Votre identifiant client WorkOS, par exemple client_xxxxxxxx.
- Identifiant de l’organisation
- L’organisation WorkOS à laquelle appartiennent vos utilisateurs, par exemple org_xxxxxxxx.
Au-delà des quatre fournisseurs du tableau de bord
Si votre dispositif d’identité ne correspond à aucun formulaire du tableau de bord, il existe quand même un chemin : Syncanix fournit un adaptateur pour chacune des formes courantes :
- Tout fournisseur OIDC — @syncanix/oidc
- Fonctionne avec tout émetteur OpenID-Connect standard : il découvre les clés de signature dans la configuration well-known de l’émetteur et vérifie les jetons contre elles.
- Vos propres JWT — @syncanix/custom-jwt
- Pour les apps qui émettent leurs propres JWT conformes aux standards : pointez-le vers votre endpoint JWKS et mappez les noms de vos claims.
- Jetons opaques — @syncanix/introspection
- Pour les jetons invérifiables localement : chaque jeton est vérifié via l’endpoint d’introspection RFC 7662 de votre serveur d’autorisation.
- Sessions par cookies — @syncanix/bff
- Pour les sessions par cookies où aucun jeton ne doit atteindre le navigateur : l’utilisateur est vérifié via un endpoint whoami sur votre propre backend.
Actions transparentes au nom de l’utilisateur
Pour Auth0, Clerk et Cognito, vous pouvez cocher « accès hors ligne ». Une fois activé, le fournisseur émet un jeton de rafraîchissement que Syncanix stocke chiffré, afin que les outils MCP puissent agir au nom de l’utilisateur sans étape de connexion distincte. L’authentification unique de WorkOS n’émet pas de jetons de rafraîchissement, l’option n’y apparaît donc pas.