Enregistrer un client
Chaque intégration est un client enregistré depuis la console Développeurs de l’application Vimine. La console est réservée au conseil de l’association : si vous n’en faites pas partie, demandez à un dirigeant d’enregistrer le client pour vous et de vous transmettre les identifiants.
Sans association — une agence, qui développe un plugin, qui veut essayer l’API — demandez à la plateforme une invitation développeur : vous aurez une sandbox à vous, une association d’essai avec des membres synthétiques, et vous y enregistrerez vous-même vos clients de test, en acceptant les conditions pour les développeurs. Les clients de production restent à l’association pour laquelle vous travaillez.
Types de client
Section intitulée « Types de client »| Type | Pour | Identifiants | Notes |
|---|---|---|---|
| Site web (public) | des pages dans le navigateur | client_id seulement |
PKCE obligatoire ; redirect URI https exactes |
| Application native | applications mobiles ou de bureau | client_id seulement |
comme ci-dessus ; redirections loopback (http://127.0.0.1:{port}/…) ou schéma personnalisé |
| Serveur (confidentiel) | un backend de l’association | client_id + client_secret |
le secret n’est affiché qu’une fois ; jamais dans un navigateur |
Les clients publics et natifs font Se connecter avec Vimine et appellent l’API avec le jeton du membre.
Les clients confidentiels peuvent en plus s’authentifier par eux-mêmes (client_credentials) pour les autorisations
« client », comme l’état des cartes.
Environnements
Section intitulée « Environnements »| Environnement | Où il vit | Quand il est actif |
|---|---|---|
| Test | dans la sandbox de l’association (créée à la demande) | immédiatement |
| Production | dans l’association réelle | après activation par Vimine : vous recevez un e-mail |
Les clients de test émettent des jetons avec mode: "test" et ne peuvent pas toucher à l’association réelle. Leurs
identifiants confidentiels commencent par vms_test_.
Ce qu’il faut enregistrer
Section intitulée « Ce qu’il faut enregistrer »- Nom — ce que le membre verra sur la page de consentement (« Nom souhaite accéder à votre profil… »).
- Type et environnement.
- Redirect URI — les pages vers lesquelles Vimine peut renvoyer le navigateur après la connexion. La correspondance est exacte (schéma, hôte, port, chemin) : enregistrez chaque page de callback que vous utiliserez.
- Origines autorisées — les origines (
https://www.example.org) depuis lesquelles vos pages appellent l’API dans le navigateur. Elles servent pour le CORS et comme destinations autorisées après la déconnexion (post_logout_redirect_uri). - Autorisations — les scopes que l’intégration peut demander. Ne demandez que ce dont vous avez besoin : le membre les voit toutes. Un client public ou natif ne peut détenir que des autorisations « membre » ; les autorisations « client » exigent un client confidentiel. Tableau dans Autorisations, erreurs et limites.
À la création, vous obtenez le client_id (vmc_…) et, pour les clients confidentiels, le client_secret (vms_…),
affiché une seule fois. Pour les clients de test, la console affiche aussi les membres synthétiques de la sandbox
et leur mot de passe.
Cycle de vie
Section intitulée « Cycle de vie »- Régénérer le secret — le nouveau secret n’est affiché qu’une fois ; l’ancien continue de fonctionner pendant 24 heures, pour que vous puissiez mettre à jour vos systèmes sans interruption.
- Suspendre — les jetons du client cessent de fonctionner jusqu’à ce que vous le réactiviez. La réactivation est entre les mains du conseil.
- Révoquer — définitif : chaque session du client prend fin immédiatement et les membres ne le voient plus parmi leurs applications connectées.
- Les membres peuvent retirer leur consentement à tout moment depuis Applications connectées dans leur compte : les sessions de ce client pour ce membre prennent fin.