Connexion au portail — Guides d'intégration & Référence API
Les sections Guides d'intégration et Référence API nécessitent une session authentifiée sur ce portail. Les autres sections (Getting Started, Authentification, SDKs, Changelog) restent en accès libre.
Cette connexion au portail de documentation est distincte de l'authentification à l'API MOCOSAG elle-même (OAuth2) : c'est un compte sandbox qui déverrouille la lecture de la documentation, pas un jeton d'accès aux endpoints. Certains guides exigent en plus un rôle métier particulier — voir Visibilité par rôle plus bas.
Se connecter
- Ouvrez n'importe quelle page sous
/guides/integration-guides/*ou/api/*(ou directement/login— page statique hors routage Docusaurus, servie parserver.mjs). - Sans session valide, la page reste accessible mais affiche un aperçu (titre + introduction) avec un lien « …lire plus » vers la connexion — voir Comment ça marche pour le détail des trois couches qui produisent ce comportement.
- Saisissez l'identifiant et le mot de passe de votre compte sandbox (les mêmes
credentials que ceux utilisés pour le flow
password— voir Credentials et Sandbox). - Toutes les personas sandbox ont la double authentification (TOTP) active —
une seconde étape vous demande le code à 6 chiffres de votre application
d'authentification. Pour les comptes de démo
dev_seed, ce code se lit viapython manage.py show_persona_totp <email>. - Une fois validé, vous êtes redirigé vers la page initialement demandée, avec son contenu complet cette fois.
Connectez-vous pour lire la suite.
Messages d'erreur
| Message affiché | Cause |
|---|---|
| Champ(s) manquant(s). | Identifiant/mot de passe ou code TOTP vide à la soumission |
| Identifiants ou code incorrects. | Rejet par le backend (401 login, ou 401/400/422 sur mfa/verify) |
| Méthode MFA non prise en charge sur ce portail (TOTP uniquement). | Défi MFA sans méthode TOTP disponible |
| Trop de tentatives — réessayez plus tard. | 429 (rate limit) sur mfa/verify |
| Ce défi a expiré ou a déjà été utilisé, reconnectez-vous. | Défi introuvable / expiré / budget de tentatives épuisé (404/410) — il faut relancer la connexion depuis l'étape 1 |
| Impossible de contacter le service d'authentification. Réessayez. | Backend sandbox injoignable ou en erreur |
| « Ce guide est réservé aux profils suivants : … » | Session valide, mais le profil actif ne porte aucun des rôles requis pour ce guide |