Saltar al contingut principal
Didit Authentication et permet activar mètodes d’inici de sessió i consultar mitjançant l’API la configuració de la teva aplicació. Fes servir una concessió aprovada pel propietari o una clau d’API amb nom i l’àmbit authentication.
Authentication és una funcionalitat nova. Configura un mètode primer en una aplicació de sandbox i després en la teva aplicació de producció.
Cada crida que es mostra a continuació va a l’API de gestió d’Authentication de la teva aplicació. MANAGEMENT_BASE és:
Les mateixes rutes es descriuen a openapi-authentication.json sota l’etiqueta Setup, a partir del qual es regeneren els SDK de servidor.

Quina credencial utilitzar

Funciona qualsevol de les tres credencials, i cadascuna està limitada al que el seu titular ha aprovat. Aquestes credencials es rebutgen amb 403 en totes les rutes de configuració, sigui quina sigui la petició:
  • El secret principal de l’aplicació.
  • Un token de POST /programmatic/login, que s’emet per a l’aplicació i no per a la consola.
  • Una clau sense l’àmbit authentication, inclosa una clau creada amb tots els recursos al nivell màxim: aquestes es mostren com a accés complet, mantenen scopes buit i no s’accepten en aquestes rutes.
  • Una clau d’una altra aplicació, una autorització limitada a didit:verification, i una autorització aprovada per a una altra organització.
Una petició sense cap credencial rep 401 com a resposta. Una autorització o una clau mantenen, a més, els seus propis límits: l’autorització, els seus àmbits, les organitzacions i el rol de la persona; la clau, els seus àmbits, la llista d’IP permeses i la data de caducitat.

Aprobar el acceso

Amb una clau d’API amb nom

Obre Developers -> API keys a la Business Console i crea una clau per a l’aplicació que estàs configurant. Dona-li el recurs authentication amb permís de read o write: read cobreix totes les crides que llegeixen la configuració (GET); write cobreix totes les crides que la canvien (POST, PUT, PATCH, DELETE) i també la llegeixen. Consulta Claus d’API per a la caducitat, les llistes d’IP permeses i la rotació; una clau pertany a una aplicació i només funciona per a aquesta.

A través d’una connexió MCP

Un agent connectat al servidor MCP de Didit utilitza el permís que el seu propietari ha aprovat a la pantalla de consentiment, amb didit:management. Consulta Autenticació MCP.

Per a un propietari sense contrasenya

La concessió de codi de dispositiu (RFC 8628) permet que un propietari que inicia sessió amb Google, una clau d’accés o un codi enviat per correu electrònic aprovi el mateix accés des de qualsevol navegador, sense escriure cap contrasenya. Consulta iniciar sessió sense navegador.

Activar el codi per correu electrònic

PUT methods/{name}/ accepta només enabled per a un mètode que no necessita credencials.
La resposta mostra el mètode tal com està ara:
Quan llegeixis la configuració, l’entrada del codi per correu electrònic inclou credential_source: null. Els mètodes que sempre estan activats no es poden desactivar: aquesta sol·licitud respon amb {"enabled": "always_on"}.

Activa Google

Un mètode social fa servir les credencials de la teva pròpia aplicació OAuth, o les de l’aplicació de prova de Didit en una aplicació de sandbox.

Amb la teva pròpia aplicació de Google

Registra el callback_uri que retorna la resposta al teu proveïdor. El secret és només d’escriptura: cap resposta no el retorna, i client_id és l’única part que pots llegir de nou. Activar un mètode sense credencials, quan abans no n’hi havia cap d’emmagatzemada, respon {"credentials": "required"}.

Amb l’aplicació de prova de Didit (didit_test)

Una aplicació de sandbox pot fer servir les aplicacions socials pròpies de Didit en lloc de les teves, cosa que és suficient per acabar una configuració i comprovar que funciona:
didit_test cobreix Google, Microsoft, Apple i GitHub, només en aplicacions de sandbox: GET sobre la configuració indica en didit_test_credentials els proveïdors que una aplicació de prova pot servir per a aquesta aplicació. El valor és false per als quatre en una aplicació en producció.

Llegir la configuració

GET sobre MANAGEMENT_BASE és la lectura de comprovació: cada mètode amb enabled i credential_source, a més de les URL de callback, les regles de sessió i la política de registre.
Els mètodes desactivats també apareixen a la llista, de manera que un sol GET indica què està activat i què no. enabled a la part superior és false quan l’Autenticació està desactivada per a l’aplicació. Qualsevol canvi de configuració fet amb un permís de gestió o amb una clau d’API amb nom retorna 409 amb {"detail": "product_disabled"}, i no s’escriu res. Cap crida de configuració no activa l’Autenticació: una persona l’activa per a l’aplicació a la consola, i a partir d’aquell moment les teves crides funcionen.

La resta de la configuració

Una concessió o una clau només poden accedir a la configuració i als seus comptadors, mai a dades d’usuaris finals: users/, sessions/, sign-ins/, overview/, les organitzacions de clients, els rols, les importacions, les sessions d’agents i els correus de prova continuen necessitant una sessió de la consola. La configuració agent_humans_only s’aplica a tota l’aplicació. Només un propietari o administrador de l’organització en pot canviar el valor. Una clau amb nom rep 403 owner_or_admin_required. Activar la configuració també requereix una passkey registrada (passkey_required).

Errors

Darrera modificació el 20 de novembre del 2026