2FA 강제 적용

팁

이 페이지에서는 2FA 강제 적용에 대해 자세히 설명합니다. 비밀번호 정책 및 API 핵심 제어 기능을 포함한 조직의 모든 보안 기능 개요는 다음을 참조하세요. 조직 보안.

2FA(2단계 인증) 강제 적용을 사용하면 조직 관리자가 모든 구성원이 조직 리소스에 접근하기 전에 계정에 2FA를 활성화하도록 설정할 수 있습니다. 이를 통해 앱과 데이터의 보안 수준을 한층 더 높일 수 있습니다.

개요

조직에 2FA 강제 적용이 활성화되면 다음과 같이 동작합니다:

• 모든 구성원은 Capgo 계정에서 2FA를 활성화해야 합니다.
• 2FA를 설정하지 않은 구성원은 조직의 앱에 접근할 수 없습니다.
• 웹 대시보드와 CLI 모두 이 요구 사항을 강제 적용합니다.
• 새 멤버는 조직 리소스에 접근하기 전 반드시 2FA를 활성화해야 합니다

팁

2FA 강제 적용이 특히 중요한 경우:

• 엄격한 보안 정책을 가진 엔터프라이즈 조직
• 민감한 사용자 데이터를 다루는 팀
• 규제 산업군(의료, 금융 등)에 속한 조직
• SOC 2 또는 ISO 27001 준수가 필요한 기업

작동 원리

웹 대시보드

2FA가 필수인 조직에 접근하려 할 때, 2FA가 활성화되어 있지 않으면:

1. 접근 거부 메시지가 표시됩니다.
2. 계정 설정에서 2FA를 활성화하도록 안내됩니다.
3. 2FA를 활성화하면 조직에 정상적으로 접근할 수 있습니다.

CLI 액세스

2FA가 필수인 조직의 앱과 Capgo CLI를 사용하여 상호작용할 때:

🔐 Access Denied: Two-Factor Authentication Required
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

This organization requires all members to have 2FA enabled.

To regain access:
  1. Go to https://web.capgo.app/settings/account
  2. Enable Two-Factor Authentication on your account
  3. Try your command again

2FA 강제 적용 활성화

주의

2FA 강제 적용 전 주의사항:

• 본인 계정에 2FA가 활성화되어 있는지 확인하세요
• 모든 조직 구성원에게 2FA 활성화를 안내하세요
• 2FA를 설정하지 않은 구성원은 즉시 액세스 권한을 잃게 됩니다

Web Dashboard를 통한 설정

1. 조직 설정(organization settings)으로 이동합니다
2. 다음으로 이동하세요: 보안 섹션을 찾으세요
3. 토글 스위치 모든 구성원에게 2FA 요구
4. 작업 확인

CLI를 통해

Capgo CLI를 사용하여 2FA 강제를 활성화할 수 있습니다:

# Enable 2FA enforcement for an organization
npx @capgo/cli organization set YOUR_ORG_ID --enforce-2fa

# Disable 2FA enforcement
npx @capgo/cli organization set YOUR_ORG_ID --no-enforce-2fa

CLI를 통해 활성화할 때 다음 항목이 표시됩니다:

• 2FA가 활성화되지 않은 멤버 목록
• 본인의 2FA가 활성화되지 않은 경우 경고 메시지
• 변경 사항 적용 전 확인 프롬프트

멤버 2FA 상태 확인 중

CLI를 통해

조직의 모든 멤버와 2FA 설정 상태를 확인할 수 있습니다:

npx @capgo/cli organization members YOUR_ORG_ID

다음 항목이 표시됩니다:

• 멤버 이메일 및 역할
• 2FA 활성화 여부
• 2FA 활성화가 필요한 멤버 수 요약

Web Dashboard를 통해

조직 설정에서 각 멤버의 2FA 활성화 여부를 확인할 수 있습니다.

계정 2FA 설정하기

계정에 2FA를 활성화해야 하는 경우, 다음을 2단계 인증(2FA) 설정 가이드.

모범 사례

강제 적용 전 주의사항

• 사전 공지 진행: 강제 적용을 활성화하기 최소 일주일 전에 팀원들에게 공지하세요
• 지원 제공: 다음을 공유하세요 2FA 설정 가이드 팀원과 함께
• 준비 상태 확인: npx @capgo/cli organization members 2FA를 아직 활성화하지 않은 사용자를 확인하려면

강제 적용 활성화 후

• 액세스 이슈 모니터링: 계정이 잠긴 팀원을 지원할 수 있도록 준비하세요
• 백업 코드 보관: 팀원들에게 2FA 백업 코드를 저장하도록 안내하세요
• 정기적인 검토: 모든 멤버가 2FA를 유지하고 있는지 정기적으로 확인하세요

CI/CD Pipeline용

• API 키 사용: CI/CD 시스템은 사용자 계정이 아닌 API 키를 사용해야 합니다
• API 키 소유자: CI/CD API 키를 생성한 사용자의 2FA가 활성화되어 있는지 확인하세요
• 키 로테이션: 자동화 시스템에서 사용하는 API 키를 정기적으로 로테이션하세요

문제 해결

“액세스 거부: 2단계 인증이 필요합니다”

문제: 조직에 액세스하려고 할 때 이 오류가 발생합니다.

솔루션:

1. 다음으로 이동: 계정 설정
2. 계정에 2FA 활성화
3. 조직에 다시 액세스 시도

“2FA 강제 적용을 활성화할 수 없음”

문제: 해당 조직에 2FA 강제 적용을 설정할 수 없습니다.

솔루션:

• 다음 권한이 있는지 확인하세요: super_admin 조직 내 권한
• 먼저 본인 계정의 2FA를 활성화하세요
• 문제가 지속되면 고객 지원팀에 문의하세요

CLI 명령 실행 실패

문제: CLI 명령이 2FA 관련 오류로 실패합니다.

솔루션:

• API 키가 유효한지 확인하세요: npx @capgo/cli doctor
• API 키 소유자가 2FA를 활성화했는지 확인하세요
• 로그인 기반 인증을 사용하는 경우 다시 인증하세요: npx @capgo/cli login

컴플라이언스

2FA 강제 적용을 통해 조직의 다양한 컴플라이언스 요구 사항을 충족할 수 있습니다:

스탠다드	요구 사항	2FA의 역할
SOC 2	액세스 제어	모든 사용자에 대한 강력한 인증 보장
ISO 27001	정보 보안	신원 확인 계층 추가
HIPAA	액세스 관리	무단 액세스 방지
GDPR	데이터 보호	계정 탈취 위험 감소
PCI DSS	인증 제어	다요소 인증 요구사항 충족

다음 단계

• 계정 2FA 설정하기
• 조직 관리 알아보기
• CI/CD용 API 키 구성하기

2FA Enforcement 다음 단계

사용 중이라면 2FA 강제 적용 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: 암호화 암호화 구현 상세 정보: 컴플라이언스 컴플라이언스 구현 상세 정보: Capgo 보안 스캐너 Capgo Security Scanner 제품 워크플로우: Capgo 보안 Capgo Security 제품 워크플로우 및 Capgo 신뢰 센터 Capgo Trust Center 제품 워크플로우: