Gerege Verify (XYP)¶
Production · Couche 2 — Renseignements ·
Dépôt : sso-gerege-mn (xyp.gerege.mn/) · xyp.gerege.mn
Un service de renseignement qui vérifie les informations sur les entreprises et les organisations auprès du registre de l'État. Il se compose d'une API Go et d'un écran d'administration Next.js.
Ce qu'il fait¶
Lorsque les plateformes de l'écosystème créent une organisation, ajoutent un membre ou accordent un droit, elles ont souvent besoin de confirmer que l'organisation existe réellement au registre de l'État. Gerege Verify fournit ce renseignement par un guichet unique.
Usages courants :
- l'organisation est-elle enregistrée, son nom et son numéro d'immatriculation concordent-ils,
- qui sont les dirigeants habilités de l'organisation,
- tel citoyen est-il rattaché à cette organisation.
Structure¶
| Composant | Technologie | Rôle |
|---|---|---|
api/ |
Go | API de renseignement, gestion des clients / clés d'API, compteurs d'usage |
web/ |
Next.js | Console d'administration — enregistrement des clients, rapports d'usage |
Modèle d'API¶
| Chemin | Objet |
|---|---|
/v1/* |
L'API principale de renseignement — avec rate limit |
/api/clients |
Enregistrement des clients (admin) |
/api/usage |
Télémétrie d'usage (admin) |
/health |
Contrôle de santé |
L'accès est régi par des clés d'API. Chaque client possède la sienne, l'usage est compté et visible dans l'écran d'administration.
Pourquoi ces compteurs comptent
Les renseignements du registre de l'État peuvent constituer une source payante et soumise à quota. Sans comptage par client, impossible de répartir le coût ni de détecter un dépassement. S'y ajoute une exigence d'audit : tracer qui a consulté quelle organisation.
Qui l'utilise¶
- Gerege Platform et Template Platform — dans leurs parcours de création et de recherche d'organisations,
- Gerege Wallet — dans le parcours de compte d'organisation,
- les outils d'administration internes.
Rapport avec X-Road¶
À terme, les renseignements interorganisationnels tendent à se normaliser sur X-Road. Gerege Verify est aujourd'hui un canal de renseignement qui fonctionne à côté de X-Road ; une fois X-Road pleinement déployé, certains de ces appels pourront y migrer.
Documentation détaillée¶
La documentation d'implémentation se trouve dans le répertoire xyp.gerege.mn/
du dépôt sso-gerege-mn.