authentication.
Chaque appel ci-dessous est envoyé à l’API de gestion de l’authentification de votre application. MANAGEMENT_BASE correspond à :
openapi-authentication.json, sous le tag Setup, à partir duquel les SDK serveur sont régénérés.
Quel moyen d’authentification utiliser
Chacun des trois identifiants suivants fonctionne, et chacun est limité à ce que son titulaire a approuvé.
Ces identifiants sont refusés avec
403 sur toutes les routes de configuration, quelle que soit la requête :
- Le secret principal de l’application.
- Un jeton issu de
POST /programmatic/login, qui est émis pour l’application et non pour la console. - Une clé sans la portée
authentication, y compris une clé créée avec toutes les ressources à leur niveau le plus élevé : ces clés sont affichées comme ayant un accès complet, gardentscopesvide et ne sont pas acceptées sur ces routes. - Une clé d’une autre application, une autorisation limitée à
didit:verification, ou une autorisation approuvée pour une autre organisation.
401. Une autorisation ou une clé conserve en plus ses propres limites : l’autorisation est limitée par ses portées, ses organisations et le rôle de la personne ; la clé est limitée par ses portées, sa liste d’autorisation IP et sa date d’expiration.
Approuver l’accès
Avec une clé API nommée
Ouvrez Developers -> API keys dans la Business Console et créez une clé pour l’application que vous configurez. Attribuez-lui la ressourceauthentication avec le droit read ou write : read couvre tous les appels qui lisent la configuration (GET) ; write couvre tous les appels qui la modifient (POST, PUT, PATCH, DELETE) et permet aussi de la lire. Consultez Clés API pour l’expiration, les listes d’adresses IP autorisées et la rotation : une clé appartient à une seule application et ne fonctionne que pour celle-ci.
Via une connexion MCP
Un agent connecté au serveur MCP de Didit utilise l’autorisation que son propriétaire a approuvée sur l’écran de consentement, avecdidit:management. Consultez Authentification MCP.
Pour un propriétaire sans mot de passe
Le flux d’autorisation par code d’appareil (RFC 8628) permet à un propriétaire qui se connecte avec Google, une clé d’accès ou un code envoyé par e-mail d’approuver le même accès depuis n’importe quel navigateur, sans saisir de mot de passe. Consultez se connecter sans navigateur.Activer le code par e-mail
PUT methods/{name}/ accepte enabled, et rien d’autre pour une méthode qui ne nécessite aucune information d’identification.
credential_source: null. Les méthodes toujours activées ne peuvent pas être désactivées : cette requête renvoie {"enabled": "always_on"}.
Activer Google
Une méthode de connexion sociale utilise les identifiants de votre propre application OAuth, ou ceux de l’application de test de Didit sur une application sandbox.Avec votre propre application Google
callback_uri renvoyé par la réponse auprès de votre fournisseur. Le secret est en écriture seule : aucune réponse ne le renvoie, et client_id est la seule partie que vous pouvez relire. Activer une méthode sans identifiants, alors qu’aucun n’a été enregistré auparavant, renvoie {"credentials": "required"}.
Avec l’application de test de Didit (didit_test)
Une application sandbox peut utiliser les applications sociales de Didit à la place des vôtres, ce qui suffit pour finaliser une configuration et vérifier qu’elle fonctionne :
didit_test couvre Google, Microsoft, Apple et GitHub, uniquement sur les applications sandbox :
GET sur la configuration indique les fournisseurs qu’une application de test peut prendre en charge pour cette application dans didit_test_credentials, avec la valeur false pour les quatre sur une application en production.
Relire la configuration
GET sur MANAGEMENT_BASE permet de relire la configuration : chaque méthode avec enabled et credential_source, ainsi que les URL de rappel, les règles de session et la politique d’inscription.
GET indique ce qui est activé et ce qui ne l’est pas. enabled en haut vaut false lorsque l’authentification est désactivée pour l’application. Toute modification de configuration effectuée avec une autorisation de gestion ou une clé nommée renvoie alors 409 avec {"detail": "product_disabled"}, et rien n’est écrit. Aucun appel de configuration n’active l’authentification : une personne l’active pour l’application dans la console, et vos appels fonctionnent à partir de ce moment-là.
Le reste de la configuration
Une autorisation ou une clé API donne accès à la configuration et à ses compteurs, jamais aux données des utilisateurs finaux :
users/, sessions/, sign-ins/, overview/, les organisations clientes, les rôles, les imports, les sessions d’agent et les e-mails de test nécessitent toujours une session de console.
Le paramètre agent_humans_only s’applique à l’application entière. Seul un propriétaire ou un administrateur de l’organisation peut le modifier. Une clé API nommée reçoit 403 owner_or_admin_required. Activer ce paramètre exige également une clé d’accès enregistrée (passkey_required).