Vai al contenuto principale
Didit Authentication ti permette di abilitare i metodi di accesso e di leggere via API le impostazioni della tua applicazione. Usa un’autorizzazione approvata dal titolare oppure una chiave API denominata con lo scope authentication.
Authentication è una novità. Configura prima un metodo in un’applicazione sandbox, poi nella tua applicazione live.
Ogni chiamata riportata di seguito viene effettuata sull’API di gestione di Authentication della tua applicazione. MANAGEMENT_BASE è:
Gli stessi percorsi sono descritti da 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, mantengono scopes vuoto 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.
Una richiesta senza alcuna credenziale riceve 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 risorsa authentication 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, con didit: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.
La risposta riporta il metodo nello stato attuale:
Quando rileggi la configurazione, la voce per il codice via email include 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

Registra presso il tuo provider il 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.
Anche i metodi disabilitati sono elencati, quindi una sola richiesta 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).

Errori

Ultima modifica il 20 novembre 2026