authentication.
Ogni chiamata riportata di seguito viene effettuata sull’API di gestione di Authentication della tua applicazione. MANAGEMENT_BASE è:
openapi-authentication.json sotto il tag Setup, da cui gli SDK lato server vengono rigenerati.
Quale credenziale usare
È utilizzabile una qualsiasi delle tre credenziali, e ciascuna è limitata a ciò che il suo titolare ha approvato.
Queste credenziali vengono rifiutate con
403 su ogni percorso di configurazione, indipendentemente da ciò che la richiesta chiede:
- Il segreto primario dell’applicazione.
- Un token ottenuto da
POST /programmatic/login, che viene emesso per l’applicazione e non per la console. - Una chiave senza l’ambito
authentication, inclusa una chiave creata con ogni risorsa al livello più alto: queste vengono elencate con accesso completo, mantengonoscopesvuoto e non sono accettate su questi percorsi. - Una chiave di un’altra applicazione, una concessione limitata a
didit:verification, e una concessione approvata per un’altra organizzazione.
401. Una concessione o una chiave mantengono inoltre i propri limiti: la concessione i suoi ambiti, le organizzazioni e il ruolo della persona, la chiave i suoi ambiti, l’elenco di indirizzi IP consentiti e la scadenza.
Approva l’accesso
Con una chiave API con nome
Apri Developers -> API keys nella Business Console e crea una chiave per l’applicazione che stai configurando. Assegnale la risorsaauthentication con autorizzazione di lettura o scrittura: la lettura copre ogni chiamata che legge la configurazione (GET); la scrittura copre ogni chiamata che la modifica (POST, PUT, PATCH, DELETE) e permette anche di leggerla. Consulta Chiavi API per la scadenza, le liste di indirizzi IP consentiti e la rotazione; una chiave appartiene a una sola applicazione e funziona solo per quella.
Tramite una connessione MCP
Un agente connesso al server MCP di Didit usa l’autorizzazione approvata dal suo titolare nella schermata di consenso, condidit:management. Consulta Autenticazione MCP.
Per un proprietario senza password
Il flusso di autorizzazione tramite codice dispositivo (RFC 8628) permette a un proprietario che accede con Google, una passkey o un codice inviato via email di approvare lo stesso accesso da qualsiasi browser, senza digitare una password. Consulta accedere senza browser.Attiva il codice via email
PUT methods/{name}/ accetta enabled e nient’altro per un metodo che non richiede credenziali.
credential_source: null. I metodi sempre attivi non possono essere disattivati: quella richiesta risponde {"enabled": "always_on"}.
Abilitare Google
Un metodo social richiede le credenziali della tua app OAuth, oppure quelle dell’app di test di Didit su un’applicazione sandbox.Con la tua app Google
callback_uri restituito dalla risposta. Il segreto è solo in scrittura: nessuna risposta lo restituisce, e client_id è l’unica parte che puoi rileggere. Attivare un metodo senza credenziali, quando prima non ne erano state salvate, restituisce {"credentials": "required"}.
Con l’app di test di Didit (didit_test)
Un’applicazione sandbox può usare le app social di Didit al posto delle tue, il che basta per completare una configurazione e verificarne il funzionamento:
didit_test copre Google, Microsoft, Apple e GitHub, solo su applicazioni sandbox:
La
GET sulla configurazione indica in didit_test_credentials i provider che un’app di test può servire per questa applicazione; il valore è false per tutti e quattro su un’applicazione in produzione.
Leggere nuovamente la configurazione
GET su MANAGEMENT_BASE restituisce la configurazione completa: ogni metodo con enabled e credential_source, oltre agli URL di callback, alle regole di sessione e alla policy di registrazione.
GET indica cosa è attivo e cosa no. enabled in alto è false quando Authentication è disattivata per l’applicazione. Qualsiasi modifica alla configurazione effettuata con un’autorizzazione di gestione o con una chiave API nominata restituisce 409 con {"detail": "product_disabled"} e non scrive nulla. Nessuna chiamata di configurazione attiva Authentication: una persona la attiva per l’applicazione nella console, e le tue chiamate funzionano da quel momento in poi.
Il resto della configurazione
Un’autorizzazione o una chiave ottiene la configurazione e i relativi contatori, mai i dati degli utenti finali:
users/, sessions/, sign-ins/, overview/, le organizzazioni clienti, i ruoli, le importazioni, le sessioni degli agenti e le email di test richiedono ancora una sessione nella console.
L’impostazione agent_humans_only si applica all’intera applicazione. Solo il proprietario o un amministratore dell’organizzazione può modificarla. Una chiave nominativa riceve 403 owner_or_admin_required. Attivare l’impostazione richiede inoltre una passkey registrata (passkey_required).