SSO (기업용)
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
SSO란 무엇인가요?
“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/보안 담당자에게 문의하세요.
SSO 설정 위치
“SSO 설정 위치” 섹션- 열기 https://console.capgo.app/
- 클릭 설정 왼쪽 사이드바에서
- 다음을 선택하세요: 조직 탭
- 다음을 선택하세요: 보안 탭
- 스크롤하여 SSO 설정으로 이동하세요. 이 양식은 조직이 Enterprise 플랜을 사용 중일 때만 표시됩니다.
1단계 - IdP 설정
“1단계 - IdP 설정” 섹션사용 중인 identity provider에서 새로운 SAML 2.0 애플리케이션을 생성하세요. 다음 정보가 필요합니다. 서비스 제공자 Capgo SSO 설정 패널에 표시된 값:
| 필드 | 사용 위치 |
|---|---|
| ACS URL | IdP SAML 앱의 Assertion Consumer Service URL |
| Entity ID | Service Provider 엔티티 식별자 |
| SP 메타데이터 URL | 선택 사항: IdP가 URL을 통한 SP 메타데이터 가져오기를 지원하는 경우 가져오기 |
| NameID 형식 | SAML Name Identifier에 기대되는 형식 |
IdP는 사용자의 이메일 주소를 공개해야 합니다 assertion에 포함됩니다. Capgo은 이메일 도메인을 사용하여 활성 SSO 제공자를 확인하고 기존 계정을 매칭합니다.
2단계 - Capgo에서 SSO 공급자 추가
“2단계 - Capgo에서 SSO 공급자 추가” 섹션- SSO 구성 패널에서 새 공급자를 추가하려면 클릭하세요
- 다음을 입력하세요: 이메일 도메인 (예:
company.com). 사용자 로그인 이메일의 도메인 부분과 일치해야 합니다 - IdP를 입력하세요 메타데이터 URL (HTTPS)
- 제출
공급자는 다음 상태로 생성됩니다: 검증 대기 중.
3단계 - DNS 도메인 검증
“3단계 - DNS 도메인 검증” 섹션Capgo는 SSO가 활성화되기 전에 도메인을 관리하는지 확인합니다.
다음 TXT 레코드를 DNS 제공업체에 추가하세요:
| 필드 | 값 |
|---|---|
| 유형 | TXT |
| 이름 / 호스트 | _capgo-sso.<your-domain> (예: _capgo-sso.company.com) |
| 값 | 대시보드 패널에 표시된 검증 토큰 |
레코드가 게시된 후(DNS TTL 전파는 보통 몇 분에서 1시간 정도 소요됨), DNS 검증 을(를) 대시보드에서 클릭하세요. 성공 시 제공자는 검증됨.
4단계 - 제공자 활성화
“4단계 - 제공자 활성화” 섹션 제목DNS 검증 후 활성화을(를) 클릭하세요. 제공자 상태가 활성. 오직 활성 providers는 SSO 로그인 흐름에서 사용됩니다.
다음 중 하나를 선택할 수 있습니다 비활성화 를 대시보드에서 언제든지 선택할 수 있습니다. 그러면 해당 provider가 비활성화로 이동하여 해당 도메인의 SSO를 설정을 삭제하지 않고 일시 중지합니다.
5단계 - 테스트 및 역할 할당
“5단계 - 테스트 및 역할 할당” 섹션사용자가 SSO로 처음 로그인하고 해당 조직에 기존 멤버십이 없는 경우, Capgo은(는) 다음으로 프로비저닝합니다: 읽기 역할.
파일럿 사용자가 로그인한 후:
- 다음으로 이동: 설정 → 조직 → 멤버
- 각 SSO 프로비저닝된 사용자 찾기
- 역할을 적절한 수준으로 조정(업로드, 쓰기, 관리자등)
참고하세요: 예제 앱의 전체 권한 내역 각 역할이 할 수 있는 작업에 대해.
선택 - SSO 강제 적용
“선택 - SSO 강제 적용” 섹션어떤 활성 provider에서 SSO 강제 적용을 전환할 수 있습니다. 활성화하면 Capgo은 해당 이메일 도메인의 기존 인증 사용자를 SSO 전용으로 표시하고, 해당 도메인의 로그인 플로우에서 IdP 인증을 요구합니다. provider를 비활성화 (비활성화) 또는 강제 적용을 끄면 해당 도메인의 SSO 전용 플래그가 제거됩니다.
Provider 상태 참고
“Provider 상태 참고” 섹션| 상태 | 의미 |
|---|---|
| 검증 대기 중 | 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단계 가이드에서 실무 맥락을 확인하세요.