Keycloak을 사용하여 ownCloud Infinite Scale에 TOTP 2단계 인증 로그인을 추가하세요.

ownCloud Infinite Scale은 사용자 인터페이스에서 별도의 2단계 인증(2FA) 스위치를 제공하지 않습니다. 시간 기반 일회용 비밀번호(TOTP)를 사용하려면 Keycloak과 같은 OpenID Connect ID 공급자를 구성하고, 사용자가 해당 공급자에 인증자를 등록하도록 요구한 다음, 로그인 시 인증 절차를 거치도록 하십시오. Infinite Scale 자체의 다단계 인증(MFA) 설정은 보호된 경로에 대한 단계별 인증을 위한 것이며, OTP 등록 흐름을 생성하지는 않습니다.

이 가이드에서는 Keycloak을 예시 ID 공급자로 사용합니다. 정확한 메뉴 레이블은 Keycloak 릴리스에 따라 다를 수 있습니다. 아래 스크린샷은 인터페이스 예시이며, 테스트된 서버의 스크린샷이 아닙니다. ownCloud의 최신 8.2 문서에는 Infinite Scale 7.3.0에서 도입된 경로 수준 적용에 대한 내용이 나와 OCIS_MFA_ENABLED있습니다 .OCIS_MFA_AUTH_LEVEL_NAMES

적절한 집행 모델을 선택하십시오

먼저, 사용자가 매번 로그인할 때마다 2단계 인증을 요구할지, 아니면 서비스의 민감한 부분에 접근할 때만 요구할지 결정해야 합니다. Keycloak은 브라우저 인증 흐름에서 TOTP(Time To Pass)를 요구할 수 있습니다. Infinite Scale은 OIDC 인증 컨텍스트 클래스 참조(ACR) 클레임을 사용하여 특정 경로에 대해 단계별 인증을 요청할 수 있습니다. 이 두 솔루션은 서로 관련은 있지만 다른 문제를 해결합니다.

접근 ​​방식잘 맞습니다절충
로그인 시 Keycloak TOTP브라우저 로그인에 2단계 인증을 원하는 조직사용자는 인증 앱과 복구 계획이 필요합니다. 기존 세션은 만료되거나 사용자가 다시 로그인할 때까지 유효할 수 있습니다.
무한 스케일 스텝업 MFA선택된 경로 또는 데이터 작업을 보호하는 팀단계별 인증 및 ACR 클레임을 지원하는 IdP와 양측의 일치하는 구성이 필요합니다.
웹 인증 보안 키 또는 암호피싱 방지 인증을 우선시하는 팀등록, 기기 지원 및 계정 복구에는 계획이 필요합니다. 이는 TOTP와는 다른 유형의 2단계 인증 방식입니다.

TOTP를 간편하게 배포하려면 Keycloak의 브라우저 로그인 흐름부터 시작하세요. 경로별 검사가 필요한 경우 단계별 MFA는 별도의 정책으로 신중하게 구현하십시오. 서버 측 동작에 대한 자세한 내용 은 ownCloud 프록시의 ACR 및 단계별 인증 관련 문서를 참조하세요.

로그인 흐름을 변경하기 전에

  • Infinite Scale이 OIDC를 통해 Keycloak으로 로그인 리디렉션을 이미 수행하고 있는지 확인하십시오. 먼저 ID 공급자 연결을 설정하고 테스트하십시오. MFA는 손상된 SSO 통합을 복구하지 않습니다.
  • 공용 로그인 엔드포인트 모두에 HTTPS를 사용하고, Keycloak 호스트의 시계를 동기화 상태로 유지하며, 관리자가 Keycloak 콘솔에 계속 액세스할 수 있는지 확인하십시오.
  • 등록 방법을 선택하고 두 번째 인증 요소를 적용하기 전에 복구 경로를 안내하십시오. 테스트 계정과 소규모 그룹을 대상으로 시범 운영해 보십시오.

Keycloak에서 TOTP 등록을 활성화합니다.

  1. OTP 정책을 설정하세요. 해당 영역에서 인증을 열고 OTP 정책 설정을 선택합니다. 시간 기반 OTP 정책을 선택하세요. 구성된 알고리즘, 코드 길이 및 기간은 조직에서 지원하는 인증 앱과 호환되도록 유지해야 합니다. TOTP 코드는 빠르게 만료되므로 기기의 시계 오차로 인해 인증 시도가 실패할 수 있습니다.

알고리즘, 자릿수, 예측 시간 범위 및 기간 설정을 포함한 시간 기반 OTP 정책을 보여주는 Keycloak 인증 페이지의 예시입니다.

그림: Keycloak의 시간 기반 OTP 정책 설정. 사용자 등록 전에 영역의 실제 값을 확인하십시오.

  1. OTP 구성 기능을 활성화하세요. 인증 > 필수 작업 에서 OTP 구성이 활성화되어 있는지 확인하십시오 . 기본 작업으로 설정하면 새로 생성된 사용자에게 등록하라는 메시지가 표시됩니다. 하지만 기존 계정에는 자동으로 이 작업이 할당되지 않습니다.
  2. 광범위한 적용에 앞서 기존 사용자를 등록하세요. 파일럿 사용자에게 OTP 구성 필수 작업을 할당하거나 계정 콘솔을 통해 등록하도록 요청한 다음, 각 사용자가 새 로그인을 완료할 수 있는지 확인하세요. 더 넓은 범위로 배포할 때는 나머지 사용자에게 어떻게 안내할지, 그리고 기기를 분실했을 경우 지원 담당자가 어떻게 접근 권한을 복구할지 계획해야 합니다.

Keycloak에서 신규 사용자를 위한 기본 작업으로 OTP 구성이 활성화되고 선택된 경우의 필수 작업 표 예시입니다.

예시: OTP 구성은 필수 작업이자 기본 작업으로 설정되어 있으며, 기존 사용자는 여전히 등록 플랜이 필요합니다.

브라우저 흐름에서 두 번째 인증 요소를 요구합니다.

  1. Keycloak의 인증 > 흐름 영역에서 내장 브라우저 흐름을 복제 하고 복사본을 편집하세요. 복사본을 보관하면 정책을 비교하고 롤백할 때 더 안전한 방법을 사용할 수 있습니다.
  2. 파일럿 테스트에 OTP(일회용 비밀번호)를 필수로 설정하세요. 복사한 플로우에서 조건부 2FA 하위 플로우와 OTP 양식을 구성하여 사용자가 2단계 인증 없이는 비밀번호 기반 브라우저 인증을 완료할 수 없도록 합니다. Keycloak의 최신 관리 가이드에서는 조건부 플로우에서 OTP를 필수로 설정하는 방법을 설명하고 있으며, OTP 자격 증명이 없는 계정에는 OTP를 설정하라는 메시지가 표시됩니다. 파일럿 테스트가 성공한 후에만 복사한 플로우를 해당 영역의 브라우저 플로우로 바인딩하세요.
  3. 새로운 로그인 방식을 테스트합니다. 기존 SSO 쿠키로 인해 프롬프트가 가려지지 않도록 개인 정보 보호 모드 브라우저 창을 사용합니다. 테스트 계정으로 로그인한 후, 인증 앱으로 설정 QR 코드를 스캔하고 현재 코드를 입력한 다음 로그아웃하고 다시 로그인합니다. 비밀번호만으로는 브라우저 로그인이 완료되지 않는지 확인합니다.

조건부 2FA 하위 흐름 및 필수 항목으로 표시된 OTP 양식을 포함하는 Keycloak 브라우저 흐름 예시입니다.

예시: OTP 인증이 필요한 브라우저 흐름. 가입 및 복구 기능이 테스트된 후에만 배포하십시오.

Keycloak의 기본 브라우저 인증 흐름은 조건부로 작동할 수 있습니다. 두 번째 인증 요소를 등록하지 않은 사용자는 인증 흐름을 변경하지 않는 한 OTP 인증 화면이 표시되지 않을 수 있습니다. 인증 흐름 요구 사항을 변경하기 전에, 특히 ID 브로커링, 패스키, 데스크톱 클라이언트 또는 모바일 클라이언트를 사용하는 경우 Keycloak 서버 관리 가이드를 검토하십시오.

선택 사항: 선택한 경로에 대해 강화된 다단계 인증(MFA)을 인피니트 스케일에 요청할 수 있습니다.

경로 수준 검사를 위해서는 프록시와 프런트엔드를 동일한 MFA 설정으로 구성하십시오. 환경 변수를 허용하는 배포 구성에서 현재 8.2 버전의 이름은 다음과 같습니다.

OCIS_MFA_ENABLED: "true"
OCIS_MFA_AUTH_LEVEL_NAMES: "advanced"

성공적인 MFA 인증 후 ID 공급자가 액세스 토큰에 추가하는 것과 동일한 승인된 ACR 값을 사용하십시오. 프록시 및 프런트엔드 배포 설명서에 따라 보호할 경로를 구성한 다음 해당 서비스를 다시 배포하십시오. 이 설정은 기본적으로 비활성화되어 있으며, 이 설정 자체만으로는 TOTP를 활성화하거나 모든 로그인에 대해 OTP를 강제 적용하지 않습니다. 사용자가 필요한 MFA 수준 없이 보호된 경로에 도달하면 Infinite Scale은 헤더가 포함된 403 응답을 문서화합니다 . ownCloud MFA 환경 변수 참조 및 프록시 서비스 구성을X-OCIS-MFA-Required 참조하십시오 .

MFA가 활성화되고 ACR 인증 수준이 허용된 ownCloud Infinite Scale 배포 구성 예시입니다.

예시: 현재 허용되는 MFA 인증 수준에 대한 복수형 환경 변수 이름입니다. 해당 값은 IdP의 ACR 클레임과 일치해야 합니다.

배포를 확인하고 복구 액세스를 유지하세요.

일반 사용자, 등록하지 않은 사용자, 관리자, 그리고 조직에서 사용하는 모든 데스크톱 또는 모바일 클라이언트를 사용하여 정책을 테스트하십시오. 새 브라우저 로그인 시 TOTP(Time to Pass Per Type) 인증이 요청되고 유효한 코드를 입력하면 인증이 완료되는지 확인하십시오. 추가 테스트의 경우, MFA(다단계 인증)를 완료하지 않은 세션으로 보호된 경로를 요청한 다음, IdP(ID 공급자) 인증 요청이 발생하고 필요한 ACR(접근 승인 요청) 레벨이 발급된 후 경로가 정상적으로 작동하는지 확인하십시오.

전체 영역에 걸쳐 OTP를 요구하기 전에 관리자 복구 절차를 준비해 두십시오. 분실한 인증 장치를 재설정하는 방법, ID 공급자 콘솔에 대한 액세스를 유지하는 방법, 그리고 특정 사용자의 휴대폰에만 서비스로 복귀하는 것을 방지하는 방법을 문서화하십시오. TOTP는 널리 지원되고 배포가 간편하며, WebAuthn은 더 강력한 피싱 방지 기능을 제공할 수 있습니다. 사용자가 실제로 보유한 장치, 지원 용량 및 복구 제어 기능을 고려하여 선택하십시오. ownCloud 기술 자료에서는 Keycloak을 무한 확장형 2FA 옵션으로 제시하고 있습니다.

댓글 남기기

ownCloud 10 MySQL 연결 실패 문제 해결

MySQL, PHP, 소켓 설정 또는 데이터베이스 권한이 ownCloud 10을 차단하는지 확인한 다음 안전한 해결 방법을 검증하세요.

ownCloud 공개 링크에 대한 확실한 만료 기한을 설정하세요

ownCloud 공개 링크에 대한 확실한 만료 기한을 설정하세요

ownCloud Classic에서 공개 링크 만료를 필수로 설정하고, 최대 유효 기간을 지정하고, 별도의 정리가 필요한 기존 공유를 확인합니다.

Keycloak을 사용하여 ownCloud Infinite Scale에 TOTP 2단계 인증 로그인을 추가하세요.

Keycloak을 사용하여 ownCloud Infinite Scale에 TOTP 2단계 인증 로그인을 추가하세요.

Keycloak을 통해 TOTP를 활성화하고, 사용자를 안전하게 등록하고, Infinite Scale의 경로 수준 MFA 설정이 적용되는 시점을 파악하세요.

클라이언트와 서버를 일치시켜 ownCloud 동기화를 복원하세요.

문제가 OC10과 7.x 버전 간의 호환성 문제인지, 아니면 CSync 저널 손상 때문인지 확인한 후, 동기화된 파일을 삭제하지 않고 적절한 해결 방법을 적용하십시오.

Let's Encrypt와 Nginx를 사용하여 ownCloud를 HTTPS에 연결하세요.

Let's Encrypt와 Nginx를 사용하여 ownCloud를 HTTPS에 연결하세요.

HTTP-01 또는 DNS-01을 선택하고 ownCloud 역방향 프록시를 구성한 다음 Certbot이 HTTPS 인증서를 자동으로 갱신하는지 확인하십시오.

사용자 로그인을 위해 ownCloud Infinite Scale을 LDAP에 연결합니다.

배포 전에 oCIS LDAP 로그인을 구성하고, 사용자 및 그룹 조회를 일치시키고, TLS 및 스키마 설정을 확인하십시오.

S3 버킷을 ownCloud 10에 외부 스토리지로 연결하기

S3 버킷을 ownCloud 10에 외부 스토리지로 연결하기

ownCloud 10에 Amazon S3 버킷을 추가하고, 호환되는 자격 증명 및 엔드포인트를 준비하고, 마운트와 기본 스토리지를 혼동하지 않고 액세스를 확인하세요.

안전한 야간 크론 작업을 사용하여 ownCloud 데이터베이스 덤프를 자동화하세요.

안전한 야간 크론 작업을 사용하여 ownCloud 데이터베이스 덤프를 자동화하세요.

ownCloud 서버에 대한 보호된 MariaDB 덤프를 예약하고, 유지 관리 모드를 안전하게 처리하며, 사용하기 전에 각 백업을 검증합니다.

지원되는 마이그레이션을 사용하여 ownCloud Classic을 oCIS로 이전하세요.

지원되는 앱, 순서대로 실행되는 명령, 신원 확인 절차, 그리고 별도로 처리해야 할 데이터 목록을 명확하게 작성하여 ownCloud 10에서 oCIS로의 마이그레이션을 계획하십시오.

브랜드 ownCloud Classic 10에 테마 앱과 CSS를 적용했습니다.

업그레이드 및 무결성 검사 관련 문제를 피하면서 테마 앱을 사용하여 ownCloud Classic 10 로고를 교체하고 웹 UI 색상을 조정하세요.