Assembla 2FA: 인증 앱 설정 방법

Assembla는 프로젝트 관리 도구와 함께 Perforce, Subversion, Git 저장소를 호스팅하므로(Assembla), Assembla 로그인이 소스 코드를 지키는 경우가 많습니다. 인증 앱을 사용한 2단계 인증(2FA)을 지원하며, 포트폴리오 소유자는 포트폴리오의 모든 사람에게 필수로 정할 수 있습니다. 다른 서비스와 다른 점이 두 가지 있습니다. 설정 화면에는 입력할 키 없이 QR 코드만 표시됩니다. 그리고 2FA를 켜면 저장소 클라이언트에서 비밀번호가 더 이상 작동하지 않습니다(Assembla).

이 가이드는 iPhone의 Authenticator App - Novaz를 사용합니다. 시간 기반 코드를 만드는 인증 앱이라면 어떤 앱이든 같은 방식으로 작동합니다.

이 가이드를 확인한 방법: Assembla 관련 단계는 아래에 링크한 Assembla 고객센터 문서와 2FA 문서의 스크린샷을 바탕으로 했으며, 2026년 10월 21일에 읽었습니다. Assembla 계정으로 테스트하지는 않았으므로 레이블이 조금 다를 수 있습니다. Novaz 관련 단계는 앱 버전 1.0.5에서 확인했습니다.

시작하기 전에

• SSO로 로그인하나요? Assembla에 따르면 Single Sign-On을 사용하는 계정에는 비밀번호가 없으며, 비밀번호가 없으면 Assembla 자체 2FA를 켤 수 없습니다(Assembla).
• 포트폴리오의 Google 2FA: 같은 문서에 따르면 포트폴리오가 Google 2FA를 요구하면 그 방식이 우선합니다. 그 이상은 설명하지 않습니다.
• 앱 목록이 오래되었습니다. Assembla의 목록에는 아직 Windows Phone이 있지만, 코드는 표준 시간 기반 코드이므로 Novaz도 같은 QR 코드를 스캔할 수 있습니다.

인증 앱으로 2FA 켜기

Assembla 도움말에 나와 있는 단계는 다음과 같습니다(Assembla).

1. 페이지 위쪽의 아바타를 클릭하세요.
2. My Profile(내 프로필) › Two-factor authentication(2단계 인증)을 선택하세요. 페이지에 2단계 인증이 현재 비활성화되어 있다는 문구와 QR 코드가 표시됩니다.
3. Novaz에서 **+**를 탭하고 QR 코드 스캔을 탭한 다음 카메라를 컴퓨터 화면의 코드에 맞추세요. Assembla가 같은 iPhone에 열려 있다면 스크린샷을 찍고 +, 사진 선택을 탭하세요. 같은 iPhone에서 QR 코드 스캔하기를 참고하세요.
4. Confirm current password(현재 비밀번호 확인) 아래에 Assembla 비밀번호를 입력하세요.
5. Enter the six-digit code from the application(앱의 6자리 코드 입력) 아래에 Novaz의 현재 코드를 입력하세요.
6. Enable(활성화)을 클릭하세요.
7. Assembla가 제공하는 복구 코드 파일을 저장하세요. 휴대폰을 잃어버렸을 때 이 파일로 다시 로그인합니다.

페이지에 설정 키가 없습니다

Assembla 화면에는 텍스트 키가 표시되지 않습니다. 휴대폰으로 스캔할 수 없을 때를 위해 도움말은 우회 방법을 제안합니다. 데스크톱 QR 리더 같은 별도의 리더 앱으로 QR 코드를 해독해 otpauth:// 링크를 얻는 것입니다. 이 링크의 secret= 부분이 키입니다. Novaz에서는 + › 키를 직접 입력에서 설정 키에 입력합니다. 2FA 설정 키란 무엇인가요?를 참고하세요.

Novaz에서는 스캔하는 편이 더 간단합니다. 키를 직접 입력하려면 16자 이상이어야 하는데, Assembla는 키의 길이를 밝히지 않습니다.

복구 코드 파일

2FA를 켜면 Assembla가 복구 코드 파일을 줍니다. 휴대폰이 없어졌는데 Novaz 백업이 없거나 마지막 백업 파일 이후에 Assembla를 추가했다면 이 파일로 다시 로그인해야 합니다. 그 휴대폰 없이도 접근할 수 있는 곳에 보관하세요. Assembla 도움말에는 파일에 코드가 몇 개 들어 있는지, 새 코드 세트를 받는 방법은 무엇인지 나와 있지 않습니다. 자세한 내용은 2FA 백업 코드를 참고하세요.

Git, SVN, Perforce 클라이언트

2FA를 켜면 외부 클라이언트는 사용자 이름과 비밀번호로 코드를 체크아웃하거나 커밋할 수 없습니다. 대신 API 키를 만드세요(Assembla, Assembla).

1. 아바타를 클릭한 다음 My Profile › API Applications & Sessions(API 애플리케이션 및 세션)를 선택하세요.
2. Repository access(저장소 접근)를 선택하고 Create(생성)를 클릭하세요.
3. 클라이언트에서 Assembla 사용자 이름과, 비밀번호 대신 API 시크릿으로 로그인하세요.

필수일 때

포트폴리오 관리자가 요구 사항을 켜면(More(더 보기) › Portfolio Admin(포트폴리오 관리), 그다음 Two-factor Authentication 섹션에서 Enabled(활성화됨)와 Update 2FA Settings(2FA 설정 업데이트)) 2FA가 없는 구성원은 다음 로그인 때 설정해야 합니다. 설정하기 전까지는 Assembla에 전혀 들어갈 수 없습니다(Assembla).

Assembla가 코드를 거부할 때

Assembla 도움말에는 거부된 코드에 관한 안내가 없습니다. 가장 흔한 원인은 어긋난 휴대폰 시계입니다. iPhone에서 설정 › 일반 › 날짜 및 시간을 열고 자동으로 설정을 켜세요. Novaz는 시계가 15초 이상 어긋나면 경고를 표시합니다. 다른 원인은 인증 앱 코드가 작동하지 않나요?를 참고하세요.

휴대폰을 바꾸거나 잃어버렸을 때, 또는 끌 때

Assembla는 세 경우를 모두 같은 방식으로 처리합니다. 2FA를 끈 다음 새 기기로 다시 켭니다(Assembla).

1. 아바타를 클릭한 다음 My Profile › Two-factor Authentication을 선택하세요.
2. Confirm current password에 비밀번호를 입력하세요.
3. Enter the six-digit code from the application에 코드를 입력하세요. Assembla에 따르면 휴대폰을 잃어버렸다면 사용하지 않은 복구 코드를 이 필드에 입력합니다.
4. Disable(비활성화)을 클릭하세요. 그런 다음 2FA를 다시 설정할 수 있습니다.

Novaz 백업 없이 휴대폰을 바꾼다면 이전 iPhone이 아직 작동할 때 하세요. iCloud 백업이나 백업 파일이 있다면 대신 새 iPhone에서 계정을 복원할 수 있습니다. 인증 앱을 새 iPhone으로 옮기는 방법을 참고하세요.

휴대폰과 복구 파일을 모두 잃어버렸다면, Assembla는 support@assembla.com으로 이메일을 보내 계정 재설정을 요청하라고 합니다. 도움말에는 지원팀이 어떤 증빙을 요구하는지, 얼마나 걸리는지 나와 있지 않습니다. 인증 앱이 있는 휴대폰을 잃어버리셨나요?도 참고하세요.

Assembla 공식 도움말

• Using Two-Factor Authentication with your Assembla Account
• Working on my Repos with Third Party Authentication
• Assembla: Managed Cloud Hosting For Perforce, SVN & Git