Autenticarse con la API

GraphQL soporta dos modos de autenticación:

Modo	Cobertura	Encabezado	Mejor para
SRP	Esquema completo de GraphQL	Authorization: Bearer <access-token>	Integraciones completas
Clave API	Solo subconjunto soportado	Authorization: Bearer <api-key>	Automatización del lado del servidor y flujos comunes de envío/lectura

SRP es el método de autenticación de esquema completo. Las claves API creadas en el Developer Portal pueden acceder a un subconjunto soportado de operaciones GraphQL.

Autenticación con Clave API

Cree una clave API habilitada para GraphQL en el Developer Portal, luego envíela como un token portador:

POST /graphql HTTP/1.1
Host: graphql.uk.legalesign.com
Content-Type: application/json
Authorization: Bearer ak_<environment>_<key-id>.<secret>

{"query": "{ user { id email } }"}

Consulte la referencia GraphQL para clave API y las insignias de autenticación en las páginas de referencia de consultas y mutaciones antes de usar una operación con una clave API.

Autorización de Widget y Componente

Los widgets autenticados, como el Document Viewer, necesitan un token pasado a su atributo token.

Hay dos formas soportadas del lado del servidor para proporcionar ese token:

Fuente del token	Cómo funciona
SRP JWT	Su servidor usa SRP para obtener un token JWT de acceso y pasa ese JWT al widget
Token de componente	Su servidor utiliza una clave API para llamar a generateComponentToken, luego pasa el token retornado al widget

generateComponentToken es solo para clave API y devuelve un token de corta duración para widgets. SRP sigue siendo la opción de esquema completo cuando su backend debe proporcionar un JWT directamente.

Consulte Autorización de Widgets para el flujo completo del token de componente y guías de seguridad para navegador.

Autenticación SRP

Use SRP cuando necesite acceso completo al esquema GraphQL.

Credenciales API

Para usar autenticación SRP, contacte al soporte de Legalesign para obtener las credenciales y detalles para su integración.