SSO (기업)

주의

엔터프라이즈 플랜만 지원하는 SSO 설정이 있습니다. 만약 SSO 설정 아래 설정 → 조직 → 보안, 조직이 엔터프라이즈 플랜에 가입되어 있지 않거나 Capgo 계정 연락처와 연락하세요.

SSO는 무엇입니까?

Single Sign-On (SSO) lets your team log in to Capgo using your company identity provider (IdP). Capgo uses SAML 2.0 through Supabase Auth. When a user’s email domain matches an active SSO provider, they can authenticate against your IdP and are provisioned into the organization during the SSO callback.

SSO는 사용자의 권한을 변경하지 않습니다. 권한은 기업 역할SSO는 인증 방식만 바꾸는 것입니다.

필요 조건

시작하기 전에:

• Capgo에서 Enterprise 구독이 활성화되어야 합니다.
• SAML 2.0을 지원하고 IdP 메타데이터 URL을 노출하는 인증 제공자 IdP 메타데이터 URL (HTTPS) IdP 메타데이터 URL을 공개할 수 있는
• 능력 DNS TXT 레코드 이메일 도메인 (예: )에 대한 company.com 사용자가 user@company.com).
• A Capgo organization member with permission to update organization settings.
• Capgo에서 IDP 관리자 IT/보안 담당자

SSO 설정 위치

1. 열기 https://console.capgo.app/
2. 클릭 설정 좌측 메뉴에서
3. 선택하세요 단체 탭
4. 선택하세요 보안 탭
5. 스크롤하여 SSO 구성Step 1 - IdP를 구성하세요

__CAPGO_KEEP_0__

본인 인증 제공자에서 SAML 2.0 애플리케이션을 새로 만들고 다음 값을 필요로 합니다. Service Provider Capgo SSO 구성 패널에서 표시하는 값:

Field	사용할 곳
ACS URL	Assertion Consumer Service URL
Entity ID	Service Provider entity identifier
SP metadata URL	선택 사항: IdP에서 SP 메타데이터 URL을 지원하는 경우 import
ID 형식	SAML 이름 식별자에 대한 기대되는 형식

IDP는 사용자의 이메일 주소 를 선언해야 합니다. Capgo은 이메일 도메인을 사용하여 활성 SSO 제공자를 결정하고 기존 계정을 일치시킵니다.

Step 2 - Capgo에 SSO 제공자를 추가하세요

1. __CAPGO_KEEP_0__의 SSO 구성 패널에서 새로운 제공자를 추가하기 위해 클릭하세요
2. __CAPGO_KEEP_0__에 입력할 __CAPGO_KEEP_0__ (예를 들어 company.com). 사용자의 로그인 이메일의 도메인 부분과 일치해야 합니다.
3. IDP를 입력하세요 메타데이터 URL HTTPS
4. 제출

상태로 제공자가 생성됩니다 인증待정.

3단계 - 도메인 인증

Capgo은 도메인을 통제하는지 확인하기 전에 SSO가 활성화될 수 있도록합니다.

DNS 제공자에서 TXT 레코드를 추가하세요

Field	Value
Type	TXT
이름 / 호스트	_capgo-sso.<your-domain> (예) _capgo-sso.company.com)
값	인증 토큰

레코드가 등록되면 (DNS TTL 전파는 일반적으로 몇 분에서 1시간까지 걸립니다), DNS 인증 인증 4단계 - 제공자 활성화.

__CAPGO_KEEP_0__

DNS 확인 후 클릭 활성화활성화되면 활성활성된 활성된 활성된 서비스 제공자만 SSO 로그인 흐름에서 사용됩니다.

서비스 제공자를 선택하여 비활성화 서비스 제공자를 대시보드에서 언제든지 비활성화하여 비활성, 그 도메인에 대한 SSO를 중단하지 않고 구성이 삭제되지 않도록 합니다.

5 단계 - 테스트 및 역할 assign

사용자가 첫 번째로 SSO를 통해 로그인하고 해당 조직에 이미 존재하지 않는 경우 Capgo는 그들을 조직에 읽기 역할로 제공합니다.

초기 사용자가 로그인한 후:

1. Settings → 조직 → 회원으로 이동 각 SSO로 제공된 사용자를 찾습니다
2. 그들의 역할을 적절한 수준으로 조정합니다 (
3. 업로드업로드, 작성, 관리자, 등)

자세한 내용은 권한 목록을 확인하세요. 각 역할이 할 수 있는 것을 확인하세요.

주의

Supabase가 이메일을 Capgo에 이미 존재하는 계정에 대한 별도의 SSO 인증 사용자로 생성하면 Capgo는 SSO 식별성을 기존 계정에 합병하고 사용자에게 다시 로그인하도록 요청합니다.

선택 사항 - SSO 강제

__CAPGO_KEEP_0__에서 활성화 제공자 설정을 변경할 수 있습니다. SSO 강제이 설정이 활성화되면 Capgo은 해당 이메일 도메인에 있는 기존 인증 사용자를 SSO 전용으로 표시하고, 도메인에 대한 로그인 흐름은 IdP 인증을 요구합니다. 설정된 제공자로 설정하면 (비활성화비활성화 또는 강제 설정 해제는 해당 도메인에 대한 SSO 전용 표시를 제거합니다.

주의

IdP 관리자와 협의하고 모든 영향을 받은 사용자에게 알리기 전에 강제 설정을 활성화하세요. IdP 인증을 완료하지 못하는 사용자는 해당 도메인에 대해 비밀번호로 로그인할 수 없습니다.

제공자 상태 참조

상태	의미
인증待기	DNS TXT 기록 미인증
인증	도메인 소유 확인; 활성화 준비
활성	이 도메인에 대한 SSO가 활성화됨
비활성	설정 비활성화 대시보드에서; 해당 도메인에 대한 SSO 사용하지 않음; 사용 다시 활성화 Capgo로 돌아가기 활성화

배포 계획서

• 기업 플랜 확인
• IDP에서 SAML 앱을 생성하여 ACS URL 및 Entity ID를 Capgo에서 가져옵니다.
• IDP에서 안정적인 이메일 클레임을 릴리즈하도록 구성
• DNS TXT 레코드를 발행하고 DNS 확인 성공
• 제공자 활성화
• 초기 사용자들이 성공적으로 로그인했습니다
• 기본 역할에서 역할이 승격되었습니다 읽기 필요한 경우
• 강제 결정이 이루어졌으며 (활성화된 경우 통지되었습니다)

관련 문서

• 조직: 역할 및 권한
• 조직 보안: 2FA, 비밀번호, API 키

SSO(기업)에서 계속 진행하세요

SSO(기업) 기능을 사용 중이라면 SSO (기업) 인증 및 계정 흐름을 계획하고 연결하려면 @capgo/capacitor-social-login @capgo/capacitor-social-login의 구현 세부 정보 @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 정보 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric의 구현 세부 정보 두 단계 인증 두 단계 인증의 구현 세부 정보, 그리고 Capacitor 앱에서 OAuth2를 implement하는 5 단계 Capacitor 앱에서 OAuth2를 implement하는 5 단계의 실제 적용 사례