2FA Buddy : comment configurer une application d’authentification

Buddy est la plateforme CI/CD de buddy.works sur laquelle les équipes compilent, testent et déploient du code au moyen de pipelines. Avant de chercher le réglage, vérifiez votre offre : la documentation de Buddy indique que l’authentification à deux facteurs (2FA) n’est pas disponible dans l’offre gratuite (Buddy). Avec une offre payante, chaque personne l’active pour son propre compte, et un propriétaire ou un administrateur d’espace de travail peut la rendre obligatoire pour tout l’espace de travail.

Buddy propose deux méthodes : un code par SMS ou une application d’authentification. Ce guide traite de l’application. Nous utilisons Authenticator App - Novaz sur iPhone, mais toute application d’authentification suit les mêmes étapes.

Comment nous avons vérifié ce guide : les étapes Buddy proviennent de la documentation et du blog de Buddy, y compris les captures d’écran de sa documentation, indiqués ci-dessous, que nous avons consultés le 21 octobre 2026. Nous ne les avons pas testées sur un compte Buddy : 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 les paramètres de votre compte personnel, que Buddy appelle My ID (mon identifiant), et non dans Workspace Settings (paramètres de l’espace de travail) (Buddy) :

1. Ouvrez My ID et allez dans l’onglet Security (sécurité).
2. Dans la section Two-Factor Authentication (authentification à deux facteurs), cliquez sur le bouton +. Choisissez Enable authentication app (activer l’application d’authentification) ; l’autre option, Enable text message (activer les SMS), correspond au SMS.
3. Une page intitulée Set up 2FA via a third-party authenticator (configurer la 2FA avec une application d’authentification tierce) s’ouvre avec un code QR. Dans Novaz, touchez +, puis Scanner un QR code, et pointez l’appareil photo vers l’écran. Si vous consultez Buddy 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.
4. À côté du code QR se trouve un bouton Show code (afficher le code). La documentation de Buddy ne l’explique pas. S’il vous donne une clé en texte, vous pouvez toucher +, puis Saisir la clé manuellement dans Novaz et la coller dans Clé de configuration. Buddy ne précise pas la durée de validité de ses codes : scanner le code QR est donc le choix le plus sûr. Consultez Qu’est-ce qu’une clé de configuration 2FA ?
5. Saisissez le code à six chiffres de Novaz dans Auth code (code d’authentification) et cliquez sur Enable 2FA (activer la 2FA).
6. Buddy affiche ensuite vos codes de récupération (section suivante).

Une fois l’opération terminée, la section Two-Factor Authentication indique Authenticator App (application d’authentification) comme méthode.

Télécharger les codes de récupération

Buddy crée des codes de récupération pendant la configuration, et l’écran ne vous laisse pas continuer tant que vous ne les avez pas téléchargés. La capture d’écran de la documentation de Buddy montre dix codes à six chiffres avec un bouton Download (télécharger) et un bouton de copie (Buddy). Buddy suggère de les conserver dans un gestionnaire de mots de passe.

Si vous n’avez pas fait de sauvegarde Novaz avec la sauvegarde iCloud ou un fichier de sauvegarde, ses clés n’existent que sur votre iPhone : ces codes sont donc ce qui vous permet de vous connecter si ce téléphone disparaît. Conservez-les loin du téléphone. Plus d’informations dans Codes de secours 2FA.

Pour les revoir plus tard, cliquez sur + dans la section Two-Factor Authentication et choisissez Show backup codes (afficher les codes de secours). L’élément de menu et le titre de l’écran n’emploient pas les mêmes mots, mais il s’agit des mêmes codes. L’annonce de Buddy en 2018 indiquait que vous pouviez aussi les régénérer à tout moment depuis My ID (Buddy) ; la documentation actuelle ne mentionne pas de régénération.

Si votre espace de travail impose la 2FA

Les propriétaires et administrateurs d’espace de travail peuvent activer Enforce 2FA (imposer la 2FA) dans Workspace Settings › Security. Dès lors, les membres qui n’ont pas activé la 2FA ne peuvent plus se connecter à l’espace de travail (Buddy). Si vous êtes bloqué, configurez la 2FA dans My ID comme indiqué ci-dessus.

Avec l’authentification unique (SSO), les membres qui ont activé la 2FA se connectent auprès de leur fournisseur d’identité et confirment quand même avec leur méthode 2FA Buddy (Buddy).

Git sur HTTPS exige un jeton

Si vous hébergez des dépôts sur Buddy lui-même, activer la 2FA change la façon dont Git se connecte. Depuis le 14 janvier 2022, Buddy n’accepte plus votre nom d’utilisateur et votre mot de passe pour Git sur HTTPS une fois la 2FA activée. Utilisez plutôt un jeton d’accès personnel ou une clé SSH (Buddy). Les deux se configurent dans le même onglet Security de My ID.

Si Buddy refuse votre code

La documentation de Buddy ne donne aucun conseil sur les codes refusés. La plupart du temps, l’horloge de l’iPhone est décalée : allez dans Réglages › Général › Date et heure et activez Réglage automatique. Novaz affiche un avertissement lorsque l’horloge est décalée de 15 secondes ou plus. Pour les autres causes, consultez Le code d’authentification ne fonctionne pas ?

Nouveau téléphone ou téléphone perdu

La documentation de Buddy ne décrit pas comment transférer la 2FA vers un nouveau téléphone ni comment passer de l’app au SMS. La capture d’écran d’un compte activé montre un menu (trois points) à côté de Authenticator App, mais la page ne dit pas ce qu’il propose. Dans Novaz, vous pouvez restaurer vos comptes sur le nouvel iPhone depuis la sauvegarde iCloud ou un fichier de sauvegarde. Dans tous les cas, gardez l’ancien téléphone jusqu’à ce que la 2FA de Buddy fonctionne sur le nouveau. Consultez Comment transférer votre application d’authentification sur un nouvel iPhone.

Si le téléphone est perdu, connectez-vous avec l’un de vos codes de récupération. Buddy prévient que sans ces codes, vous ne pourrez pas récupérer l’accès au compte si votre appareil est perdu ou endommagé (Buddy). Sa documentation ne décrit aucune autre procédure de récupération, preuve d’identité ni délai. L’adresse d’assistance indiquée par Buddy est support@buddy.works (Buddy). Plus d’informations dans Vous avez perdu le téléphone qui contient votre application d’authentification ?

La désactivation de la 2FA n’est pas non plus documentée.

Aide officielle de Buddy

• Security (Buddy docs)
• Single Sign-On (SSO) with SAML & OIDC Identity Providers
• Two-factor authentication (2FA) (blog de Buddy, 2018)
• Changes to Git access in Buddy-hosted repos (2FA accounts only) (blog de Buddy, 2021)