사용자 인증 제공자 정보 API (V2)

인증 제공자는 로그인 과정에서 Foundry가 사용자를 식별할 정보를 보냅니다. 정확한 정보는 제공자마다 다르지만 일반적으로 외부 시스템의 고유 사용자 식별자입니다. Foundry는 이 정보를 저장해 이후 로그인에서도 같은 사용자를 식별합니다.

UserProviderInfo의 필수 문자열 providerId는 외부 인증 제공자가 정한 사용자 ID입니다. 같은 인증 영역에서 동일한 providerId를 가진 사용자는 최대 한 명입니다. Foundry 사용자 ID인 userId나 인증 제공자 설정 리소스의 authenticationProviderRid와 구분합니다.

조회와 교체

• Get User Provider Info는 Foundry에 저장한 외부 식별자를 조회합니다. OAuth 권한 범위는 api:admin-read입니다.
• Replace User Provider Info는 Foundry에 저장한 연결 식별자를 교체합니다. OAuth 권한 범위는 api:admin-write입니다.

교체할 값은 외부 인증 제공자가 정한 실제 ID여야 합니다. 보호된 인증 영역에서는 주체의 제공자 정보를 교체할 수 없습니다. 교체 요청에도 기존 제공자 정보 조회 권한과 관련된 오류가 반환될 수 있으므로 해당 엔드포인트의 오류 조건을 확인합니다.

SSO 제공자의 설정 리소스와 첫 로그인 전 사용자 등록은 인증 제공자 API에서 다룹니다. 로그인 때 전달되는 그룹 연결 정보는 그룹 인증 제공자 정보와 구분합니다.