Autenticarsi con l'API

GraphQL supporta due modalità di autenticazione:

Modalità	Copertura	Intestazione	Ideale per
SRP	Schema GraphQL completo	Authorization: Bearer <access-token>	Integrazioni complete
API Key	Sottoinsieme supportato solo	Authorization: Bearer <api-key>	Automazione lato server e flussi comuni di invio/lettura

SRP è il metodo di autenticazione a schema completo. Le chiavi API create nel Developer Portal possono accedere a un sottoinsieme supportato di operazioni GraphQL.

Autenticazione con API Key

Crea una API key abilitata per GraphQL nel Developer Portal, quindi inviala come token bearer:

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 } }"}

Controlla la riferimento GraphQL per API-key e i badge di autenticazione nelle pagine di riferimento di query e mutation prima di utilizzare un'operazione con una API key.

Autorizzazione Widget e Componenti

I widget autenticati, come il Document Viewer e il Signer, necessitano che venga passato un token al loro attributo token.

Ci sono due modi supportati lato server per fornire questo token:

Fonte del token	Come funziona
SRP JWT	Il tuo server usa SRP per ottenere un token di accesso JWT e passa quel JWT al widget
Token componente	Il tuo server usa una API key per chiamare generateComponentToken, quindi passa il token restituito al widget

generateComponentToken è riservato all'API key e restituisce un token a breve durata per i widget. SRP rimane l'opzione a schema completo quando il tuo backend deve fornire un JWT direttamente.

Consulta Autorizzazione Widget per il flusso completo del token componente e le indicazioni di sicurezza del browser.

Autenticazione SRP

Usa SRP quando hai bisogno di accesso completo allo schema GraphQL.

Credenziali API

Per usare l'autenticazione SRP, contatta il supporto Legalesign per ottenere le credenziali e i dettagli della tua integrazione.