2FA Airbrake : comment configurer une application d’authentification

Airbrake est un service de suivi des erreurs et des performances destiné aux développeurs : votre compte contient donc les traces d’appels (stack traces) et les données d’erreur que vos apps lui envoient. L’authentification à deux facteurs (2FA) d’Airbrake fonctionne avec toute application d’authentification capable de scanner un code QR, et elle est incluse dans toutes les formules actuelles (Airbrake). Deux points se distinguent. Vos codes de récupération ne s’affichent qu’une seule fois pendant la configuration et ne peuvent plus être consultés ensuite. Et un administrateur du compte peut rendre la 2FA obligatoire pour tous les membres du compte. Ce guide utilise Authenticator App - Novaz sur iPhone. Toute application d’authentification fonctionne de la même façon.

Comment nous avons vérifié ce guide : les étapes Airbrake proviennent de la documentation d’Airbrake, y compris ses captures d’écran, que nous avons consultée le 21 octobre 2026. Airbrake a mis à jour sa page sur l’authentification à deux facteurs pour la dernière fois en octobre 2021, et certaines captures d’écran semblent plus anciennes. Nous n’avons pas testé les étapes sur un compte Airbrake : 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 2FA avec une application d’authentification

La 2FA est un réglage de votre propre profil utilisateur, et non du compte de l’entreprise (Airbrake) :

1. Connectez-vous à Airbrake et ouvrez la page de votre profil. L’écran d’Airbrake s’intitule Edit profile (modifier le profil), et le réglage se trouve dans l’onglet Profile (profil).
2. À côté de Two-factor authentication (authentification à deux facteurs), cliquez sur Enable (activer).
3. Un panneau Two-factor authentication s’ouvre avec un code QR. Dans Novaz, touchez +, puis Scanner un QR code, et pointez l’appareil photo vers l’écran. Si le code QR s’affiche sur le même iPhone, faites plutôt une capture d’écran et utilisez Choisir une photo. Consultez scanner un code QR sur le même iPhone.
4. Impossible de scanner ? Sous or manually enter the key (ou saisissez la clé manuellement), Airbrake affiche la clé par groupes de quatre caractères. Dans Novaz, touchez +, puis Saisir la clé manuellement, saisissez un nom comme Airbrake dans Service et saisissez la clé dans Clé de configuration. Consultez Qu’est-ce qu’une clé de configuration 2FA ?
5. Saisissez le code actuel de Novaz dans le champ 6-digit authentication code (code d’authentification à six chiffres) et cliquez sur Enable two-factor authentication (activer l’authentification à deux facteurs).
6. Airbrake affiche maintenant les Two-factor recovery codes (codes de récupération). Enregistrez-les (voir ci-dessous), puis cliquez sur Finish two-factor setup (terminer la configuration).

Enregistrer les codes de récupération avant de cliquer sur Finish

L’écran des codes de récupération dans la documentation d’Airbrake montre dix codes et un avertissement indiquant que vous ne les reverrez plus. Le même avertissement précise que si vous perdez votre appareil sans ces codes, « you will lose access to your account » (vous perdrez l’accès à votre compte) (Airbrake). Airbrake conseille de les conserver dans un gestionnaire de mots de passe.

Novaz conserve ses clés sur votre iPhone : sans sauvegarde Novaz (sauvegarde iCloud ou fichier de sauvegarde), un téléphone perdu ou réinitialisé emporte la clé Airbrake avec lui. Copiez les codes à un endroit accessible sans ce téléphone, comme un gestionnaire de mots de passe sur un autre appareil ou une version imprimée. La documentation d’Airbrake ne décrit aucun moyen d’en générer une nouvelle série plus tard. Plus d’informations dans Codes de secours 2FA.

Se connecter ensuite

Dès votre prochaine connexion, Airbrake affiche une page Two-factor authentication après votre mot de passe. Saisissez le code de Novaz dans 6-digit authentication code et cliquez sur Verify (vérifier). La même page comporte une case Remember this browser for 30 days (mémoriser ce navigateur pendant 30 jours), pour qu’un navigateur de confiance ne vous le demande pas à chaque fois, et un lien Recovery (récupération) pour vous connecter avec un code de récupération (Airbrake).

Quand votre administrateur impose la 2FA

Un administrateur peut activer Require all users to have two-factor authentication enabled (exiger que tous les utilisateurs aient activé l’authentification à deux facteurs) dans l’onglet Security (sécurité) de la page de sécurité du compte, puis cliquer sur Save two-factor authentication settings (enregistrer les paramètres d’authentification à deux facteurs). Tant que l’option est active, les utilisateurs ne peuvent ouvrir aucune page d’Airbrake avant d’avoir configuré la 2FA. Si un administrateur désactive de nouveau cette exigence, Airbrake en informe les autres administrateurs par e-mail (Airbrake).

Le même onglet permet aussi d’imposer à tous la connexion via GitHub ou l’authentification unique SAML. Avec la connexion GitHub, la deuxième étape est la 2FA de votre propre compte GitHub, et non celle d’Airbrake (Airbrake, Airbrake).

Si Airbrake refuse votre code

La documentation d’Airbrake ne donne aucun conseil sur les codes refusés. La cause habituelle 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. Vérifiez également que vous lisez bien l’entrée Airbrake dans Novaz, et non celle d’un autre compte. D’autres causes sont décrites dans Le code d’authentification ne fonctionne pas ?

Changer de téléphone

Airbrake ne documente ni le transfert de la 2FA vers un nouveau téléphone, ni sa désactivation. Avec une sauvegarde iCloud Novaz ou un fichier de sauvegarde, vous pouvez restaurer le compte sur le nouvel iPhone et vous dispenser de cette étape. Sans sauvegarde, le nouveau téléphone a besoin d’un nouveau code QR d’Airbrake. Cherchez sur la page de votre profil un moyen de l’obtenir tant que l’ancien téléphone fonctionne encore, et gardez l’ancien téléphone et vos codes de récupération jusqu’à ce que vous vous soyez connecté avec un code du nouveau. Consultez Comment transférer votre application d’authentification sur un nouvel iPhone.

Si vous perdez votre application d’authentification

Connectez-vous avec votre mot de passe, puis suivez le lien Recovery sur la page du code et saisissez l’un de vos codes de récupération (Airbrake). Une fois connecté, configurez de nouveau la 2FA avec votre nouveau téléphone.

Sans les codes, l’écran de configuration d’Airbrake avertit lui-même que vous perdrez l’accès au compte. Sa documentation ne décrit ni procédure d’assistance pour retirer la 2FA, ni les justificatifs qui seraient demandés, ni le délai. La documentation indique support@airbrake.io comme adresse de contact : c’est donc là qu’il faut s’adresser. Plus d’informations dans Vous avez perdu le téléphone qui contient votre application d’authentification ?

Aide officielle d’Airbrake

• Two-factor authentication (authentification à deux facteurs)
• Security (sécurité)
• GitHub logins (connexions GitHub)