관리자 2단계 인증 설정하기

2단계 인증을 켜면 관리자 계정은 비밀번호 외에 인증 앱의 6자리 코드를 입력해야 로그인할 수 있습니다. 비밀번호가 유출되어도 인증 앱이 있는 기기가 없으면 로그인할 수 없습니다. 이 문서에서는 관리자가 자기 계정에 2단계 인증을 등록하는 방법, 복구 코드를 다루는 방법, 모든 관리자에게 2단계 인증을 필수로 적용하는 방법을 안내합니다.

시작하기 전에

• 2단계 인증은 관리자 계정에서만 쓸 수 있습니다. 일반 사용자 계정에는 표시되지 않습니다.
• Google Authenticator, Microsoft Authenticator 같은 TOTP 방식 인증 앱이 설치된 휴대폰이 필요합니다.
• 등록 중에 현재 비밀번호를 다시 입력합니다.
• 관리자 2단계 인증 필수 정책을 켜려면 보안 설정 권한이 있는 관리자가 먼저 자기 계정에 2단계 인증을 등록해야 합니다.

2단계 인증 화면 열기

관리자 페이지의 /manages/account/mfa가 2단계 인증 화면입니다. 다음 어느 곳에서든 열 수 있습니다.

• 관리자 페이지 오른쪽 위 사용자 메뉴의 2단계 인증
• 보안 관리 > 보안 설정의 관리자 2단계 인증 카드에서 설정 화면 열기
• 사용자 관리 > 사용자 목록에서 자기 계정을 열고 내 2단계 인증 설정
• 워크스페이스의 계정 설정에서 2단계 인증 항목의 설정 또는 관리

화면의 인증 앱 2단계 인증 패널에 현재 상태가 켜짐 또는 꺼짐으로 표시됩니다.

2단계 인증 등록하기

1. 인증 앱 2단계 인증 패널에서 설정을 선택합니다.
2. 본인 확인에서 현재 비밀번호를 입력하고 다음을 선택합니다.
3. 인증 앱 등록에 표시된 QR 코드를 인증 앱으로 찍습니다. QR 코드를 찍을 수 없으면 키 복사로 키를 복사해 인증 앱에 직접 입력합니다.
4. 인증 앱에 보이는 6자리 코드를 입력하고 확인을 선택합니다. 화면에 표시된 시간 안에 확인해야 하며, 시간이 지나면 처음부터 다시 시작합니다.
5. 복구 코드 10개가 표시됩니다. 복사 또는 파일로 저장으로 안전한 곳에 보관합니다.
6. 복구 코드를 안전한 곳에 저장했습니다에 체크하고 완료를 선택합니다.

패널의 상태가 켜짐으로 바뀌고 켠 날짜가 표시됩니다. 다음 로그인부터 비밀번호 뒤에 인증 코드를 묻습니다.

2단계 인증으로 로그인하기

1. 로그인 화면에서 아이디와 비밀번호를 입력합니다.
2. 2단계 인증 화면에서 인증 앱에 보이는 6자리 인증 코드를 입력하고 확인을 선택합니다.
3. 인증 앱을 쓸 수 없으면 복구 코드 사용을 선택하고 저장해 둔 복구 코드 하나를 입력합니다. 한 번 쓴 복구 코드는 다시 쓸 수 없습니다.

틀린 코드는 비밀번호를 틀린 것과 같이 로그인 실패로 집계됩니다. 여러 번 틀리면 보안 설정의 로그인 보호 기준에 따라 로그인이 잠시 막힙니다. 인증 화면에서 오래 머물면 인증 시간이 지나 처음부터 다시 로그인해야 합니다.

복구 코드가 얼마 남지 않으면 2단계 인증 화면에 안내가 표시됩니다. 복구 코드 새로 발급하기를 참고합니다.

복구 코드 새로 발급하기

1. 2단계 인증 화면의 복구 코드에서 새로 발급을 선택합니다.
2. 인증 앱의 6자리 코드를 입력하고 새로 발급을 선택합니다. 이때는 복구 코드를 쓸 수 없습니다.
3. 새 복구 코드 10개를 저장하고 완료를 선택합니다.

새로 발급하면 이전 복구 코드는 모두 쓸 수 없습니다. 보관해 둔 이전 코드는 새 코드로 바꿉니다.

2단계 인증 끄기

1. 인증 앱 2단계 인증 패널에서 끄기를 선택합니다.
2. 현재 비밀번호와 인증 앱의 6자리 코드 또는 복구 코드 하나를 입력하고 끄기를 선택합니다.

끄면 비밀번호만으로 로그인할 수 있고, 저장해 둔 복구 코드도 모두 무효가 됩니다. 관리자 2단계 인증 필수 정책이 켜져 있으면 끈 뒤 바로 다시 등록해야 다른 기능을 쓸 수 있습니다.

모든 관리자에게 2단계 인증 필수로 적용하기

1. 먼저 자기 계정에 2단계 인증을 등록합니다. 등록하지 않은 상태에서는 정책을 켤 수 없습니다.
2. 보안 관리 > 보안 설정에서 관리자 2단계 인증 카드를 펼칩니다.
3. 관리자 2단계 인증 필수를 켭니다.
4. 상단 오른쪽의 저장을 선택하고 확인합니다.

정책을 켜면 다음과 같이 동작합니다.

기본값은 꺼짐입니다. 정책을 켠 뒤에는 관리자에게 등록 방법을 미리 안내합니다.

다른 관리자의 2단계 인증 초기화하기

관리자가 인증 앱과 복구 코드를 모두 잃었다면 최고관리자가 그 계정의 2단계 인증을 초기화할 수 있습니다.

1. 사용자 관리 > 사용자 목록에서 해당 관리자를 선택합니다.
2. 2단계 인증 항목에서 2단계 인증 초기화를 선택합니다.
3. 확인 창의 내용을 확인하고 초기화를 선택합니다.

초기화하면 그 계정의 인증 앱 등록과 복구 코드가 지워지고 로그인 중이던 세션도 모두 끝납니다. 다음 로그인은 비밀번호만으로 하며, 필수 정책이 켜져 있으면 로그인 뒤 다시 등록해야 합니다. 자기 계정은 이 방법으로 초기화할 수 없고 2단계 인증 끄기로 끕니다.

모든 관리자가 잠겼을 때 복구하기

2단계 인증을 통과할 수 있는 관리자가 한 명도 없다면 서버에 접근할 수 있는 운영자가 터미널에서 초기화합니다. 다른 사용자 관리 명령과 같이 서버를 멈춘 상태에서 실행하고, 콘솔 접근 비밀번호를 묻습니다.

~/setfn-spacebuilder user mfa reset <사용자 계정>

실행 조건과 서버를 멈추는 방법은 명령어로 서버 관리하기를 참고합니다.

알아두기

• 2단계 인증 등록·해제, 복구 코드 재발급, 다른 관리자의 초기화는 모두 감사 로그의 인증 영역에 기록됩니다. 감사 로그 확인하기를 참고합니다.
• 2단계 인증을 등록하거나 끄면 그 계정의 다른 로그인 세션은 모두 끝나고, 비밀번호를 바꾸면 진행 중이던 2단계 인증 로그인 단계도 무효가 됩니다.
• 2단계 인증을 등록·해제하거나 복구 코드를 새로 발급하면 로그인과 동의 화면을 거쳐 연결한 AI 도구(MCP OAuth 연결)도 끊기므로, AI 도구에서 다시 연결합니다.
• 2단계 인증 정보를 보호하는 암호화 키는 서버 설정 폴더의 secrets/admin-mfa/에 저장됩니다. 서버를 백업할 때 이 폴더를 함께 백업합니다. 복원한 서버에 이 키가 없으면 모든 관리자의 2단계 인증 확인이 실패하므로, 명령어로 각 관리자의 2단계 인증을 초기화한 뒤 다시 등록합니다.
• 서버를 다시 시작하면 진행 중이던 로그인의 2단계 인증 단계가 사라지므로 처음부터 다시 로그인합니다.

관련 문서

• 보안 설정
• 감사 로그 확인하기
• 계정·보안 정책 설정하기
• 명령어로 서버 관리하기