Sentivex Auth

개요

Sentivex Auth 는 패밀리(Sentivex·SEE·SIT·SCTI·이 랜딩)의 공용 IdP 입니다. 어느 한 곳에서 로그인하면 IdP 세션이 생기고, 다른 제품들이 자동 인증됩니다. IdP 는 조직 광역 역할(브로드롤)만 토큰/userinfo 클레임으로 발급하고, 제품별 세분 권한은 각 제품이 로컬로 해석합니다 — 브로드롤 키는 Sentivex 퍼스펙티브 키와 100% 동일한 계약입니다.

OIDC 플로우

이 랜딩 사이트 자체가 auth 의 실제 OIDC 클라이언트입니다 — 아래 플로우는 이 사이트의 로그인 버튼이 실제로 밟는 경로입니다.

소비자 구현 팁(이 레포 실측): 프록시 뒤에서는 x-forwarded-host/proto 로 공개 origin 을 복원해 redirect_uri 를 IdP 등록값과 일치시켜야 하고(localhost 누출 금지), token/userinfo 응답은 {data} 봉투·bare 양쪽을 방어적으로 언랩해야 합니다.

API 카탈로그

정본은 auth 오리진(Swagger auth.in-bridge.com/docs · ENDPOINTS-REFERENCE.md). 아래는 그룹·prefix 소개, 상세는 로그인 후.

에러 · rate limit

표준 응답: { success:false, error:{ code, message, details }, meta } — 제품별 포맷 상이(SIT 는 {error,code}, auth 는 {success,error{}}).

OAuth2 에러(/oauth/token 등, RFC 6749): invalid_request · invalid_client · invalid_grant · unauthorized_client · unsupported_grant_type · unsupported_response_type · invalid_scope · access_denied · server_error · temporarily_unavailable.

앱별 스코프

역할 × 스코프 매트릭스

MSSP 테넌트 스코프(#44): userinfo 가 allowed_tenants: string[](접근 가능한 enrich tenant_name 목록)을 발급 — 원천은 tenants.settings.dataTenants(jsonb). 데모 MSSP(sentivex-demo) = [in-bridge, hanssem, kumho]. 회귀 검증 스크립트: scripts/verify-userinfo-claims.mjs.

테스트 계정

3계층: ① 시스템역할 super_admin(IdP 전역) ② perspective 역할(제품 스코프·메뉴) ③ 테넌트역할 owner/admin/developer.

역할별 대표 계정: analyst=sj.park · hunter=ha.lee · ciso=hj.lim · responder=yj.oh · general=jw.bae · pm=to.kwon · sales=ny.seo · tenant=ok.kim(owner) · super=admin.demo · [email protected].

브로드롤 계약

IdP 가 발급하는 브로드롤 9종(analyst/hunter/ciso/responder/general/pm/tenant/super/sales)은 각 제품에서 로컬 환산됩니다 — SIT: pm:* 스코프 환산표(role-scopes.ts, IdP 시드와 100% 일치 계약) · SCTI: userinfo scopes['ti-app'] → ti:read/write/hunt · SEE: see/sxe 롤 게이트 + X-Required-Scope. 각 제품 페이지의 인증 섹션에 제품별 상세가 있습니다.

userinfo 공통 클레임 계약(소비자 실측 종합): roles[](브로드롤) · entitlements[](제품 접근 게이트, 예: ti-app) · subscription_status(suspended=차단, active/trial/grace=통과) · plan(메뉴 min_plan 소비 예정) · scopes{제품별}. 계약 SoT 는 inbridge-auth oauth.routes.ts + README §4, 테스트 계정은 docs/ACCOUNTS-MATRIX.md(비밀번호 평문 복제 금지).