조직 보안

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

Capgo는 조직 관리자가 모든 구성원에게 보안 정책을 적용할 수 있도록 포괄적인 보안 제어 기능을 제공합니다. 이러한 기능을 통해 컴플라이언스 요구 사항을 충족하고, 민감한 데이터를 보호하며, 강력한 보안 태세를 유지할 수 있습니다.

개요

Organization Security 설정을 통해 슈퍼 관리자는 다음 항목을 구성할 수 있습니다:

2단계 인증(2FA) 강제 적용 - 모든 멤버의 2FA 활성화 강제
비밀번호 정책 - 비밀번호 복잡도 요구 사항 설정
API 키 보안 - 보안 API 키 및 만료 정책 적용
SSO (Enterprise 플랜 전용) - 도메인용 SAML 2.0 SSO. Enterprise 플랜에서 사용 가능합니다. 다음을 참조하세요: SSO 설정 가이드.

조직 보안 설정

보안 페이지는 다음과 같이 명확한 섹션으로 구성되어 있습니다:

Security 탭 - 조직 설정 사이드바에서 모든 보안 설정에 액세스할 수 있습니다
2FA 강제 적용 - 2단계 인증(2FA) 요구 사항 설정 및 상태 표시
비밀번호 정책 - 조직 구성원을 위한 비밀번호 복잡도 규칙 구성
API 키 정책 - 보안 API 키 및 만료 요구 사항 설정
API 키 만료 - API 키에 만료 날짜를 필수 적용할지 여부 제어

보안 설정에 접근하기

사이드바에서 다음을 클릭하여 조직 설정으로 이동하세요: 설정 사이드바에서
다음을 클릭하세요: 조직 설정 페이지 상단의 탭
다음을 선택하세요: 보안 조직 네비게이션 바의 탭(방패 아이콘 표시)

2단계 인증(2FA) 강제 적용

2FA 강제 적용을 설정하면 조직의 모든 멤버가 계정에 2단계 인증을 활성화해야 합니다. 이는 비밀번호와 더불어 code 인증을 모두 요구하여 보안 계층을 강화합니다.

2FA 강제 적용 시 발생하는 일

2FA를 설정하지 않은 멤버는 즉시 차단됩니다 조직 앱에 대한 접근이 차단됩니다
웹 대시보드와 CLI 모두 이 요구 사항을 적용합니다
새 멤버는 조직 리소스에 접근하기 전 반드시 2FA를 활성화해야 합니다
시스템은 어떤 멤버가 2FA를 활성화했는지 실시간으로 추적합니다

2FA 상태 패널 이해하기

Security 페이지에는 다음 정보를 보여주는 멤버 2FA 상태 종합적인 패널이 표시됩니다:

전체 멤버 - 조직의 전체 멤버 수
2FA 활성화됨 (녹색 표시) - 2단계 인증을 성공적으로 활성화한 멤버
2FA 미설정 (주황색 경고 표시) - 아직 2FA를 설정해야 하는 멤버

2FA를 활성화하지 않은 멤버는 2FA 미설정 멤버 경고 상자에 나타납니다. 이 상자에는 다음이 표시됩니다:

각 멤버의 이메일 주소와 조직 내 역할
어떤 이메일 목록 복사 연락용으로 영향을 받은 모든 이메일 주소를 빠르게 복사하는 버튼

2FA 강제 적용 활성화

다음으로 이동: 조직 설정 > 보안
다음을 찾으세요: 모든 멤버에게 2FA 필수 적용 페이지 상단 섹션
다음을 참고하세요: 멤버 2FA 상태 영향을 받는 멤버를 확인하는 패널
2FA를 설정하지 않은 멤버가 있다면, 이메일 목록 복사 활성화 전 알림을 보내는 버튼
옆의 스위치를 토글하여 모든 멤버에게 2FA 필수 적용 강제 적용을 활성화하려면
토글에 표시됩니다 비활성화 또는 활성화 우측에 상태가 표시됩니다

CLI 2FA 강제 적용 지원

CLI를 통해서도 2FA 강제 적용을 관리할 수 있습니다:

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

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

# Check member 2FA status
npx @capgo/cli organization members YOUR_ORG_ID

2FA 강제 적용에 대한 자세한 내용은 다음을 참조하세요: 2FA 강제 적용 가이드.

비밀번호 정책

비밀번호 정책을 통해 모든 조직 멤버에게 비밀번호 복잡성 요구 사항을 강제할 수 있습니다. 멤버의 비밀번호가 정책 요구 사항을 충족하지 못할 경우, 조직 리소스에 액세스하기 전에 반드시 비밀번호를 업데이트해야 합니다.

Password Policy 섹션(개요 이미지의 3 표시된 부분)에서 조직 전체의 비밀번호 요구 사항을 간편하게 설정할 수 있습니다.

비밀번호 정책 작동 방식

비밀번호 정책을 활성화하면:

모든 조직 구성원은 비밀번호 복잡성 요구 사항을 준수해야 합니다.
요구 사항을 충족하지 않는 사용자는 비밀번호를 업데이트할 때까지 계정이 잠깁니다.
이 정책은 역할에 관계없이 모든 구성원에게 적용됩니다.

Password Policy 활성화하기

다음으로 이동: 조직 설정 > 보안
아래로 스크롤해 다음 항목을 찾으세요 비밀번호 정책 섹션을 찾으세요
설명을 읽어 보세요: “조직 구성원이 특정 복잡성 요구 사항을 충족하는 비밀번호를 사용하도록 요구합니다”
다음 비밀번호 정책 강제 적용 스위치를 켜서 활성화하세요
토글 설명: “활성화하면 모든 조직 구성원이 조직에 액세스하려면 비밀번호 요구 사항을 충족해야 합니다”

사용 가능한 비밀번호 요구 사항

설정	설명	범위
최소 길이	필요한 최소 문자 수	6-128자
대문자 포함	비밀번호에 대문자(A-Z)가 최소 하나 이상 포함되어야 합니다.	켜기/끄기
숫자 포함	비밀번호에 숫자(0-9)가 최소 하나 이상 포함되어야 합니다.	켜기/끄기
특수 문자 포함	비밀번호에 특수 문자(!@#$%^&*, 등)가 최소 하나 이상 포함되어야 합니다.	켜기/끄기

멤버 준수 현황 추적

비밀번호 정책이 활성화되면 준수 현황을 모니터링할 수 있습니다:

전체 멤버: 조직 내 멤버 수
준수: 비밀번호가 정책 요구 사항을 충족하는 멤버
미준수: 비밀번호 업데이트가 필요한 멤버

미준수 멤버는 이메일 주소와 함께 목록에 표시됩니다. 이메일 목록을 복사하여 정책 안내 및 비밀번호 변경 요청을 보낼 수 있습니다.

비밀번호 정책 권장 사항

적절한 요구 사항부터 시작하세요: 대소문자와 숫자를 혼합한 최소 10-12자 설정은 지나치게 제한적이지 않으면서도 충분한 보안을 제공합니다.
변경 사항을 공유하세요: 새로운 비밀번호 요구 사항을 적용하기 전에 팀원들에게 미리 알리세요.
적응 기간을 부여하세요: 멤버들이 비밀번호를 업데이트할 수 있는 시간을 충분히 주세요.
비밀번호 관리자 사용을 고려하세요: 팀원들이 강력한 비밀번호를 생성하고 저장할 수 있도록 비밀번호 관리자 사용을 권장하세요.

API 키 보안

Capgo는 API 키에 대해 두 가지 보안 제어 기능을 제공합니다. 보안(해시화된) API 키 강제 적용 및 만료 날짜 지정이 가능합니다. API 키 정책 섹션(개요 이미지의 4 표시된 부분)은 키 아이콘으로 식별할 수 있습니다.

보안 API 키 강제 적용

API 키 정책 섹션의 첫 번째 옵션은 보안 API 키 강제 적용입니다. 이 설정을 활성화하면 조직 내의 모든 API 키를 보안/해시 형식을 사용하여 생성해야 합니다.

해시화된 API 키가 더 안전한 이유는 다음과 같습니다:

실제 키 값이 당사 서버에 저장되지 않습니다.
사용자(및 사용자 시스템)만 전체 키에 접근할 수 있습니다.
데이터베이스가 침해되더라도 키는 사용할 수 없습니다

토글 설명: “활성화하면 보안(해시화된) API 키만 이 조직에 접근할 수 있습니다. 평문 API 키는 거부됩니다.”

보안 API 키 활성화하기

다음으로 이동: 조직 설정 > 보안
아래로 스크롤해 다음 항목을 찾으세요 API 키 정책 섹션(키 아이콘을 확인하세요)
다음을 찾으세요: 보안 API 키 강제 적용 토글
스위치를 켜서 보안 API 키 강제 적용을 활성화하세요
기존 키에는 영향을 주지 않으며, 정책은 새로 생성되는 키에만 적용됩니다

API 키 만료 정책

두 번째 옵션(개요 이미지에서 인디케이터로 표시된 5 항목)은 API 키 만료 필수입니다. 모든 API 키에 만료일을 설정하도록 요구하여 유효 기간을 제한할 수 있습니다.

이는 다음과 같은 보안 권장 사항입니다:

키가 유출돼도 노출 기간을 제한
정기적인 키 로테이션 보장
자격 증명 관리 컴플라이언스 준수 지원

토글 설명: “활성화하면 이 조직의 모든 API 키에 만료일이 있어야 합니다”

만료 정책 설정하기

다음으로 이동: 조직 설정 > 보안
다음 API 키 정책 섹션을 찾으세요
다음을 찾으세요: API 키 만료 필수 (아래 Enforce Secure API Keys 토글)
스위치를 켜서 만료 요건을 활성화하세요
활성화되면 다음을 설정하세요 최대 만료 일수 (1-365일)
- 만료 날짜를 미래의 어느 시점까지 설정할 수 있는지 제한합니다
- 예: 90일로 설정하면 키 생성 후 최대 90일까지만 만료 가능

권장 API 키 정책

사용 사례	보안 키	만료	최대 일수
개발	권장 사항	선택 사항	30-90
CI/CD 파이프라인	필수	필수	90-180
프로덕션	필수	필수	30-90
엔터프라이즈/컴플라이언스	필수	필수	30-60

컴플라이언스 및 감사

조직 보안 기능을 통해 다양한 컴플라이언스 요구 사항을 충족할 수 있습니다:

스탠다드	관련 기능
SOC 2	2FA 강제 적용, 비밀번호 정책, API 키 제어
ISO 27001	모든 보안 기능은 액세스 제어를 입증하는 데 도움이 됩니다
HIPAA	강력한 인증 및 액세스 관리
GDPR	액세스 제어를 통한 데이터 보호
PCI DSS	다요소 인증, 강력한 비밀번호

컴플라이언스 상태 모니터링

Security 대시보드에서 다음을 실시간으로 확인할 수 있습니다:

2FA를 활성화한 멤버 수
조직 전체의 비밀번호 정책 준수 현황
API 키 보안 도입 현황

“Copy email list” 기능을 사용하면 정책을 준수하지 않는 멤버 목록을 쉽게 내보내 대상자에게 안내할 수 있습니다.

문제 해결

“액세스 거부: 보안 정책 미충족”

문제: 멤버가 조직에 접근할 수 없습니다.

솔루션:

2FA 강제 적용 여부 확인 - 멤버가 다음을 수행해야 함: 2FA 활성화
비밀번호 정책 활성화 여부 확인 - 멤버가 비밀번호를 업데이트해야 함
Security dashboard에서 멤버의 준수 상태 확인

보안 기능을 활성화할 수 없음

문제: 보안 토글이 비활성화되어 있거나 응답하지 않음.

솔루션:

다음 권한이 있는지 확인하세요: super_admin 조직 내 역할
네트워크 연결을 확인하세요
페이지를 새로고침해 보세요
문제가 지속되면 고객 지원팀에 문의하세요

API 키 생성 실패

문제: 새로운 API 키를 생성할 수 없습니다.

솔루션:

보안 키 사용이 강제된 경우, 보안 키 생성 흐름을 사용 중인지 확인하세요
만료 설정이 필수인 경우, 허용된 범위 내에서 만료 날짜를 설정하세요
최대 만료 일수 설정을 확인하세요

다음 단계

Organization Security에서 계속하기

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