그룹 인증 제공자 정보 API (V2)

인증 제공자가 보내는 사용자 로그인 정보에는 Foundry에서 소속되어야 할 그룹이 포함될 수 있습니다. Foundry는 전달받은 외부 그룹에 대응하는 그룹을 만들고 식별 정보를 저장합니다. 이후 로그인에서도 이 정보로 사용자를 올바른 그룹과 연결합니다.

GroupProviderInfo의 필수 문자열 providerId는 외부 인증 제공자가 정한 그룹 ID입니다. 같은 인증 영역에서 동일한 제공자 ID를 가진 그룹은 최대 하나입니다. Foundry의 groupId와 인증 제공자 설정 리소스 RID를 혼동하지 않습니다.

조회와 교체

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

보호된 인증 영역의 주체 정보는 교체할 수 없습니다. 변경 전에 외부 그룹의 실제 식별자와 Foundry 그룹의 대응을 확인합니다.

외부 그룹을 첫 로그인 전에 준비하려면 그룹 사전 등록을 사용할 수 있습니다. 개별 사용자의 외부 식별자는 UserProviderInfo로 관리합니다.