Switchboard 고객 API
GitLab v19.6Offering: GitLab Dedicated
요약
이 API를 사용해 GitLab Dedicated 인스턴스의 상태와 유지 관리 기간을 조회하고, Switchboard 콘솔에서 편집할 수 있는 구성을 업데이트합니다. API는 테넌트 관리자 액세스 권한이 있는 인스턴스의 데이터만 반환합니다.
이 API를 사용해 GitLab Dedicated 인스턴스의 상태와 유지 관리 기간을 조회하고, Switchboard 콘솔에서 편집할 수 있는 구성을 업데이트합니다.
API는 테넌트 관리자 액세스 권한이 있는 인스턴스의 데이터만 반환합니다. 경로에 인스턴스를 지정하지 않습니다. API가 액세스 권한에서 인스턴스를 가져옵니다.
모든 엔드포인트는 다음 기본 URL을 사용합니다.
https://console.gitlab-dedicated.com/api/customer/v1
Switchboard 콘솔의 URL이 다르다면, 로그인하는 콘솔의 URL을 사용합니다. 클라이언트 ID와 엔드포인트 경로는 모든 콘솔에서 같습니다.
사전 요구 사항:
- Switchboard에서 인스턴스에 대한 테넌트 관리자 액세스 권한이 있어야 합니다.
인증#
각 요청의 Authorization 헤더에는 Switchboard OAuth 2.0 액세스 토큰이 있어야 합니다.
Switchboard는 Proof Key for Code Exchange(PKCE)를 사용하는 OAuth 2.0 인가 코드 플로로 토큰을 발급합니다.
퍼블릭 클라이언트 switchboard_customer_api_auth를 사용합니다.
이 클라이언트에는 클라이언트 시크릿이 없습니다. read_write 스코프를 요청합니다.
액세스 토큰은 24시간 후에 만료됩니다. 토큰 응답에는 리프레시 토큰도 포함됩니다. 리프레시 토큰을 사용하면 브라우저에서 다시 로그인하지 않고도 새 액세스 토큰을 받을 수 있습니다.
액세스 토큰 가져오기#
표준을 따르는 OAuth 2.0 클라이언트라면 무엇이든 사용할 수 있습니다. 이 예시는 oauth2c를 사용합니다.
액세스 토큰을 가져오려면 다음을 수행합니다.
-
다음 명령을 실행합니다.
oauth2c https://console.gitlab-dedicated.com \ --client-id switchboard_customer_api_auth \ --grant-type authorization_code \ --response-types code \ --response-mode query \ --auth-method none \ --scopes read_write \ --pkce \ --redirect-url http://localhost:3290/callback \ --authorization-endpoint https://console.gitlab-dedicated.com/oauth/authorize \ --token-endpoint https://console.gitlab-dedicated.com/oauth/token이 명령은 브라우저를 엽니다.
-
Switchboard에 로그인합니다.
-
요청을 승인합니다.
명령이 http://localhost:3290/callback에서 콜백을 받아 액세스 토큰을 표시합니다.
각 요청과 함께 토큰을 전송합니다.
curl --request GET \
--header "Authorization: Bearer <your_access_token>" \
--url "https://console.gitlab-dedicated.com/api/customer/v1/tenant/sla_status"
액세스 토큰 갱신#
브라우저에서 다시 로그인하지 않고 새 토큰 쌍을 받으려면, 리프레시 토큰을 토큰 엔드포인트로 전송합니다.
curl --request POST \
--url "https://console.gitlab-dedicated.com/oauth/token" \
--data "grant_type=refresh_token" \
--data "client_id=switchboard_customer_api_auth" \
--data "refresh_token=<your_refresh_token>"
갱신할 때마다 새 리프레시 토큰이 반환됩니다. 가장 최근의 리프레시 토큰을 보관합니다.
브라우저에서 처음 로그인한 후 최대 30일 동안 토큰을 갱신할 수 있습니다.
30일이 지났거나 Switchboard가 토큰을 해지하면 토큰 엔드포인트가 invalid_grant를 반환합니다.
계속하려면 브라우저에서 로그인해 새 액세스 토큰을 받습니다.
속도 제한#
Switchboard는 액세스 토큰별, 소스 IP 주소별로 1분 단위 구간으로 요청 수를 집계합니다.
| 제한 | 분당 요청 수 |
|---|---|
| 액세스 토큰별 | 60 |
| 소스 IP 주소별 | 120 |
토큰 엔드포인트(/oauth/token), 소스 IP 주소별 |
20 |
제한이 적용되면 최대값에 가장 가까운 제한에 대한 다음 헤더가 응답에 포함됩니다.
| 헤더 | 설명 |
|---|---|
RateLimit-Limit |
현재 구간에서 제한이 허용하는 요청 수입니다. |
RateLimit-Remaining |
현재 구간에서 제한이 아직 허용하는 요청 수입니다. |
RateLimit-Reset |
현재 구간이 초기화되는 Unix 시간(초)입니다. 이 값은 남은 시간이 아니라 시각입니다. |
응답에 이 헤더가 없으면 해당 요청에는 제한이 적용되지 않은 것입니다. 헤더의 값을 사용합니다. 표의 숫자를 고정값으로 사용하지 않습니다.
요청이 제한을 초과하면 API가 429 Too Many Requests를 반환합니다.
Retry-After 헤더는 대기해야 하는 시간(초)을 알려 줍니다.
제한을 초과한 상태에서 보낸 요청도 제한 수에 포함됩니다.
클라이언트가 계속 요청을 보내면 구간이 초기화될 때까지 계속 차단됩니다.
오류#
모든 엔드포인트는 다음 상태 코드를 반환할 수 있습니다.
| 상태 코드 | 설명 |
|---|---|
401 Unauthorized |
액세스 토큰이 유효하지 않거나 요청에 액세스 토큰이 없습니다. |
403 Forbidden |
필요한 액세스 권한이 없습니다. |
404 Not Found |
인스턴스에서 고객 API를 사용할 수 없거나 항목이 존재하지 않습니다. |
422 Unprocessable Entity |
Switchboard가 변경을 수락하지 않았습니다. 응답 본문에 문제가 표시됩니다. |
429 Too Many Requests |
요청이 속도 제한을 초과했습니다. |
오류 응답에는 message 속성이 있습니다. 일부 오류에는 더 자세한 내용을 담은 errors 속성도 있습니다.
페이지네이션#
목록 엔드포인트는 항목의 한 페이지를 반환합니다. 다음 속성으로 페이지를 선택합니다.
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
page |
integer | 아니요 | 페이지 번호입니다. 첫 페이지는 1입니다. |
per_page |
integer | 아니요 | 각 페이지의 항목 수입니다. 최대값은 100입니다. |
응답에는 items 배열과 meta 객체가 있습니다.
| 속성 | 유형 | 설명 |
|---|---|---|
meta.current_page |
integer | 이 응답의 페이지 번호입니다. |
meta.total |
integer | 모든 페이지의 항목 수입니다. |
meta.total_pages |
integer | 페이지 수입니다. |
인스턴스 세부 정보 조회#
인스턴스에 대한 세부 정보를 조회합니다.
GET /tenant
성공하면 200 OK와 다음 응답 속성을 반환합니다.
| 속성 | 유형 | 설명 |
|---|---|---|
ever_deployed |
boolean | 인스턴스를 처음 배포한 후 true입니다. 프로비저닝을 해제한 후에도 값은 true로 유지됩니다. |
external_url |
string | GitLab 인스턴스의 URL입니다. |
gitlab_version |
string | 인스턴스에서 현재 실행 중인 GitLab 버전입니다. |
identifier |
string | 인스턴스의 고정 식별자입니다. 인스턴스에 대해 지원팀에 문의할 때 이 값을 사용합니다. |
name |
string | 인스턴스의 표시 이름입니다. |
prerelease_version |
string | 인스턴스가 사전 릴리스 버전을 실행하는 경우 인스턴스의 사전 릴리스 버전입니다. 그렇지 않으면 null입니다. |
reference_architecture_label |
string | 인스턴스의 규모입니다. 예: Up to 10,000 users (XL). |
regions |
object | 인스턴스의 클라우드 리전인 primary, backup, sites입니다. 인스턴스의 클라우드 계정이 구성되기 전에는 null입니다. |
요청 예시:
curl --request GET \
--header "Authorization: Bearer <your_access_token>" \
--url "https://console.gitlab-dedicated.com/api/customer/v1/tenant"
응답 예시:
{
"identifier": "example1a2b3c",
"name": "Example Corp",
"external_url": "https://example.gitlab-dedicated.com",
"gitlab_version": "19.3.3",
"prerelease_version": null,
"reference_architecture_label": "Up to 10,000 users (XL)",
"ever_deployed": true,
"regions": {
"primary": "eu-west-1",
"backup": "eu-central-1",
"sites": ["eu-west-1"]
}
}
SLA 상태 조회#
인스턴스의 가장 최근 가용성 상태를 조회합니다. 이 상태는 Switchboard의 Health 페이지와 같은 데이터를 표시합니다.
이 상태는 계약상의 서비스 수준 계약(SLA)이 아닙니다.
GitLab은 월별 SLA를 자체 집계 방식과 제외 기준으로 별도로 계산합니다.
down 상태가 한 번 나타났다고 해서 SLA 위반을 의미하지는 않습니다.
이 API는 과거 데이터를 반환하지 않습니다.
모니터링 또는 알림 피드로 사용하지 않습니다.
GET /tenant/sla_status
성공하면 200 OK와 다음 응답 속성을 반환합니다.
| 속성 | 유형 | 설명 |
|---|---|---|
covered_experiences |
array | 적용 대상 경험별 상태입니다. 예를 들어 web, git_operations, api, package_registry가 있습니다. 각 항목에는 covered_experience, status, data_as_of가 있습니다. data_available이 false이면 비어 있습니다. |
data_as_of |
string | Switchboard가 관측한 가장 최근 분의 UTC 시간입니다. data_available이 false이면 null입니다. |
data_available |
boolean | 응답에 상태가 있으면 true입니다. 응답에 reason이 있으면 false입니다. |
reason |
string | 사용할 수 있는 상태가 없는 이유입니다. data_available이 false인 경우에만 설정됩니다. |
status |
string | Switchboard가 관측한 가장 최근 분의 인스턴스 상태입니다. data_available이 false이면 null입니다. |
status 속성은 다음 값 중 하나입니다.
| 값 | 설명 |
|---|---|
up |
인스턴스에 알려진 문제가 없습니다. |
down |
인스턴스에 서비스 중단이 있습니다. |
maintenance_window |
인스턴스가 예약된 유지 관리 중입니다. |
insufficient_traffic |
가용성을 계산하기에는 인스턴스의 트래픽이 너무 적습니다. 인스턴스가 한산할 때 흔히 나타나는 상태이며 장애를 의미하지 않습니다. |
reason 속성은 다음 값 중 하나입니다.
| 값 | 설명 |
|---|---|
not_configured |
인스턴스에 SLA 보고가 켜져 있지 않습니다. SLA 보고를 기대한다면 지원팀에 문의합니다. |
no_data |
SLA 보고는 켜져 있지만 Switchboard에 최근 6시간 동안의 데이터가 없습니다. 새 인스턴스이거나 보고가 잠시 중단된 경우 흔히 나타나는 값입니다. |
upstream_error |
Switchboard가 데이터를 가져오는 중 일시적인 오류가 발생했습니다. 잠시 후 다시 시도합니다. |
요청 예시:
curl --request GET \
--header "Authorization: Bearer <your_access_token>" \
--url "https://console.gitlab-dedicated.com/api/customer/v1/tenant/sla_status"
응답 예시:
{
"data_available": true,
"status": "up",
"data_as_of": "2026-10-08T09:41:00.000Z",
"reason": null,
"covered_experiences": [
{ "covered_experience": "web", "status": "up", "data_as_of": "2026-10-08T09:41:00.000Z" },
{ "covered_experience": "git_operations", "status": "up", "data_as_of": "2026-10-08T09:41:00.000Z" }
]
}
모든 유지 관리 기간 목록 조회#
인스턴스의 계획된 유지 관리 기간을 모두 나열합니다. 목록에는 앞으로 예정된 기간과 완료된 기간이 포함됩니다.
GET /tenant/maintenances
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
page |
integer | 아니요 | 페이지 번호입니다. |
per_page |
integer | 아니요 | 각 페이지의 항목 수입니다. 최대값은 100입니다. |
scope |
string | 아니요 | 반환할 기간입니다. all(기본값), upcoming, past 중 하나입니다. upcoming은 가장 가까운 기간을 먼저 표시합니다. all과 past는 가장 최근 기간을 먼저 표시합니다. |
성공하면 200 OK와 items 배열을 반환합니다. 각 항목에는 다음 속성이 있습니다.
| 속성 | 유형 | 설명 |
|---|---|---|
approval_status |
string | pending, approved, rejected 중 하나입니다. |
completed_at |
string | 유지 관리가 완료된 시간입니다. 유지 관리가 완료되기 전에는 null입니다. |
emergency |
boolean | 일반 기간 외의 긴급 유지 관리이면 true입니다. |
end_at |
string | 기간의 예약된 종료 시간입니다. |
gitlab_version |
string | 유지 관리에서 배포하는 GitLab 버전입니다. |
gitlab_version_pinned |
boolean | 인스턴스의 GitLab 버전 업그레이드가 보류 중이면 true입니다. |
id |
integer | 유지 관리 기간의 ID입니다. |
previous_gitlab_version |
string | 유지 관리 이전의 GitLab 버전입니다. 앞으로 예정된 기간의 경우 인스턴스에서 현재 실행 중인 버전입니다. |
start_at |
string | 기간의 예약된 시작 시간입니다. |
started_at |
string | 유지 관리가 시작된 시간입니다. 유지 관리가 시작되기 전에는 null입니다. |
status |
string | planned, running, completed, failed, interrupted, not_run 중 하나입니다. |
scope 값을 알 수 없으면 API가 422 Unprocessable Entity를 반환합니다.
요청 예시:
curl --request GET \
--header "Authorization: Bearer <your_access_token>" \
--url "https://console.gitlab-dedicated.com/api/customer/v1/tenant/maintenances?scope=upcoming"
응답 예시:
{
"items": [
{
"id": 4821,
"start_at": "2026-10-11T21:00:00.000Z",
"end_at": "2026-10-12T01:00:00.000Z",
"started_at": null,
"completed_at": null,
"status": "planned",
"approval_status": "approved",
"emergency": false,
"gitlab_version": "19.3.4",
"previous_gitlab_version": "19.3.3",
"gitlab_version_pinned": false
}
],
"meta": { "current_page": 1, "total": 1, "total_pages": 1 }
}
모든 구성 변경 목록 조회#
인스턴스의 모든 구성 변경을 가장 최근 변경부터 나열합니다. 각 변경에는 무엇이 언제 바뀌었는지, 그리고 변경이 인스턴스에 반영되었는지가 표시됩니다.
GET /tenant/config_changes
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
page |
integer | 아니요 | 페이지 번호입니다. |
per_page |
integer | 아니요 | 각 페이지의 항목 수입니다. 최대값은 100입니다. |
성공하면 200 OK와 items 배열을 반환합니다. 각 항목에는 다음 속성이 있습니다.
| 속성 | 유형 | 설명 |
|---|---|---|
completed_at |
string | 변경이 인스턴스에 반영된 시간입니다. 반영되기 전에는 null입니다. |
config_type |
string | 변경된 구성의 이름입니다. |
id |
integer | 변경의 ID입니다. |
requested_at |
string | 변경을 요청한 시간입니다. |
status |
string | pending, queued, deployed, failed 중 하나입니다. |
요청 예시:
curl --request GET \
--header "Authorization: Bearer <your_access_token>" \
--url "https://console.gitlab-dedicated.com/api/customer/v1/tenant/config_changes?per_page=20"
응답 예시:
{
"items": [
{
"id": 912,
"config_type": "IP allowlist",
"status": "deployed",
"requested_at": "2026-10-06T14:02:11.000Z",
"completed_at": "2026-10-06T14:20:47.000Z"
}
],
"meta": { "current_page": 1, "total": 1, "total_pages": 1 }
}
구성#
이 엔드포인트는 Switchboard 콘솔에서 편집할 수 있는 설정을 조회하고 업데이트합니다. 각 엔드포인트는 콘솔의 한 섹션에 대응합니다.
PUT 엔드포인트는 섹션 전체를 교체합니다. 원하는 전체 구성을 전송합니다.
Switchboard는 전송하지 않은 항목을 제거합니다.
항목 하나를 변경하려면 섹션을 조회하고 항목을 변경한 다음 전체 섹션을 다시 전송합니다.
PUT 엔드포인트는 관련 GET 엔드포인트의 응답을 변경 없이 그대로 받아들입니다.
Switchboard가 설정하는 속성은 무시합니다.
Switchboard는 각 변경을 인스턴스의 구성 변경 기록에 남깁니다. 연락처 정보의 변경은 이 기록에 포함되지 않습니다.
IP 허용 목록 조회#
인스턴스의 IP 허용 목록을 조회합니다.
GET /tenant/ip_allowlist
성공하면 200 OK와 다음 응답 속성을 반환합니다.
| 속성 | 유형 | 설명 |
|---|---|---|
addresses |
array | 허용된 주소입니다. 각 항목에는 address, description, status, created_at이 있습니다. |
addresses[].address |
string | IPv4 또는 IPv6 CIDR 블록입니다. |
addresses[].created_at |
string | 주소를 추가한 시간입니다. Switchboard가 이 값을 설정합니다. |
addresses[].description |
string | 주소에 대한 설명입니다. |
addresses[].status |
string | 주소가 인스턴스에 반영되었는지 표시합니다. Switchboard가 이 값을 설정합니다. |
enabled |
boolean | 인스턴스가 허용 목록을 사용하면 true입니다. 인스턴스가 모든 소스 주소를 허용하면 false입니다. |
IP 허용 목록 교체#
인스턴스의 IP 허용 목록을 교체합니다.
PUT /tenant/ip_allowlist
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
addresses |
array | 예 | 허용된 주소의 전체 목록입니다. 각 항목에는 address(필수)와 description이 있습니다. |
enabled |
boolean | 예 | 허용 목록을 사용하려면 true입니다. |
성공하면 200 OK와 업데이트된 허용 목록을 반환합니다.
요청 예시:
curl --request PUT \
--header "Authorization: Bearer <your_access_token>" \
--header "Content-Type: application/json" \
--data '{"enabled": true, "addresses": [{"address": "203.0.113.0/24", "description": "Office"}]}' \
--url "https://console.gitlab-dedicated.com/api/customer/v1/tenant/ip_allowlist"
연락처 정보 조회#
GitLab이 인스턴스에 대해 사용자에게 연락할 때 쓰는 운영용 이메일 주소를 조회합니다.
GET /tenant/contact_information
성공하면 200 OK와 다음 응답 속성을 반환합니다.
| 속성 | 유형 | 설명 |
|---|---|---|
operational_email_addresses |
array of strings | 인스턴스에 대한 운영 공지를 받는 이메일 주소입니다. |
연락처 정보 교체#
인스턴스의 운영용 이메일 주소를 교체합니다.
PUT /tenant/contact_information
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
operational_email_addresses |
array of strings | 예 | 이메일 주소의 전체 목록입니다. |
성공하면 200 OK와 업데이트된 연락처 정보를 반환합니다.
GitLab이 내부 연락처와 지정된 지원 엔지니어를 설정합니다. 이 API로는 이를 읽거나 변경할 수 없습니다.
리소스 액세스 설정 조회#
인스턴스의 애플리케이션 로그 버킷을 읽을 수 있는 AWS 프린시펄을 조회합니다.
GET /tenant/resource_access
성공하면 200 OK와 다음 응답 속성을 반환합니다.
| 속성 | 유형 | 설명 |
|---|---|---|
bucket_read_arns |
array of strings | 애플리케이션 로그 버킷을 읽을 수 있는 AWS 프린시펄 ARN입니다. |
리소스 액세스 설정 교체#
인스턴스의 애플리케이션 로그 버킷을 읽을 수 있는 AWS 프린시펄을 교체합니다.
PUT /tenant/resource_access
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
bucket_read_arns |
array of strings | 예 | AWS 프린시펄 ARN의 전체 목록입니다. |
성공하면 200 OK와 업데이트된 설정을 반환합니다.
모든 사용자 지정 인증 기관 목록 조회#
인스턴스가 신뢰하는 모든 사용자 지정 인증 기관을 나열합니다.
GET /tenant/custom_certificate_authorities
성공하면 200 OK와 배열을 반환합니다. 각 항목에는 다음 속성이 있습니다.
| 속성 | 유형 | 설명 |
|---|---|---|
authority |
string | 발급자입니다. Switchboard가 인증서에서 이 값을 가져옵니다. |
certificate |
string | PEM 인코딩된 인증서입니다. |
id |
integer | 인증 기관의 ID입니다. |
not_after |
string | 인증서 유효 기간의 종료 시점입니다. |
not_before |
string | 인증서 유효 기간의 시작 시점입니다. |
사용자 지정 인증 기관 교체#
인스턴스가 신뢰하는 사용자 지정 인증 기관을 교체합니다.
PUT /tenant/custom_certificate_authorities
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
certificates |
array of strings | 예 | 신뢰할 PEM 인코딩된 인증서의 전체 집합입니다. |
성공하면 200 OK와 업데이트된 목록을 반환합니다.
인증서 하나가 유효하지 않거나 만료되었다면 Switchboard는 요청을 수락하지 않습니다. 오류에는 해당 인증서의 인덱스가 표시됩니다.
모든 SAML SSO 공급자 목록 조회#
인스턴스의 모든 SAML 싱글 사인온(SSO) 공급자를 오래된 것부터 나열합니다.
GET /tenant/saml_providers
성공하면 200 OK와 공급자 배열을 반환합니다. 각 공급자에는
공급자 속성과 id가 있습니다.
SAML SSO 공급자 조회#
인스턴스의 SAML SSO 공급자 하나를 조회합니다.
GET /tenant/saml_providers/:id
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 공급자의 ID입니다. |
성공하면 200 OK와 공급자를 반환합니다.
공급자가 존재하지 않으면 404 Not Found를 반환합니다.
SAML SSO 공급자 생성#
인스턴스에 SAML SSO 공급자를 생성합니다.
POST /tenant/saml_providers
공급자 속성을 전송합니다.
성공하면 201 Created와 새 공급자를 반환합니다.
SAML SSO 공급자 교체#
인스턴스의 SAML SSO 공급자 하나를 교체합니다.
PUT /tenant/saml_providers/:id
전체 공급자를 전송합니다. 선택 속성을 전송하지 않으면 Switchboard가 해당 속성을 지웁니다.
예를 들어 admin_groups를 전송하지 않으면 Switchboard는 그룹과 관리자의 매핑을 제거합니다.
성공하면 200 OK와 업데이트된 공급자를 반환합니다.
SAML SSO 공급자 삭제#
인스턴스에서 SAML SSO 공급자 하나를 삭제합니다.
DELETE /tenant/saml_providers/:id
성공하면 204 No Content를 반환합니다.
SAML SSO 공급자 속성#
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
enabled |
boolean | 예 | 공급자를 켜려면 true입니다. |
idp_cert_fingerprint |
string | 예 | ID 공급자 인증서의 지문입니다. |
idp_sso_target_url |
string | 예 | ID 공급자의 SSO URL입니다. |
label |
string | 예 | 로그인 버튼에 표시되는 이름입니다. |
name_identifier_format |
string | 예 | 이름 식별자 형식입니다. |
admin_groups |
array of strings | 아니요 | 구성원이 관리자인 그룹입니다. |
attribute_statements |
object | 아니요 | SAML 속성과 사용자 속성의 매핑입니다. |
auditor_groups |
array of strings | 아니요 | 구성원이 감사자인 그룹입니다. |
external_groups |
array of strings | 아니요 | 구성원이 외부 사용자인 그룹입니다. |
force_authn |
boolean | 아니요 | ID 공급자가 인증을 다시 요구하도록 하려면 true입니다. |
groups_attribute |
string | 아니요 | 사용자의 그룹을 담고 있는 SAML 속성입니다. |
issuer |
string | 아니요 | 발급자입니다. |
required_groups |
array of strings | 아니요 | 로그인하려면 사용자가 속해야 하는 그룹입니다. |
security |
object | 아니요 | SAML 보안 설정입니다. |
upstream_two_factor_authn_contexts |
array of strings | 아니요 | 2단계 인증으로 간주되는 인증 컨텍스트입니다. |
이 설정에 대한 자세한 내용은 GitLab Dedicated용 SAML SSO를 참조합니다.