--- title: "Paramètres de vérification" description: "Définissez la durée de validité des codes Verify, le nombre de contrôles erronés qui font échouer une vérification, le délai avant renvoi et le site web sur lequel les codes sont remplis automatiquement." canonical: "https://bird.com/fr-fr/documentation/guides/verify/settings" --- # Paramètres de vérification L’onglet **General** de la page [**Configure**](https://bird.com/dashboard/w/verify/configure) définit le comportement de chaque vérification de votre espace de travail. Il détermine la durée de validité d’un code, le nombre de tentatives erronées qui mettent fin à une vérification, le délai avant l’envoi d’un nouveau code et le site web auquel le code est associé. Chaque champ affiche la valeur effective : votre valeur personnalisée si vous en avez défini une, sinon la valeur par défaut de la plateforme Bird. Un champ est enregistré dès que vous le quittez. **Duration**, **Maximum Retries** et **Website** sont figés à la création d’une vérification : leur modification s’applique donc aux nouvelles vérifications. Une modification de **Retry Delay** s’applique au prochain appel de création, y compris pour une vérification déjà en cours. Pour modifier un paramètre, vous avez besoin de l’autorisation `verify_management` au niveau `write`, incluse dans les rôles `admin` et `developer`. Le rôle `analyst` peut consulter la page. Consultez [Utilisateurs, équipes et rôles](/docs/guides/users-teams-roles#workspace-roles). ![L’onglet General de la page Configure avec les champs Duration, Maximum Retries, Retry Delay et Website](/images/docs/dashboard-verify-configure-general.png) ## Cycle de vérification | Paramètre | Ce qu’il détermine | Valeur par défaut | Plage | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | --------------------- | | **Duration** | Durée pendant laquelle une vérification reste ouverte. Une vérification du code effectuée après ce délai renvoie le motif `expired`, et la vérification se termine avec le motif `ttl_elapsed`. | 10 minutes | De 1 à 999 minutes | | **Maximum Retries** | Nombre de codes incorrects qui mettent fin à une vérification. Le dernier la fait échouer avec le motif `attempts_exhausted`. | 5 | De 1 à 10 | | **Retry Delay** | Le délai de renvoi : l'attente minimale avant l'envoi d'un autre code au même destinataire. | 60 secondes | De 0 à 3 600 secondes | - **Duration** démarre à la création de la vérification. Un renvoi ou un passage à un autre canal envoie un nouveau code, mais conserve l’expiration d’origine : un renvoi tardif ne prolonge donc pas la fenêtre. Pour les parcours d’authentification, gardez une valeur de 10 minutes ou moins ; [Bonnes pratiques](/docs/guides/verify/best-practices#keep-the-lifetime-at-ten-minutes-or-less) explique pourquoi. - **Maximum Retries** compte les codes erronés sur l’ensemble des codes envoyés pour la vérification : un renvoi ne le remet donc pas à zéro. Lorsqu’un contrôle avec un code erroné laisse la vérification en attente, la réponse indique le nombre de tentatives restantes dans `attempts_remaining`. - **Retry Delay** s’applique lorsque vous appelez à nouveau la création pour le même destinataire. Pendant le délai d’attente, l’appel renvoie la vérification en cours sans envoyer de nouveau code. [Envoyer le code sur un autre canal](/docs/guides/verify/sending-verifications#send-the-code-on-another-channel) n’est pas concerné, car un changement de canal est une requête différente d’une nouvelle demande sur le même canal. Définissez-le sur 0 pour envoyer un nouveau code à chaque appel de création, dans les limites par destinataire décrites dans [Garde-fous contre les abus](/docs/guides/verify/sending-verifications#abuse-guardrails). La longueur du code ne se règle pas sur cette page. Par défaut, les codes comportent six chiffres, et `options.code_length` définit de 4 à 8 chiffres pour une vérification ; consultez [Options](/docs/guides/verify/sending-verifications#options). ## Saisie automatique **Website** indique le site sur lequel vos utilisateurs saisissent leurs codes, par exemple `https://login.example.com`. Lorsqu’un site web est défini, les navigateurs peuvent proposer le code sur ce site et sur aucun autre, ce qui évite à l’utilisateur de le copier. Laissez le champ vide pour envoyer des codes qui ne mentionnent aucun site web. Écrivez le site web sous la forme `https://` suivi de son domaine en minuscules, sans port, chemin ni barre oblique finale. Un domaine internationalisé utilise sa forme `xn--`, par exemple `https://xn--bcher-kva.example` pour `bücher.example`. Toute autre forme est refusée, et le message indique la forme à saisir lorsqu’elle existe. Utilisez exactement le site qui affiche le champ du code : un formulaire sur `login.example.com` nécessite `https://login.example.com`, et non `https://example.com`. Lorsqu’une vérification a un site web, Verify l’ajoute aux messages contenant le code : - **SMS** : le message se termine par une ligne telle que `@login.example.com #123456`. Ajoutez `autocomplete="one-time-code"` à votre champ de saisie du code pour que Safari et les autres navigateurs proposent le code, et appelez l’[API WebOTP](https://developer.mozilla.org/en-US/docs/Web/API/WebOTP_API) depuis la page si vous voulez que le navigateur le remplisse sans action de l’utilisateur. Cette ligne supplémentaire peut ajouter un segment SMS : dans de nombreuses langues qui nécessitent l’encodage Unicode, comme l’arabe, le grec ou le russe, un code lié occupe deux segments au lieu d’un, ce qui double son coût SMS. Un domaine long peut avoir le même effet dans d’autres langues. - **E-mail** : le message contient un en-tête `OTP-Token` avec le code et le site web, tel que défini par l’[Internet-Draft OTP-Token, révision 01](https://datatracker.ietf.org/doc/draft-goto-otp-token/01/). Les applications de messagerie commencent seulement à lire cet en-tête : considérez-le comme un complément au code présent dans le message. Le site web est fixé à la création de la vérification. Un renvoi, un basculement vers un autre canal ou un nouvel appel de création pour le même destinataire le conserve. ### Lier un code par requête Une requête peut indiquer son propre site web avec `options.autofill_origin`, qui remplace **Website** pour cette vérification. Utilisez-le lorsqu’un même espace de travail dessert plusieurs sites. Lorsque le champ du code se trouve dans un iframe d’une autre origine, comme un formulaire de paiement intégré à la page de commande d’une boutique, définissez `options.autofill_origin` sur le site web de l’iframe et `options.autofill_top_level_origin` sur la page affichée dans l’onglet du navigateur. La ligne SMS indique alors les deux sites, comme dans `@shop.example #123456 @pay.example`, ce qui peut ajouter un segment dans n’importe quelle langue. Chrome remplit automatiquement ce formulaire lorsque la page intègre directement l’iframe et lui accorde `allow="otp-credentials"`. L’e-mail n’envoie pas d’en-tête `OTP-Token` pour ces vérifications, car cet en-tête ne peut indiquer qu’un seul site web. La requête est rejetée avec `422` lorsque le site web de premier niveau est mal formé, lorsqu’aucun site web n’est défini dans la requête ni sur cette page, ou lorsqu’il est identique à ce site web. ### Expéditeurs SMS enregistrés Si vous envoyez des SMS depuis votre propre expéditeur enregistré, comme une campagne 10DLC aux États-Unis, ajoutez à la campagne un exemple de message qui se termine par la ligne liée avant de définir un site web. Les opérateurs peuvent filtrer un message qui diffère des exemples enregistrés pour la campagne. ## Dépannage - **Le site web est rejeté.** La valeur n’a pas le format requis. Saisissez le format suggéré par le message, par exemple `https://example.com` pour `https://Example.com/`. - **Le navigateur ne propose pas le code.** Vérifiez que le site web correspond exactement à l’adresse de la page, sous-domaine compris, et que le champ du code comporte `autocomplete="one-time-code"`. Pour un iframe, vérifiez que la requête définit les deux sites web et que la page qui l’intègre accorde `allow="otp-credentials"`. Le remplissage automatique dépend aussi du navigateur : Chrome lit la ligne SMS via WebOTP et Safari via son remplissage automatique des codes, tandis que Firefox ne prend pas en charge WebOTP ([prise en charge par les navigateurs](https://caniuse.com/mdn-api_otpcredential)). - **Un code a expiré avant que l’utilisateur le saisisse.** Consultez le minutage des tentatives dans le [journal Verify](/docs/guides/verify/verify-log) avant d’augmenter **Duration**. La cause est généralement un acheminement lent, et une fenêtre plus longue affaiblit le code. ## Étapes suivantes - [Envoyer des vérifications](/docs/guides/verify/sending-verifications) : créez et contrôlez des vérifications, y compris avec des options propres à chaque requête. - [Destinations](/docs/guides/verify/destinations) : choisissez les canaux et leur ordre pour chaque pays de destination. - [Expéditeurs et image de marque](/docs/guides/verify/senders) : consultez les messages envoyés par Verify et choisissez l’expéditeur de chaque canal. ## 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)