Aller au contenu principal

Liste de vérification

Complétez cette liste avant de commencer toute intégration. Environ 5 minutes.

Étape 1 : Créer votre compte Nexorix​

SyAuth fait partie de l'écosystème Nexorix. Vous devez créer un compte sur Nexorix pour accéder au tableau de bord SyAuth.

  1. Allez sur Nexorix et créez un compte.
  2. Une fois inscrit, utilisez vos identifiants Nexorix pour vous connecter à SyAuth.
astuce

Utilisez votre email professionnel si vous développez pour une entreprise. Vous pourrez ajouter des membres d'équipe à votre Espace de travail plus tard.

Étape 2 : Créer un Espace de travail​

Après vous être connecté, vous serez invité à créer un Espace de travail. Un Espace de travail est l'endroit où vivent toutes vos applications, utilisateurs et paramètres.

ChampQuoi entrerExemple
NomLe nom de votre entreprise ou projetAcme Corp ou Mon Projet

Quand utiliser plusieurs Espaces de travail :

  • Séparer les environnements de production et de développement
  • Séparer les projets pour différents clients
  • Isoler les comptes de test des vrais utilisateurs

Étape 3 : Créer votre premier Client OAuth​

Un Client OAuth représente votre application dans SyAuth.

  1. Dans la barre latérale, cliquez sur Clients OAuth.
  2. Cliquez sur Créer un Client OAuth.
  3. Sélectionnez votre type d'application :
    • Application Web classique : Pour Next.js, Django, etc. Public + PKCE est recommandé.
    • Application monopage (SPA) : Pour React, Vue côté client. Utilise Public + PKCE.
    • Application native : Pour les applications mobiles ou desktop.
    • Machine à Machine : Pour les services backend et CLIs.

👉 Voir le guide détaillé : Configurer les Clients OAuth

Étape 4 : Copier vos identifiants OAuth​

Après avoir créé votre Client OAuth, vous verrez vos identifiants. Stockez-les en sécurité.

  • Client ID : Peut être utilisé dans le code frontend en toute sécurité.
  • Client Secret : Requis uniquement si vous avez choisi Client Confidentiel. Affiché une seule fois.
attention

Le Client Secret n'est affiché qu'une seule fois ! Si vous le perdez, vous devrez le régénérer.

Étape 5 : Créer un Token API​

Les Tokens API (Clés) permettent à votre code côté serveur d'effectuer des opérations comme l'inscription d'utilisateurs via l'API.

  1. Dans la barre latérale, cliquez sur Tokens API.
  2. Cliquez sur Créer un Token.
  3. Nommez votre token et sélectionnez les scopes nécessaires (Lecture/Écriture).
  4. Copiez votre token immédiatement — il ne sera plus jamais affiché.

👉 Voir le guide détaillé : Gérer les Tokens API

Étape 6 : Configurer les variables d'environnement​

Créez un fichier .env.local (ou équivalent pour votre framework) avec vos identifiants :

Next.js​

NEXT_PUBLIC_SYAUTH_API_URL=https://api.syauth.com/e/v1
NEXT_PUBLIC_SYAUTH_CLIENT_ID=votre-client-id
NEXT_PUBLIC_SYAUTH_REDIRECT_URI=http://localhost:3000/auth/callback
NEXT_PUBLIC_SYAUTH_API_KEY=votre-api-key

Django​

# settings.py
SYAUTH = {
    'API_URL': 'https://api.syauth.com/e/v1',
    'CLIENT_ID': 'votre-client-id',
    'API_KEY': 'votre-api-key',
    'REDIRECT_URI': 'http://localhost:8000/auth/callback/',
}

Autres Frameworks​

SYAUTH_API_URL=https://api.syauth.com/e/v1
SYAUTH_CLIENT_ID=votre-client-id
SYAUTH_CLIENT_SECRET=votre-client-secret
SYAUTH_REDIRECT_URI=http://localhost:3000/callback

✓ Liste complétée !​

Vous êtes prêt à intégrer SyAuth. Choisissez votre guide de démarrage :

Dépannage de la configuration​

« Je ne trouve pas mon Client Secret »​

Les Client Secrets ne sont affichés qu'une seule fois lors de la création. Si vous ne l'avez pas copié :

  1. Allez dans Tableau de bord → Clients OAuth → Votre Application
  2. Cliquez sur Régénérer le Secret
  3. Copiez le nouveau secret immédiatement

« J'ai ajouté le mauvais URI de redirection »​

  1. Allez dans Tableau de bord → Clients OAuth → Votre Application
  2. Dans la section URIs de redirection, modifiez ou supprimez les URIs incorrects
  3. Ajoutez l'URI correct
  4. Enregistrez les modifications

« Je dois ajouter un membre d'équipe »​

  1. Allez dans Tableau de bord → Paramètres de l'Espace de travail
  2. Cliquez sur Membres
  3. Cliquez sur Inviter un membre
  4. Entrez son adresse email