authentication.
Todas las llamadas siguientes van a la API de gestión de Authentication de tu aplicación. MANAGEMENT_BASE es:
openapi-authentication.json, bajo la etiqueta Setup; los SDK de servidor se regeneran a partir de este archivo.
Qué credencial usar
Cualquiera de las tres credenciales funciona, y cada una se limita a lo que su titular aprobó.
Estas credenciales se rechazan con
403 en todas las rutas de configuración, sea cual sea la solicitud:
- El secreto principal de la aplicación.
- Un token de
POST /programmatic/login, que se emite para la aplicación y no para la consola. - Una clave sin el ámbito
authentication, incluida una clave creada con todos los recursos en su nivel más alto: se muestra como acceso completo, mantienescopesvacío y no se acepta en estas rutas. - Una clave de otra aplicación, una concesión limitada a
didit:verificationy una concesión aprobada para otra organización.
401. Además, una concesión o una clave mantiene sus propios límites: la concesión, sus ámbitos, sus organizaciones y el rol de la persona; la clave, sus ámbitos, su lista de IP permitidas y su caducidad.
Aprobar el acceso
Con una clave de API con nombre
Abre Developers -> API keys en la Business Console y crea una clave para la aplicación que estás configurando. Asígnale el recursoauthentication con permiso de lectura o de escritura: la lectura cubre todas las llamadas que leen la configuración (GET); la escritura cubre todas las llamadas que la cambian (POST, PUT, PATCH, DELETE) y también permite leerla. Consulta claves de API para la caducidad, las listas de IP permitidas y la rotación; una clave pertenece a una sola aplicación y solo funciona para ella.
A través de una conexión MCP
Un agente conectado al servidor MCP de Didit usa la concesión que su propietario aprobó en la pantalla de consentimiento, condidit:management. Consulta autenticación MCP.
Para un propietario sin contraseña
La concesión de código de dispositivo (RFC 8628) permite que un propietario que inicie sesión con Google, una clave de acceso o un código enviado por correo electrónico apruebe el mismo acceso desde cualquier navegador, sin escribir una contraseña. Consulta iniciar sesión sin navegador.Habilitar código por correo electrónico
PUT methods/{name}/ acepta enabled, y nada más para un método que no necesita credenciales.
credential_source: null. Los métodos que siempre están activos no se pueden desactivar: esa solicitud responde {"enabled": "always_on"}.
Activar Google
Un método social usa las credenciales de tu propia aplicación OAuth, o la app de prueba de Didit en una aplicación sandbox.Con tu propia aplicación de Google
callback_uri que devuelve la respuesta en tu proveedor. El secreto es de solo escritura: ninguna respuesta lo devuelve, y client_id es la única parte que puedes volver a leer. Activar un método sin credenciales, cuando no se había guardado ninguna anteriormente, responde {"credentials": "required"}.
Con la app de prueba de Didit (didit_test)
Una aplicación sandbox puede usar las apps sociales de Didit en lugar de las tuyas, lo que basta para completar una configuración y comprobar que funciona:
didit_test cubre Google, Microsoft, Apple y GitHub, solo en aplicaciones sandbox:
GET sobre la configuración indica en didit_test_credentials los proveedores que una app de prueba puede atender para esta aplicación. El valor es false para los cuatro en una aplicación en producción.
Leer la configuración
GET en MANAGEMENT_BASE es la lectura de la configuración: cada método con enabled y credential_source, además de las URL de callback, las reglas de sesión y la política de registro.
GET indica qué está activado y qué no. enabled en la parte superior es false cuando la Autenticación está deshabilitada para la aplicación. Cualquier cambio de configuración que se haga con un permiso de gestión o con una clave con nombre devuelve 409 con {"detail": "product_disabled"}, y no se guarda nada. Ninguna llamada de configuración activa la Autenticación: la activa una persona para la aplicación en la consola, y tus llamadas funcionan a partir de ese momento.
El resto de la configuración
Una concesión o una clave solo pueden acceder a la configuración y a sus contadores, nunca a datos de usuarios finales:
users/, sessions/, sign-ins/, overview/, las organizaciones de clientes, los roles, las importaciones, las sesiones de agentes y los correos de prueba siguen necesitando una sesión de la consola.
El ajuste agent_humans_only se aplica a toda la aplicación. Solo un propietario o administrador de la organización puede cambiarlo. Una clave con nombre recibe 403 owner_or_admin_required. Activar el ajuste también requiere una clave de acceso registrada (passkey_required).