Passer au contenu principal
Didit Authentication vous permet d’activer des méthodes de connexion et de récupérer les paramètres de votre application via l’API. Utilisez une autorisation approuvée par le propriétaire ou une clé API nommée avec la portée authentication.
L’authentification est une nouveauté. Configurez d’abord une méthode dans une application sandbox, puis dans votre application de production.
Chaque appel ci-dessous est envoyé à l’API de gestion de l’authentification de votre application. MANAGEMENT_BASE correspond à :
Les mêmes routes sont décrites dans 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, gardent scopes vide 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.
Une requête sans aucun identifiant renvoie 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 ressource authentication 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, avec didit: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.
Elle renvoie la méthode dans son état actuel :
Lorsque vous relisez la configuration, l’entrée du code par e-mail contient 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

Enregistrez le 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.
Les méthodes désactivées sont aussi listées, si bien qu’un seul 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).

Erreurs

Dernière modification le 20 novembre 2026