2FA Buildkite : comment configurer une application d’authentification

Une connexion Buildkite donne accès à vos pipelines CI/CD, à vos builds et à vos agents. L’authentification à deux facteurs (2FA) ajoute un code d’une application d’authentification à votre mot de passe. Ce qu’il faut savoir avant de commencer : Buildkite vous donne des codes de récupération, et si vous perdez à la fois votre application d’authentification et ces codes, la seule solution documentée pour revenir est de faire supprimer votre compte et d’en créer un nouveau (Buildkite).

La documentation de Buildkite décrit une seule méthode 2FA : une application d’authentification tierce. La 2FA est facultative pour votre compte personnel, mais un administrateur d’organisation peut la rendre obligatoire pour tous les membres de l’organisation (voir ci-dessous). 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 Buildkite proviennent de la documentation de Buildkite, indiquée ci-dessous, que nous avons consultée le 21 octobre 2026. Nous ne les avons pas testées sur un compte Buildkite : 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 tutoriel 2FA de Buildkite décrit ces étapes dans le tableau de bord (Buildkite) :

1. Ouvrez le menu déroulant sous votre photo de profil et choisissez Personal Settings (paramètres personnels).
2. Cliquez sur Two-Factor Authentication (authentification à deux facteurs). Si un champ Confirm Password (confirmer le mot de passe) apparaît, saisissez votre mot de passe Buildkite et continuez.
3. Cliquez sur Setup Two-Factor Authentication (configurer l’authentification à deux facteurs).
4. Buildkite affiche d’abord vos codes de récupération. Copiez-les ou téléchargez-les sous forme de fichier texte, et rangez-les ailleurs que sur votre téléphone. Continuez ensuite.
5. Buildkite affiche un code-barres (un code QR). Dans Novaz, touchez +, puis Scanner un QR code, et pointez l’appareil photo vers le code. Si le tableau de bord est ouvert 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 le scanner, utilisez la clé secrète que Buildkite affiche sous le code-barres. Dans Novaz, touchez +, puis Saisir la clé manuellement. Saisissez « Buildkite » comme Service, votre adresse e-mail comme Compte si vous le souhaitez, et la clé secrète comme Clé de configuration. Consultez Qu’est-ce qu’une clé de configuration 2FA ?
7. Saisissez le code à six chiffres de Novaz dans le champ de Buildkite et cliquez sur Activate (activer).

Si cela a fonctionné, Personal Settings affiche un badge Enabled (activé) à côté de Two-Factor Authentication.

Buildkite indique que ses codes comptent six chiffres et changent environ toutes les 30 secondes, ce qui correspond à ce que Novaz produit à partir d’une clé saisie. Si Novaz n’accepte pas la clé que vous avez saisie, scannez plutôt le code QR.

Vos codes de récupération sont la sauvegarde

Buildkite vous remet les codes de récupération avant même d’afficher le code QR, et son tutoriel indique de les conserver dans un endroit numérique sûr ou sur papier, et de ne jamais les partager (Buildkite). Prenez cette étape au sérieux. Si ce téléphone disparaît et que Novaz n’est pas sauvegardé avec la sauvegarde iCloud ou un fichier de sauvegarde, les codes de récupération sont votre moyen de revenir dans votre compte. La documentation ne précise pas combien de codes vous obtenez, si chacun ne fonctionne qu’une fois, ni comment en créer une nouvelle série. Plus d’informations dans Codes de secours 2FA.

Quand Buildkite demande un code

Buildkite demande le code actuel lorsque vous vous connectez depuis un nouveau navigateur, un nouvel appareil ou un nouvel emplacement (Buildkite).

Quand votre organisation impose la 2FA

Un administrateur d’organisation peut exiger la 2FA pour tous les membres dans Settings › Security (paramètres › sécurité), en choisissant Enforce Two-factor authentication (imposer l’authentification à deux facteurs), puis Update Access Control (mettre à jour le contrôle d’accès) (Buildkite). Cela a plusieurs conséquences :

• Les membres qui n’ont pas configuré la 2FA perdent immédiatement l’accès à l’organisation et à ses pipelines. Configurez-la avant que l’option soit activée.
• Les jetons d’accès API existants continuent de fonctionner, mais vous ne pouvez ni créer de nouveaux jetons ni modifier les jetons existants tant que vous n’avez pas activé la 2FA (Buildkite).
• Les organisations qui imposent plutôt l’authentification unique (SSO) doivent désactiver l’obligation de 2FA, pour que les deux ne s’appliquent pas en même temps (Buildkite).

Si Buildkite refuse votre code

La documentation de Buildkite ne donne aucun conseil de dépannage pour les codes erronés. La cause la plus fréquente est une horloge de téléphone qui a dérivé. Sur votre 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. Les autres causes sont décrites dans Le code d’authentification ne fonctionne pas ?

Changer de téléphone

Buildkite indique que vous pouvez reconfigurer ou désactiver la 2FA depuis la zone Two-Factor Authentication de Personal Settings (Buildkite). La documentation ne décrit pas de changement de téléphone, mais l’ordre le plus sûr consiste à y reconfigurer la 2FA tant que l’ancien téléphone vous donne encore des codes, puis à scanner le nouveau code QR avec Novaz sur le nouvel iPhone. Ou, si vous utilisez la sauvegarde iCloud de Novaz ou un fichier de sauvegarde, restaurez-la sur le nouvel iPhone et passez la reconfiguration. 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 la 2FA sur votre nouveau téléphone.

Sans les codes de récupération, le tutoriel de Buildkite ne propose aucun moyen de réinitialiser la 2FA sur votre compte actuel. Sa procédure est la suivante (Buildkite) :

1. Demandez à l’administrateur de votre organisation Buildkite de retirer votre compte de l’organisation.
2. Écrivez à support@buildkite.com pour demander la suppression de votre compte.
3. Une fois le compte supprimé, créez-en un nouveau. Le tutoriel ne traite pas du retour dans l’organisation : demandez à votre administrateur.

La documentation ne précise pas quelle preuve l’assistance demande ni combien de temps prend la suppression. Pour les équipes, le guide de réponse aux incidents de Buildkite suggère de conserver le secret 2FA et les codes de récupération d’un administrateur dans un coffre à accès restreint (Buildkite). Consultez Vous avez perdu le téléphone qui contient votre application d’authentification ?

Désactiver la 2FA

Allez dans Personal Settings › Two-Factor Authentication pour la désactiver (Buildkite). Le tutoriel ne donne pas les boutons exacts. Si votre organisation impose la 2FA, la désactiver vous coupera l’accès à cette organisation. Après l’avoir désactivée, supprimez le compte de Novaz : ouvrez-le et touchez Supprimer le compte.

Aide officielle de Buildkite

• Two-factor authentication
• Enforce two-factor authentication (2FA)
• Single sign-on support
• Incident response