본문 바로가기

SSO (기업용)

Single Sign-On(SSO)을 사용하면 팀이 회사의 ID 공급자(IdP)를 통해 Capgo에 로그인할 수 있습니다. Capgo은 Supabase Auth를 통해 SAML 2.0을 사용합니다. 사용자의 이메일 도메인이 활성 SSO 공급자와 일치하면 해당 사용자는 IdP로 인증할 수 있으며, SSO 콜백 중에 조직에 프로비저닝됩니다.

SSO는 사용자가 할 수 있는 작업을 바꾸지 않습니다. 권한은 조직 역할에 의해 제어됩니다. SSO는 인증 방식만 변경합니다.

시작하기 전에:

  • Capgo 조직에서 Enterprise 구독이 활성화되어 있습니다.
  • 다음 기능을 지원하는 ID 제공업체(IdP): SAML 2.0 및 IdP 메타데이터 URL (HTTPS).
  • 다음 항목을 게시할 수 있는 권한: DNS TXT 레코드 이메일 도메인용 (예: company.com 사용자가 다음으로 로그인할 때: user@company.com).
  • 조직 설정 업데이트 권한이 있는 Capgo 조직 구성원.
  • 한 IdP 관리자 IT/보안 담당자에게 문의하세요.
  1. 열기 https://console.capgo.app/
  2. 클릭 설정 왼쪽 사이드바에서
  3. 다음을 선택하세요: 조직 탭
  4. 다음을 선택하세요: 보안 탭
  5. 스크롤하여 SSO 설정으로 이동하세요. 이 양식은 조직이 Enterprise 플랜을 사용 중일 때만 표시됩니다.

사용 중인 identity provider에서 새로운 SAML 2.0 애플리케이션을 생성하세요. 다음 정보가 필요합니다. 서비스 제공자 Capgo SSO 설정 패널에 표시된 값:

필드사용 위치
ACS URLIdP SAML 앱의 Assertion Consumer Service URL
Entity IDService Provider 엔티티 식별자
SP 메타데이터 URL선택 사항: IdP가 URL을 통한 SP 메타데이터 가져오기를 지원하는 경우 가져오기
NameID 형식SAML Name Identifier에 기대되는 형식

IdP는 사용자의 이메일 주소를 공개해야 합니다 assertion에 포함됩니다. Capgo은 이메일 도메인을 사용하여 활성 SSO 제공자를 확인하고 기존 계정을 매칭합니다.

2단계 - Capgo에서 SSO 공급자 추가

“2단계 - Capgo에서 SSO 공급자 추가” 섹션
  1. SSO 구성 패널에서 새 공급자를 추가하려면 클릭하세요
  2. 다음을 입력하세요: 이메일 도메인 (예: company.com). 사용자 로그인 이메일의 도메인 부분과 일치해야 합니다
  3. IdP를 입력하세요 메타데이터 URL (HTTPS)
  4. 제출

공급자는 다음 상태로 생성됩니다: 검증 대기 중.

3단계 - DNS 도메인 검증

“3단계 - DNS 도메인 검증” 섹션

Capgo는 SSO가 활성화되기 전에 도메인을 관리하는지 확인합니다.

다음 TXT 레코드를 DNS 제공업체에 추가하세요:

필드값
유형TXT
이름 / 호스트_capgo-sso.<your-domain> (예: _capgo-sso.company.com)
값대시보드 패널에 표시된 검증 토큰

레코드가 게시된 후(DNS TTL 전파는 보통 몇 분에서 1시간 정도 소요됨), DNS 검증 을(를) 대시보드에서 클릭하세요. 성공 시 제공자는 검증됨.

DNS 검증 후 활성화을(를) 클릭하세요. 제공자 상태가 활성. 오직 활성 providers는 SSO 로그인 흐름에서 사용됩니다.

다음 중 하나를 선택할 수 있습니다 비활성화 를 대시보드에서 언제든지 선택할 수 있습니다. 그러면 해당 provider가 비활성화로 이동하여 해당 도메인의 SSO를 설정을 삭제하지 않고 일시 중지합니다.

5단계 - 테스트 및 역할 할당

“5단계 - 테스트 및 역할 할당” 섹션

사용자가 SSO로 처음 로그인하고 해당 조직에 기존 멤버십이 없는 경우, Capgo은(는) 다음으로 프로비저닝합니다: 읽기 역할.

파일럿 사용자가 로그인한 후:

  1. 다음으로 이동: 설정 → 조직 → 멤버
  2. 각 SSO 프로비저닝된 사용자 찾기
  3. 역할을 적절한 수준으로 조정(업로드, 쓰기, 관리자등)

참고하세요: 예제 앱의 전체 권한 내역 각 역할이 할 수 있는 작업에 대해.

선택 - SSO 강제 적용

“선택 - SSO 강제 적용” 섹션

어떤 활성 provider에서 SSO 강제 적용을 전환할 수 있습니다. 활성화하면 Capgo은 해당 이메일 도메인의 기존 인증 사용자를 SSO 전용으로 표시하고, 해당 도메인의 로그인 플로우에서 IdP 인증을 요구합니다. provider를 비활성화 (비활성화) 또는 강제 적용을 끄면 해당 도메인의 SSO 전용 플래그가 제거됩니다.

상태의미
검증 대기 중DNS TXT 레코드 아직 미검증
확인됨도메인 소유권 확인 완료. 활성화 준비 완료
활성이 도메인에 대해 SSO가 활성화되었습니다
비활성화설정자 비활성화 대시보드에서 설정; 해당 도메인에는 SSO가 사용되지 않음; 사용 다시 활성화 로 복귀하려면 활성

롤아웃 체크리스트

“Rollout checklist” 섹션
  • Enterprise 플랜 확인
  • Capgo의 ACS URL과 Entity ID를 사용하여 IdP에서 SAML 앱 생성
  • IdP에서 안정적인 email claim을 발급하도록 구성
  • DNS TXT 레코드 게시 및 DNS 확인 성공
  • Provider 활성화
  • 파일럿 사용자 로그인 성공
  • 기본 역할에서 역할 격상 읽기 필요에 따라
  • 적용 결정 수행 (활성화 시 알림 전송)

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의 구현 세부 사항은, 2단계 인증 2단계 인증(Two-factor authentication)의 구현 세부 사항은, Capacitor 앱에 OAuth2를 구현하는 5단계 Capacitor 앱에서 OAuth2를 구현하는 5단계 가이드에서 실무 맥락을 확인하세요.