2FA Assembla : comment configurer une application d’authentification

Assembla héberge des dépôts Perforce, Subversion et Git ainsi que des outils de gestion de projet (Assembla) : votre identifiant Assembla protège donc souvent du code source. Assembla prend en charge l’authentification à deux facteurs (2FA) avec une application d’authentification, et un propriétaire de portfolio peut la rendre obligatoire pour toutes les personnes du portfolio. Deux points la distinguent. L’écran de configuration vous donne un code QR et rien d’autre, sans clé à saisir. Et une fois la 2FA activée, votre mot de passe ne fonctionne plus dans les clients de dépôt (Assembla).

Ce guide utilise Authenticator App - Novaz sur iPhone. Toute application d’authentification qui produit des codes basés sur le temps fonctionne de la même façon.

Comment nous avons vérifié ce guide : les étapes Assembla proviennent du centre d’aide d’Assembla, y compris de la capture d’écran de son article sur la 2FA, cité ci-dessous, que nous avons consulté le 21 octobre 2026. Nous ne les avons pas testées sur un compte Assembla : un libellé peut donc légèrement différer. Les étapes Novaz ont été vérifiées dans l’app, version 1.0.5.

Avant de commencer

• Vous vous connectez par SSO ? Assembla indique qu’un compte qui utilise l’authentification unique n’a pas de mot de passe, et que sans mot de passe vous ne pouvez pas activer la 2FA propre à Assembla (Assembla).
• Google 2FA dans votre portfolio : le même article précise que si un portfolio exige Google 2FA, cette méthode est prioritaire. Il n’en dit pas plus.
• La liste des apps est ancienne. La liste d’Assembla inclut encore Windows Phone, mais ses codes sont des codes standard basés sur le temps : Novaz peut donc scanner le même code QR.

Activer la 2FA avec une application d’authentification

L’aide d’Assembla décrit ces étapes (Assembla) :

1. Cliquez sur votre avatar en haut de la page.
2. Choisissez My Profile (mon profil) › Two-factor authentication (authentification à deux facteurs). La page indique que l’authentification à deux facteurs est actuellement désactivée et affiche un code QR.
3. Dans Novaz, touchez +, puis Scanner un QR code, et pointez l’appareil photo vers le code affiché sur l’écran de votre ordinateur. Si Assembla est ouvert sur le même iPhone, faites une capture d’écran, touchez +, puis Choisir une photo. Consultez scanner un code QR sur le même iPhone.
4. Sous Confirm current password (confirmer le mot de passe actuel), saisissez votre mot de passe Assembla.
5. Sous Enter the six-digit code from the application (saisissez le code à six chiffres de l’application), saisissez le code actuel de Novaz.
6. Cliquez sur Enable (activer).
7. Enregistrez le fichier de codes de récupération fourni par Assembla. C’est votre moyen de récupérer l’accès si le téléphone est perdu.

Pas de clé de configuration sur la page

L’écran d’Assembla n’affiche pas de clé sous forme de texte. Son aide suggère une solution de contournement si votre téléphone ne peut pas scanner : décoder le code QR avec une app de lecture distincte, par exemple un lecteur de codes QR sur ordinateur, pour obtenir un lien otpauth://. La partie secret= de ce lien est la clé. Dans Novaz, vous la saisiriez sous + › Saisir la clé manuellement, dans Clé de configuration. Consultez Qu’est-ce qu’une clé de configuration 2FA ?

Avec Novaz, scanner est plus simple. Une clé saisie à la main doit compter au moins 16 caractères, et Assembla ne précise pas la longueur de sa clé.

Votre fichier de codes de récupération

Assembla vous remet un fichier de codes de récupération quand vous activez la 2FA. Si le téléphone disparaît et que vous n’avez pas de sauvegarde Novaz, ou si vous avez ajouté Assembla après votre dernier fichier de sauvegarde, c’est ce fichier qui vous permet de récupérer l’accès. Conservez-le à un endroit accessible sans ce téléphone. L’aide d’Assembla ne dit ni combien de codes contient le fichier, ni comment en obtenir une nouvelle série. Plus d’informations dans Codes de secours 2FA.

Clients Git, SVN et Perforce

Avec la 2FA activée, les clients externes ne peuvent plus extraire de code ni faire de commit avec votre nom d’utilisateur et votre mot de passe. Créez plutôt une clé d’API (Assembla, Assembla) :

1. Cliquez sur votre avatar, puis sur My Profile › API Applications & Sessions (applications et sessions d’API).
2. Cochez Repository access (accès aux dépôts) et cliquez sur Create (créer).
3. Dans votre client, connectez-vous avec votre nom d’utilisateur Assembla et le secret d’API à la place du mot de passe.

Quand elle est obligatoire

Si un administrateur de portfolio active l’exigence (More (plus) › Portfolio Admin (administration du portfolio), puis Enabled (activé) dans la section Two-factor Authentication et Update 2FA Settings (mettre à jour les paramètres 2FA)), les membres sans 2FA doivent la configurer à leur prochaine connexion. Tant qu’ils ne l’ont pas fait, ils ne peuvent pas du tout accéder à Assembla (Assembla).

Si Assembla refuse votre code

L’aide d’Assembla ne donne aucun conseil sur les codes refusés. La cause la plus fréquente est une horloge de téléphone qui s’est décalée. Sur l’iPhone, ouvrez 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. D’autres causes sont décrites dans Le code d’authentification ne fonctionne pas ?

Nouveau téléphone, téléphone perdu ou désactivation

Assembla traite ces trois cas de la même façon : désactivez la 2FA, puis réactivez-la avec le nouvel appareil (Assembla).

1. Cliquez sur votre avatar, puis sur My Profile › Two-factor Authentication.
2. Saisissez votre mot de passe dans Confirm current password.
3. Dans Enter the six-digit code from the application, saisissez un code. Si vous avez perdu le téléphone, Assembla indique qu’un code de récupération inutilisé se saisit dans ce champ.
4. Cliquez sur Disable (désactiver). Vous pouvez ensuite configurer de nouveau la 2FA.

Si vous changez de téléphone sans sauvegarde Novaz, faites-le tant que l’ancien iPhone fonctionne encore. Avec la sauvegarde iCloud ou un fichier de sauvegarde, vous pouvez plutôt restaurer vos comptes sur le nouvel iPhone. Consultez Comment transférer votre application d’authentification sur un nouvel iPhone.

Si vous avez perdu à la fois le téléphone et le fichier de récupération, Assembla vous demande d’écrire à support@assembla.com pour réinitialiser votre compte. Son aide ne dit ni quels justificatifs l’assistance demande, ni combien de temps cela prend. Consultez aussi Vous avez perdu le téléphone qui contient votre application d’authentification ?

Aide officielle d’Assembla

• Using Two-Factor Authentication with your Assembla Account (utiliser l’authentification à deux facteurs avec votre compte Assembla)
• Working on my Repos with Third Party Authentication (travailler sur mes dépôts avec une authentification tierce)
• Assembla: Managed Cloud Hosting For Perforce, SVN & Git (Assembla : hébergement cloud géré pour Perforce, SVN et Git)