authentication.
Cada crida que es mostra a continuació va a l’API de gestió d’Authentication de la teva aplicació. MANAGEMENT_BASE és:
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, mantenenscopesbuit 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ó.
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 recursauthentication 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, ambdidit: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.
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
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.
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).