2FA Bitrise : configurer une application d’authentification

Bitrise est une plateforme de CI/CD mobile : votre compte Bitrise personnel vous donne accès aux espaces de travail et aux projets où s’exécutent vos builds iOS et Android. L’authentification à deux facteurs (2FA) est facultative et utilise une application d’authentification. Avant de l’activer, sachez une chose sur Bitrise : si vous perdez à la fois votre application d’authentification et vos codes de récupération, Bitrise indique que son équipe d’assistance ne peut généralement pas désactiver la 2FA pour vous (Bitrise). Ce guide consacre donc autant de place à la solution de secours qu’à la configuration.

La documentation de Bitrise cite Google Authenticator, mais la configuration repose sur un code QR standard : toute application d’authentification fonctionne donc. Nous utilisons Authenticator App - Novaz sur iPhone dans les étapes ci-dessous.

Comment nous avons vérifié ce guide : les étapes Bitrise proviennent de la documentation de Bitrise, captures d’écran comprises, indiquée ci-dessous, que nous avons consultée le 21 octobre 2026. Nous ne les avons pas testées sur un compte Bitrise : 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

Le réglage se trouve dans votre compte personnel, et non dans un espace de travail (Bitrise) :

1. Connectez-vous à Bitrise et choisissez Bitrise CI dans le menu de navigation de gauche.
2. Cliquez sur votre photo de profil en haut à droite, puis choisissez Account settings (paramètres du compte).
3. Choisissez Security (sécurité) à gauche.
4. Sous Two-factor authentication (authentification à deux facteurs), cliquez sur l’interrupteur 2FA is enabled (2FA activée). (La documentation de Bitrise utilise ce libellé aussi bien pour l’activer que pour la désactiver.)
5. Un code QR apparaît. Dans Novaz, touchez +, puis Scanner un QR code, et pointez l’appareil photo vers le code. 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.
6. Saisissez dans Bitrise le code à six chiffres affiché par Novaz.
7. Conservez les codes de récupération que Bitrise vous fournit.

Une fois la 2FA activée et vos codes de récupération conservés, Bitrise envoie un e-mail de confirmation depuis letsconnect@bitrise.io.

La page de Bitrise ne mentionne pas de clé texte à saisir à la place du scan. Si vous en trouvez une sur l’écran de configuration, dans Novaz, touchez +, puis Saisir la clé manuellement, et collez-la dans Clé de configuration. Consultez Qu’est-ce qu’une clé de configuration 2FA ?

Vos codes de récupération sont la vraie solution de secours

Sans sauvegarde Novaz (sauvegarde iCloud ou fichier de sauvegarde), ses clés n’existent que sur votre iPhone, et dans tous les cas les codes de récupération sont votre seule solution de repli côté Bitrise. Conservez-les dans un gestionnaire de mots de passe ou imprimez-les, et gardez-les loin du téléphone.

La capture d’écran de la page Security fournie par Bitrise montre une section Recovery codes (codes de récupération) avec un bouton New recovery codes (nouveaux codes de récupération) : c’est là que vous obtiendriez une nouvelle série. Le texte de la page n’indique ni le nombre de codes fournis ni ce que deviennent les anciens. Plus d’informations sur leur conservation dans Codes de secours 2FA.

Quand Bitrise demande un code

Bitrise présente la 2FA comme une étape supplémentaire de la connexion (Bitrise). Sa documentation ne dit pas si vous pouvez marquer un navigateur comme fiable, ni à quelle fréquence le code vous sera demandé.

Si votre espace de travail impose le SSO SAML, vous vous connectez via le fournisseur d’identité de votre entreprise, qui peut appliquer ses propres règles de 2FA (Bitrise). Dans ce cas, c’est la configuration de votre employeur qui détermine comment vous prouvez votre identité.

Si Bitrise refuse votre code

La documentation de Bitrise 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 lorsque l’horloge est décalée de 15 secondes ou plus. Notez aussi que des échecs de connexion répétés peuvent verrouiller votre compte Bitrise ; Bitrise vous envoie alors par e-mail les instructions de déverrouillage (Bitrise). Les autres causes sont décrites dans Le code d’authentification ne fonctionne pas ?

Changer de téléphone

Bitrise ne décrit aucun moyen de transférer la 2FA vers un nouveau téléphone. Avec une sauvegarde iCloud ou un fichier de sauvegarde Novaz, il vous suffit de restaurer vos comptes sur le nouvel iPhone. Sans sauvegarde, notez que, selon la documentation de Bitrise, la désactivation de la 2FA ne demande que votre mot de passe Bitrise lorsque vous êtes connecté : tant que vous avez encore l’ancien téléphone, vous pouvez donc désactiver puis réactiver la 2FA, et scanner le nouveau code QR avec le nouvel iPhone. Conservez les nouveaux codes de récupération. Consultez Comment transférer votre application d’authentification vers un nouvel iPhone.

Si vous perdez votre application d’authentification

Commencez par un code de récupération. Sans code, vos options sont limitées (Bitrise) :

• Un compte Git associé. Si vous avez auparavant associé GitHub, GitLab ou Bitbucket à Bitrise, Bitrise suggère d’essayer de vous connecter par ce biais. Vous pouvez les associer depuis votre compte (Bitrise) : mieux vaut le faire avant d’en avoir besoin.
• L’assistance Bitrise, dans de rares cas. Bitrise ne peut supprimer la 2FA que si un compte de fournisseur Git est déjà associé. Écrivez à l’assistance depuis l’adresse utilisée lors de votre inscription et expliquez pourquoi. L’assistance vous demandera de créer sur ce compte Git un nouveau dépôt public nommé bitrise_verification et de lui en envoyer le lien. Elle peut tout de même refuser si la suppression de la 2FA semble présenter un risque de sécurité.
• Un nouveau compte. Sans compte Git associé, Bitrise recommande de créer un nouveau compte Bitrise.

Bitrise n’indique pas le délai de traitement d’une demande d’assistance. Plus d’informations dans Vous avez perdu le téléphone qui contient votre application d’authentification ?

Désactiver la 2FA

Allez dans Account settings › Security, cliquez sur 2FA is enabled sous Two-factor authentication, saisissez votre mot de passe Bitrise dans la fenêtre Edit profile (modifier le profil), puis cliquez sur Done (terminé) (Bitrise). Ouvrez ensuite l’entrée Bitrise dans Novaz et touchez Supprimer le compte.

Aide officielle de Bitrise

• Two-factor authentication (authentification à deux facteurs)
• Accounts overview (présentation des comptes)
• Configuring SAML SSO on Bitrise (configurer le SSO SAML sur Bitrise)
• Resetting your password (réinitialiser votre mot de passe)