Nextcloud에서 2단계 인증(2FA)을 설정하고 적용하는 방법

Nextcloud 사용자가 로그인 페이지에 도달하여 올바른 비밀번호를 입력했지만, 서버에서 설정하지 않은 2단계 인증을 요구하여 로그인이 중단되는 경우가 있습니다. 이는 일반적으로 관리자가 2단계 인증(2FA)을 활성화하기 전에 인증 제공업체를 지정하고, 등록 절차를 테스트하고, 사용자 복구 방안을 준비하지 않은 상태에서 2단계 인증을 강제 적용했을 때 발생합니다. 더 안전한 해결 방법은 먼저 지원되는 인증 제공업체를 활성화하고 소규모 그룹을 대상으로 시범 운영한 후, 의도된 계정에만 2단계 인증을 적용하는 것입니다.

아래 단계는 2026년 10월 6일에 제공되는 Nextcloud 35 안정 버전 관리 및 사용자 설명서를 따릅니다. Nextcloud의 인터페이스와 사용 가능한 공급자 앱은 서버 릴리스 및 배포 버전에 따라 다를 수 있으므로 프로덕션 인스턴스를 변경하기 전에 설치된 버전의 설명서를 확인하십시오.

2단계 인증(2FA)을 강제하면 로그인 문제가 발생하는 이유는 무엇인가요?

Nextcloud는 2단계 인증(2FA)을 플러그인 방식으로 제공합니다. 관리자는 하나 이상의 제공업체 앱을 활성화할 수 있으며, 사용자는 관리자가 필수 인증 수단으로 지정하지 않는 한 개인 설정에서 인증 요소를 구성할 수 있습니다. 사용 가능한 제공업체가 없거나, 2단계 인증에 등록하지 않은 사용자 또는 분실된 인증 장치를 사용하는 경우 로그인이 중단될 수 있습니다. 복구 코드와 검증된 관리자 복구 경로를 통해 이러한 위험을 줄일 수 있습니다.

2단계 인증(2FA)을 적용하면 Nextcloud에 연결하는 애플리케이션에도 영향을 미칩니다. Nextcloud 35에서는 2단계 인증을 완료할 수 없는 클라이언트 애플리케이션에 기기별 앱 암호가 필요합니다. 배포 전에 데스크톱 동기화 클라이언트, 모바일 앱 및 통합 기능을 미리 계획하십시오.

1. 2단계 인증을 사용해야 하는 사람을 선택하세요

먼저 정책을 Nextcloud 그룹에 매핑하세요. 규칙이 모든 사용자, 특정 부서 또는 소수의 서비스 계정을 제외한 모든 사용자에게 적용될지 결정합니다. 관련 계정이 실제로 적용 대상 그룹에 속해 있는지 확인하세요. 광범위한 제외는 피해야 합니다. 제외된 계정은 적용된 계정과 동일한 로그인 보안을 제공받지 못합니다.

Nextcloud의 그룹 로직은 중요합니다. 적용할 그룹을 선택하지 않으면 제외 그룹의 구성원을 제외한 모든 사용자에게 규칙이 적용됩니다. 그룹을 선택하면 해당 그룹의 구성원에게 규칙이 적용되며, 제외 그룹에 속해 있더라도 선택한 그룹의 구성원 자격이 우선합니다. 예외 사항을 포함한 정책을 저장하기 전에 Nextcloud 35 2단계 인증 공식 문서를 참조하여 이러한 규칙을 확인하십시오 .

2. 최소 한 개의 공급자를 활성화하고 등록을 테스트합니다.

관리자 계정에서 앱을 열고 'Two-Factor TOTP Provider' 와 같은 제공업체 앱이 비활성화되어 있는지 확인하세요 . Nextcloud 35 설명서에 따르면 TOTP는 설치되어 있지만 기본적으로 비활성화되어 있을 수 있으며, 알림 기반 제공업체도 활성화해야 할 수 있습니다. 내장된 백업 코드 제공업체는 계정 복구에 사용할 수 있습니다. Nextcloud 앱 스토어에서 다른 제공업체 앱을 찾을 수도 있지만, 사용하기 전에 해당 앱이 설치된 서버 버전을 지원하는지 확인하세요.

소규모 파일럿 테스트를 진행하려면 TOTP를 활성화하고 테스트 사용자에게 개인 설정에서 2단계 인증을 찾아 호환되는 인증 앱으로 표시된 QR 코드를 스캔하고 등록을 확인하도록 요청하세요. 안전하게 재설정할 수 있는 계정을 사용하여 이 작업을 수행하세요. 테스트하는 동안 별도의 관리자 세션을 열어 두세요. 일반 사용자와 관리자 모두 2단계 인증을 통해 새롭게 로그인할 때까지 전체 인스턴스에 해당 규칙을 적용하지 마세요.

사용자는 개인 2단계 인증 설정에서 일회용 백업 코드를 생성하고, 이를 로그인에 사용하는 휴대폰이나 보안 키와 별도로 보관해야 합니다. Nextcloud 공식 2단계 인증 사용자 가이드에서는 TOTP 설정, 복구 코드, 로그인 메시지 및 기기별 암호에 대해 설명합니다.

3. 관리자 설정에서 요구 사항을 적용합니다.

파일럿이 로그인하여 액세스 권한을 복구할 수 있게 되면 관리 설정 > 보안 으로 이동하여 2단계 인증 섹션을 찾습니다. 2단계 인증 적용 설정을 활성화합니다. 일부 사용자만 포함하는 경우 1단계에서 선택한 그룹을 선택하고 제외 그룹 목록을 주의 깊게 확인합니다. 모든 사용자에게 2단계 인증을 요구하려면 선택 그룹 제한을 비워 두십시오. 특정 운영상의 이유가 있고 다른 보호 조치가 있는 경우에만 제외 기능을 사용하십시오.

정책 적용 시점, 구성해야 할 공급자, 백업 코드 생성 위치, 지원 요청 방법 등을 사용자에게 알려주세요. 대규모 배포 환경의 경우, 전체 서버를 한 번에 변경하는 대신 그룹별로 배포 범위를 확대하세요. 이렇게 하면 관리자가 누락된 그룹 구성원, 지원되지 않는 클라이언트, 공급자별 문제 등을 모든 사용자에게 영향을 미치기 전에 파악할 수 있습니다.

4. 서버 측 변경을 반복적으로 수행해야 할 때 occ를 사용하십시오.

관리자는 Nextcloud occ명령어를 사용하여 2단계 인증(2FA)을 적용할 수도 있습니다. Nextcloud 설치 디렉터리에서 웹 서버 계정으로 명령어를 실행하세요. 계정 이름, PHP 명령어, 설치 경로는 호스트 또는 컨테이너에 따라 다릅니다. 다음 예제에서는 www-dataNextcloud 설명서에 나와 있는 일반적인 Linux 웹 사용자를 사용합니다.

sudo -E -u www-data php occ twofactorauth:enforce --on

선택한 그룹에 대해 2단계 인증을 요구하려면(서비스 계정 그룹은 선택적으로 제외 가능) 다음을 사용하십시오.

sudo -E -u www-data php occ twofactorauth:enforce --on \
  --group=staff --group=admins --exclude=service-accounts

예시 그룹 ID와 웹 서버 계정을 사용자의 인스턴스 값으로 바꾸십시오. 이 명령은 배포를 일시 중지해야 하는 경우 적용을 해제할 수 있습니다.

sudo -E -u www-data php occ twofactorauth:enforce --off

현재 Nextcloud occ 참조 문서를 사용하여 사용 중인 릴리스의 구문을 확인하십시오. Docker 또는 기타 관리형 배포 환경의 경우, occ해당 배포 환경에 명시된 사용자 및 명령어를 사용하여 올바른 애플리케이션 환경 내에서 실행하십시오. 호스트 수준 예제를 무턱대고 실행하지 마십시오.

5. 분실된 기기와 클라이언트 앱에 대비하세요.

사용자가 인증에 사용하는 휴대폰이나 키를 분실하고 백업 코드도 잃어버리면 로그인할 수 없을 수 있습니다. 시행 전에 중요하지 않은 계정을 사용하여 복구 절차를 테스트해 보세요. Nextcloud는 제공업체별 설정 occ twofactorauth:disable및 twofactorauth:enable명령어를 지원하지만, 모든 제공업체가 사용자별 설정 변경을 지원하는 것은 아닙니다. 2단계 인증 관리자 지원 앱은 지원되는 Nextcloud 버전에서 사용할 수 있는 또 다른 복구 옵션입니다. 사용하기 전에 호환성 및 설치 상태를 확인하세요.

사용자가 이미 구성한 공급자를 전환 계획 없이 비활성화하거나 제거하지 마십시오. Nextcloud는 앱이 제거된 후에도 공급자 연결을 유지할 수 있으며, 이로 인해 인증 오류가 발생할 수 있습니다. 관리자 설명서에는 영구적으로 제거된 공급자를 정리하는 명령이 나와 있습니다. 이 정리 작업은 되돌릴 수 없으므로 해당 공급자를 다시 활성화할 계획이 없는 경우에만 사용하십시오.

대화형 2FA 프롬프트에 응답할 수 없는 데스크톱 및 모바일 클라이언트의 경우, 사용자가 Nextcloud 계정 설정에서 앱 암호를 생성하고 클라이언트 자격 증명을 업데이트하도록 하십시오. Nextcloud 35 설명서에는 2FA가 활성화된 계정의 경우 앱 암호가 필수라고 명시되어 있습니다. 브라우저 로그인 테스트만으로는 동기화 클라이언트 및 통합 기능이 제대로 작동하는지 확인할 수 없습니다.

집행이 제대로 작동하는지 확인하십시오

개인 브라우저 창에서 또는 로그아웃 후 파일럿 사용자를 대상으로 테스트하십시오. 평소 사용하는 사용자 이름과 비밀번호를 입력한 다음 Nextcloud에서 구성된 2차 인증 코드를 요청하고 유효한 코드를 수락하는지 확인하십시오. 복구 절차에서 허용하는 경우 백업 코드를 한 번 테스트하십시오. 백업 코드는 일회용이라는 점에 유의하십시오. 다음으로 조직에서 사용하는 클라이언트 앱과 통합 기능을 테스트하십시오.

특정 계정의 상태를 확인하려면 Nextcloud 디렉터리에서 status 명령을 실행하세요.

sudo -E -u www-data php occ twofactorauth:state username

해당 계정이 의도된 정책의 적용 대상인지, 그리고 선택한 공급자가 활성화되어 있는지 확인하십시오. 선택한 사용자가 2FA(이중 인증)를 사용할 필요가 없는 경우, 전역 규칙을 변경하기 전에 그룹 구성원 및 제외 항목을 검토하십시오. 설정이 완료되면 의도된 사용자가 로그인 시 인증을 거치고, 제외된 계정이 문서화된 예외 사항으로 제한되며, 복구 기능이 테스트되었고, 지원되는 클라이언트가 앱 암호를 사용하여 다시 연결할 수 있어야 합니다.

공식 참고 자료

• Nextcloud 35 관리자 매뉴얼: 2단계 인증
• Nextcloud 35 관리 설명서: 2FA OCC 명령어
• Nextcloud 35 사용자 설명서: 2단계 인증 사용하기
• Nextcloud 35 관리 설명서: 앱 암호
• Nextcloud 앱 스토어: 관리자 지원을 위한 2단계 인증