Saltar al contenido principal
Didit Authentication te permite habilitar métodos de inicio de sesión y leer la configuración de tu aplicación mediante la API. Usa una concesión aprobada por el propietario o una clave de API con nombre y el ámbito authentication.
Authentication es nuevo. Configura primero un método en una aplicación de sandbox y, después, en tu aplicación de producción.
Todas las llamadas siguientes van a la API de gestión de Authentication de tu aplicación. MANAGEMENT_BASE es:
Las mismas rutas se describen en 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, mantiene scopes vacío y no se acepta en estas rutas.
  • Una clave de otra aplicación, una concesión limitada a didit:verification y una concesión aprobada para otra organización.
Una solicitud sin ninguna credencial responde con 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 recurso authentication 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, con didit: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.
Responde con el método tal como está ahora:
Al leer la configuración, la entrada del código por correo electrónico incluye 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

Registra el 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.
Los métodos deshabilitados también aparecen en la lista, así que un solo 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).

Errores

Última modificación el 20 de noviembre de 2026