--- title: "Impostazioni di verifica" description: "Imposta per quanto tempo restano validi i codici di Verify, quanti controlli errati fanno fallire una verifica, l'intervallo di attesa tra un invio e l'altro e il sito web su cui i codici vengono compilati automaticamente." canonical: "https://bird.com/it-it/documentazione/guides/verify/settings" --- # Impostazioni di verifica La scheda **General** della pagina [**Configure**](https://bird.com/dashboard/w/verify/configure) definisce il comportamento di ogni verifica nel tuo spazio di lavoro. Controlla per quanto tempo resta valido un codice, quanti tentativi errati chiudono una verifica, dopo quanto tempo si può inviare un nuovo codice e a quale sito web appartiene il codice. Ogni campo mostra il valore effettivo: il tuo valore personalizzato, se l'hai impostato, altrimenti il valore predefinito della piattaforma Bird. Un campo viene salvato quando lo lasci. **Duration**, **Maximum Retries** e **Website** vengono fissati alla creazione di una verifica, quindi una loro modifica vale per le nuove verifiche. Una modifica a **Retry Delay** vale dalla chiamata di creazione successiva, anche per una verifica già in corso. Per modificare un'impostazione serve l'autorizzazione `verify_management` a livello `write`, inclusa nei ruoli `admin` e `developer`. Il ruolo `analyst` può visualizzare la pagina. Consulta [Utenti, team e ruoli](/docs/guides/users-teams-roles#workspace-roles). ![La scheda General della pagina Configure con i campi Duration, Maximum Retries, Retry Delay e Website](/images/docs/dashboard-verify-configure-general.png) ## Ciclo di verifica | Impostazione | Cosa controlla | Predefinito | Intervallo | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------- | | **Duration** | Per quanto tempo una verifica resta aperta. Un controllo eseguito dopo questo intervallo restituisce il motivo `expired` e la verifica termina con il motivo `ttl_elapsed`. | 10 minuti | Da 1 a 999 minuti | | **Maximum Retries** | Quanti codici errati chiudono una verifica. L'ultimo la fa fallire con il motivo `attempts_exhausted`. | 5 | Da 1 a 10 | | **Retry Delay** | L'intervallo minimo tra un invio e il successivo: l'attesa minima prima che venga inviato un altro codice allo stesso destinatario. | 60 secondi | Da 0 a 3600 secondi | - **Duration** parte quando la verifica viene creata. Un nuovo invio o il passaggio a un altro canale invia un nuovo codice ma mantiene la scadenza originale, quindi un nuovo invio tardivo non estende la finestra. Per i flussi di autenticazione mantienilo a 10 minuti o meno; [Best practice](/docs/guides/verify/best-practices#keep-the-lifetime-at-ten-minutes-or-less) spiega perché. - **Maximum Retries** conta i codici errati su tutti i codici inviati per la verifica, quindi un nuovo invio non lo azzera. Un controllo con un codice errato che lascia la verifica in sospeso riporta i tentativi rimanenti in `attempts_remaining`. - **Retry Delay** si applica quando chiami di nuovo la creazione per lo stesso destinatario. Durante il periodo di attesa, la chiamata restituisce la verifica attiva senza inviare un nuovo codice. [Invia il codice su un altro canale](/docs/guides/verify/sending-verifications#send-the-code-on-another-channel) è escluso, perché il passaggio a un altro canale è una richiesta diversa da quella di ottenere di nuovo lo stesso canale. Impostalo a 0 per inviare un nuovo codice a ogni chiamata di creazione, entro i limiti per destinatario descritti in [Protezioni contro gli abusi](/docs/guides/verify/sending-verifications#abuse-guardrails). La lunghezza del codice non si imposta in questa pagina. Per impostazione predefinita i codici sono composti da sei cifre numeriche, e `options.code_length` imposta da 4 a 8 cifre per una singola verifica; vedi [Opzioni](/docs/guides/verify/sending-verifications#options). ## Compilazione automatica **Website** indica il sito in cui gli utenti inseriscono i codici, ad esempio `https://login.example.com`. Con un sito impostato, i browser possono proporre il codice su quel sito e su nessun altro, così l'utente non deve copiarlo. Lascia il campo vuoto per inviare codici che non indicano alcun sito. Scrivi il sito come `https://` seguito dal dominio in minuscolo, senza porta, percorso o barra finale. Un dominio internazionalizzato usa la forma `xn--`, ad esempio `https://xn--bcher-kva.example` per `bücher.example`. Qualsiasi altra forma viene rifiutata e, quando esiste, il messaggio indica la forma da inserire. Usa esattamente il sito che mostra il campo del codice: un modulo su `login.example.com` richiede `https://login.example.com`, non `https://example.com`. Quando una verifica ha un sito, Verify lo aggiunge ai messaggi con il codice: - **SMS**: il messaggio termina con una riga come `@login.example.com #123456`. Contrassegna il campo del codice con `autocomplete="one-time-code"` perché Safari e gli altri browser propongano il codice, e chiama la [WebOTP API](https://developer.mozilla.org/en-US/docs/Web/API/WebOTP_API) dalla pagina se vuoi che il browser lo compili senza un tocco. La riga aggiuntiva può aggiungere un segmento SMS: in molte lingue che richiedono la codifica Unicode, come arabo, greco o russo, un codice associato occupa due segmenti invece di uno, raddoppiando il costo SMS, e un dominio lungo può avere lo stesso effetto in altre lingue. - **Email**: il messaggio include un'intestazione `OTP-Token` con il codice e il sito, come definito dall'[Internet-Draft OTP-Token, revisione 01](https://datatracker.ietf.org/doc/draft-goto-otp-token/01/). I client di posta stanno appena iniziando a leggere questa intestazione, quindi considerala un'aggiunta al codice nel messaggio. Il sito viene fissato quando la verifica viene creata. Un nuovo invio, il ripiego su un altro canale o un'altra chiamata di creazione per lo stesso destinatario lo mantengono. ### Associare un codice per singola richiesta Una richiesta può indicare un proprio sito web con `options.autofill_origin`, che sostituisce **Website** per quella verifica. Usalo quando un solo spazio di lavoro serve più siti. Quando il campo del codice si trova in un iframe cross-origin, come un modulo di pagamento incorporato nel checkout di un negozio, imposta `options.autofill_origin` sul sito web dell'iframe e `options.autofill_top_level_origin` sulla pagina aperta nella scheda del browser. La riga SMS indica allora entrambi i siti, come in `@shop.example #123456 @pay.example`, e questo può aggiungere un segmento in qualsiasi lingua. Chrome compila automaticamente quel modulo quando la pagina incorpora direttamente l'iframe e gli concede `allow="otp-credentials"`. Per queste verifiche l'email non invia l'intestazione `OTP-Token`, perché l'intestazione può indicare un solo sito web. La richiesta viene rifiutata con `422` quando il sito web di primo livello non è valido, quando non è impostato alcun sito web né nella richiesta né in questa pagina, oppure quando coincide con quel sito web. ### Mittenti SMS registrati Se invii SMS dal tuo mittente registrato, come una campagna 10DLC negli Stati Uniti, aggiungi alla campagna un messaggio di esempio che termina con la riga del sito associato prima di impostare un sito web. Gli operatori possono filtrare un messaggio diverso dagli esempi registrati per la campagna. ## Risoluzione dei problemi - **Il sito web viene rifiutato.** Il valore non è nel formato richiesto. Inserisci il formato suggerito dal messaggio, ad esempio `https://example.com` per `https://Example.com/`. - **Il browser non propone il codice.** Verifica che il sito web corrisponda esattamente all'indirizzo della pagina, compreso l'eventuale sottodominio, e che il campo del codice abbia `autocomplete="one-time-code"`. Per un iframe, verifica che la richiesta imposti entrambi i siti web e che la pagina che lo incorpora conceda `allow="otp-credentials"`. La compilazione automatica dipende anche dal browser: Chrome legge la riga SMS tramite WebOTP e Safari tramite la propria compilazione automatica dei codici, mentre Firefox non supporta WebOTP ([supporto dei browser](https://caniuse.com/mdn-api_otpcredential)). - **Un codice è scaduto prima che l'utente lo inserisse.** Controlla i tempi dei tentativi nel [log di Verify](/docs/guides/verify/verify-log) prima di aumentare **Duration**. Di solito la causa è un percorso di consegna lento, e una finestra più lunga indebolisce il codice. ## Passaggi successivi - [Invio delle verifiche](/docs/guides/verify/sending-verifications): crea e controlla le verifiche, incluse le opzioni per singola richiesta. - [Destinazioni](/docs/guides/verify/destinations): scegli i canali e il loro ordine per ogni paese di destinazione. - [Mittenti e branding](/docs/guides/verify/senders): visualizza i messaggi inviati da Verify e scegli il mittente per ogni canale. ## Related resources - [Verify phone numbers at signup](/learn/series/verify-phone-numbers-at-signup) (video) - [What does OTP mean? One-time passwords explained](/explained/verify/what-does-otp-mean) (answer) - [Customer verification](/verify-api) (product) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=verify)