SAML API (PREMIUM ALL)

引入于极狐GitLab 15.5。

访问 SAML 功能的 API。

获取群组的 SAML 身份

GET /groups/:id/saml/identities

获取群组的 SAML 身份。

支持的参数:

参数 类型 是否必需 描述
id integer/string Yes 群组 ID 或 URL 编码的路径

如果成功,则返回 200和以下响应参数:

参数 类型 描述
extern_uid string 用户的外部 UID
user_id string 用户 ID

请求示例:

curl --location --request GET "https://gitlab.example.com/api/v4/groups/33/saml/identities" --header "PRIVATE-TOKEN: <PRIVATE-TOKEN>"

响应示例:

[
    {
        "extern_uid": "4",
        "user_id": 48
    }
]

获取单个 SAML 身份

引入于极狐GitLab 16.1。

GET /groups/:id/saml/:uid

支持的参数:

参数 类型 是否必需 描述
id integer/string yes 群组 ID 或 URL 编码的路径
uid string yes 用户的外部 UID

请求示例:

curl --location --request GET "https://gitlab.example.com/api/v4/groups/33/saml/sydney_jones" --header "PRIVATE-TOKEN: <PRIVATE TOKEN>"

响应示例:

{
    "extern_uid": "4",
    "user_id": 48
}

更新 SAML 身份的 extern_uid 字段

更新 SAML 身份的 extern_uid 字段。

SAML IdP 参数 极狐GitLab 字段
id/externalId extern_uid
PATCH /groups/:id/saml/:uid

支持的参数:

参数 类型 是否必需 描述
id integer/string yes 群组 ID 或 URL 编码的路径
uid string yes 用户的外部 UID

请求示例:

curl --location --request PATCH "https://gitlab.example.com/api/v4/groups/33/saml/sydney_jones" \
--header "PRIVATE-TOKEN: <PRIVATE TOKEN>" \
--form "extern_uid=sydney_jones_new"