SSO 프로바이더 목록 조회

검색 조건과 일치하는 SSO 프로바이더 설정 목록을 조회합니다. 활성화 상태, 설명, 마지막 수정 시각 등 운영에 필요한 정보를 함께 반환합니다.

필요 권한

관리자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/sso-providers

요청 매개변수

정상 응답

{
  "total_count": 1,
  "providers": [
    {
      "id": "saml",
      "name": "SAML",
      "path": "/sonar/sso/saml",
      "icon": "iVBORw0KGgoAAAANSUhEUgAA...",
      "enabled": true,
      "description": "본사 SAML IdP 연동",
      "updated": "2026-04-15T09:00:00+0900"
    }
  ]
}

• total_count (32비트 정수): 검색 조건과 일치하는 전체 건수
• providers (배열): SSO 프로바이더 설정 목록
  • id (문자열): SSO 프로바이더 식별자
  • name (문자열): 로케일이 적용된 표시 이름
  • path (문자열): SSO 로그인 진입 경로
  • icon (문자열): Base64로 인코딩된 아이콘 이미지. 아이콘이 없으면 null
  • enabled (불리언): 활성화 여부
  • description (문자열): 사용자가 입력한 설명
  • updated (날짜): 마지막 수정 시각

오류 응답

offset, limit 값이 정수가 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' parameter should be int type"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}