SAML 싱글 사인온

IdP에는 어떤 값을 입력하나요?

Cremit SAML 생성 화면에는 제공자 ID와 현재 플랫폼 주소로 만든 ACS URL 및 SP 엔터티 ID가 표시됩니다. 그 값을 IdP 앱에 그대로 복사하세요. 현재 ACS 경로는 /api/auth/sso/saml2/sp/acs/{providerId}입니다. 이전 callback 주소가 기존 연결을 위해 허용될 수는 있지만 새 설정에 사용할 값은 아닙니다. 오래된 안내에서 주소를 조합하거나 호스트를 고정해 추측하지 마세요.

생성 화면에는 이메일 도메인, IdP 엔터티 ID, IdP SSO URL, 서명 인증서와 서명 알고리즘을 입력합니다. 기본 알고리즘은 SHA-256입니다. 현재 화면에는 IdP 메타데이터 XML 붙여넣기나 Test Login 버튼이 없습니다. IdP가 XML을 제공한다면 필요한 값을 확인해 각각 입력하세요.

제공자를 만들고 도메인 검증하기

Cremit Platform의 조직 SSO 연동에서 SAML 제공자를 추가합니다. 중복되지 않는 소문자 제공자 ID와 이메일 도메인을 입력하고, 화면에 나온 ACS와 엔터티 ID를 IdP 앱에 복사하세요. IdP 앱에서 이메일 주소 형식의 NameID와 서명된 어설션을 설정한 뒤 IdP 엔터티 ID, SSO URL과 현재 인증서를 Cremit에 입력해 저장합니다.

제공자 목록의 도메인 검증 상태를 확인하세요. 미검증이라면 Verify Domain 링크에서 조직의 도메인 검증을 완료한 뒤 이메일 도메인 기반 로그인을 사용해야 합니다. 제공자를 만들었다는 사실만으로 해당 도메인 로그인이 준비된 것은 아닙니다.

로그인 시험과 오류 확인

IdP 앱에 할당된 시험 계정으로 Cremit에서 검증된 이메일 도메인의 로그인을 시작하세요. IdP 인증 후 Cremit 세션으로 돌아오는지 확인합니다. 실패하면 제공자 설정, 도메인 상태와 IdP 로그인 이벤트를 확인하세요. Okta 앱 타일에서는 SP 시작 흐름으로 다시 시작할 수 있지만, 요청 없이 온 SAML 응답을 그대로 수락한다는 뜻은 아닙니다.

어설션 수신자나 목적지 오류가 나면 IdP의 ACS와 Cremit 화면 값을 비교하세요. 서명 오류라면 현재 IdP 서명 인증서와 설정된 알고리즘을 확인합니다. 인증서가 교체되면 Cremit의 저장된 인증서를 갱신하고 다시 로그인해 보세요. 시계 오차 허용값이나 설정 소요 시간을 고정해 약속하지 말고 실제 로그인 오류를 기준으로 조사하세요.

원자료

Better Auth SAML 엔드포인트와 설정

Better Auth 1.7 ACS 이전 안내

Cremit 연동