2FA Appwrite : comment configurer une application d’authentification pour votre compte Console

Appwrite propose deux types d’authentification multifacteur (MFA), et il est facile de tomber sur la mauvaise page. L’un est une fonction que vous intégrez à votre propre app pour vos utilisateurs. L’autre protège votre propre compte de développeur, celui avec lequel vous vous connectez à l’Appwrite Console pour gérer vos organisations et vos projets. Ce guide porte sur le second (Appwrite). Si vous voulez la MFA pour les personnes qui utilisent votre app, Appwrite traite ce cas dans sa documentation Auth.

Pour votre compte Console, la MFA est facultative. La documentation d’Appwrite cite comme méthode prise en charge un code basé sur le temps généré par une application d’authentification (TOTP), et indique que d’autres facteurs arriveront plus tard (Appwrite). Nous utilisons Authenticator App - Novaz sur iPhone dans les étapes ci-dessous, mais toute application d’authentification fonctionne de la même façon.

Comment nous avons vérifié ce guide : les étapes Appwrite proviennent de la documentation d’Appwrite et de ses captures d’écran, citées ci-dessous, que nous avons consultées le 21 octobre 2026. Nous ne les avons pas testées sur un compte Appwrite : un libellé peut donc légèrement différer. Les étapes Novaz ont été vérifiées dans l’app, version 1.0.5.

Activer la MFA avec une application d’authentification

La page d’Appwrite est courte, et son texte et ses captures d’écran utilisent des libellés légèrement différents. Ces étapes suivent les deux (Appwrite) :

1. Connectez-vous à l’Appwrite Console. Ouvrez le menu de votre compte en haut à droite et choisissez Your account (votre compte).
2. Allez dans les paramètres de sécurité. Sur la capture d’écran d’Appwrite, il s’agit de Security (sécurité) dans la liste de gauche, avec une carte Multi-factor authentication (authentification multifacteur) sur la page.
3. Activez l’interrupteur Multi-factor authentication.
4. Ajoutez l’application d’authentification. Le texte appelle le bouton Add authentication factor (ajouter un facteur d’authentification) ; la capture d’écran montre une ligne Authenticator app (application d’authentification) avec un bouton Add (ajouter).
5. Une fenêtre Scan QR code (scanner le code QR) s’ouvre. Dans Novaz, touchez +, puis Scanner un QR code, et pointez l’appareil photo vers le code. Si la Console est ouverte sur le même iPhone, faites une capture d’écran et utilisez plutôt Choisir une photo. Consultez scanner un code QR sur le même iPhone.
6. Si vous ne pouvez pas scanner, la même fenêtre affiche un Manual entry code (code de saisie manuelle) avec un bouton de copie. Dans Novaz, touchez +, puis Saisir la clé manuellement, saisissez un nom comme Appwrite dans Service et collez le code dans Clé de configuration. Consultez Qu’est-ce qu’une clé de configuration 2FA ?
7. Choisissez Continue (continuer) et saisissez le code actuel de Novaz pour terminer la configuration.
8. Enregistrez vos codes de récupération (section suivante).

La documentation ne précise ni le nombre de chiffres des codes ni leur fréquence de renouvellement. Scanner le code QR est la solution la plus sûre, car il transmet ces paramètres à votre app. Une clé saisie à la main vous donne des codes à six chiffres toutes les 30 secondes.

Les codes de récupération sont votre seul recours

Appwrite est particulièrement direct sur ce point. Sa documentation présente les codes de récupération comme « the only way to access your account if you lose access to your authenticator app » (le seul moyen d’accéder à votre compte si vous perdez l’accès à votre application d’authentification) (Appwrite). Elle ne décrit aucune voie d’assistance pour un compte Console bloqué.

Sa capture d’écran montre une ligne Recovery codes (codes de récupération) avec un bouton View (afficher) sur la même page de paramètres : vous pouvez donc les consulter de nouveau tant que vous êtes connecté. Conservez-en une copie ailleurs que sur votre téléphone, par exemple dans un gestionnaire de mots de passe ou sur papier. Si vous n’avez pas de sauvegarde Novaz, ou si elle est antérieure à votre compte Appwrite, ces codes sont votre moyen de récupérer l’accès. Plus d’informations dans Codes de secours 2FA.

La même capture d’écran liste aussi Email (e-mail) comme facteur, avec des codes à usage unique envoyés à l’adresse validée du compte. Le texte de la page ne mentionne que l’application d’authentification : la documentation ne nous permet donc pas de vous dire si les codes par e-mail servent de solution de repli à la connexion.

Si Appwrite refuse votre code

La documentation d’Appwrite ne traite pas des codes refusés. La cause la plus fréquente est l’horloge de l’iPhone : ouvrez Réglages › Général › Date et heure et activez Réglage automatique. Novaz vous avertit aussi lorsque l’horloge est décalée de 15 secondes ou plus. Si vous avez saisi la clé à la main, vérifiez que vous l’avez copiée en entier. D’autres causes sont décrites dans Le code d’authentification ne fonctionne pas ?

Changer de téléphone

Appwrite ne documente ni le transfert de la MFA vers un nouveau téléphone, ni le remplacement de l’application d’authentification, ni la désactivation de la MFA. Faites-le tant que vous pouvez encore vous connecter avec l’ancien téléphone, depuis la même carte Multi-factor authentication. Si vous avez activé la sauvegarde iCloud de Novaz ou exporté un fichier de sauvegarde, vous pouvez restaurer Appwrite sur le nouveau téléphone ; sinon, vous l’ajouterez sur le nouveau téléphone comme un nouveau compte. Consultez Comment transférer votre application d’authentification sur un nouvel iPhone.

Si vous perdez votre application d’authentification

Connectez-vous avec l’un de vos codes de récupération, puis configurez de nouveau l’application d’authentification sur votre nouveau téléphone. Sans les codes de récupération, la documentation d’Appwrite ne propose aucune autre voie pour récupérer le compte. Plus d’informations dans Vous avez perdu le téléphone qui contient votre application d’authentification ?

Aide officielle d’Appwrite

• Multi-factor authentication (authentification multifacteur ; votre compte Console)
• Multi-factor authentication (authentification multifacteur ; Appwrite Auth, pour les utilisateurs de votre app)
• Security (sécurité)