활성화된 ID 공급자 조회

활성화된 ID 공급자 목록을 조회합니다. 인증되지 않은 게스트 세션에서도 호출할 수 있도록 허용되어 있어, 로그인 화면에서 활성화된 ID 공급자 진입점을 표시할 때 사용합니다.

필요 권한

인증 없이 호출할 수 있으며, 별도의 권한 검사도 수행하지 않습니다.

HTTP 요청

GET /api/sonar/enabled-id-providers
cURL 예시
curl https://HOSTNAME/api/sonar/enabled-id-providers
요청 매개변수
키필수타입설명비고
localeX문자열로케일-

정상 응답

{
  "providers": [
    {
      "code": "saml",
      "name": "SAML",
      "path": "/sso/saml",
      "icon": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}
  • providers (배열): 활성화된 ID 공급자 목록
    • code (문자열): ID 공급자 코드
    • name (문자열): 로케일이 적용된 표시 이름
    • path (문자열): SSO 로그인 진입 경로. 웹 콘솔을 기준으로 하는 상대 경로이며 절대 URL이 아닙니다. 항상 /sso/<code> 형식입니다
    • icon (문자열): 아이콘 이미지를 표준 Base64로 인코딩한 문자열. data: URI 접두사는 붙지 않습니다. 아이콘이 없으면 null이며, 이미지 형식(MIME 타입)은 응답에 포함되지 않습니다

응답에는 전체 건수를 나타내는 필드가 없습니다. 설정은 등록되어 있으나 해당 ID 공급자 앱이 설치되지 않은 코드는 목록에서 조용히 제외됩니다.

Note
데이터베이스를 사용할 수 없는 상태(초기화 중 등)에서는 오류가 아니라 HTTP 상태 코드 200과 빈 응답 본문({})이 반환됩니다.