LDAPグループリンク

プラン: Premium、Ultimate
提供形態: GitLab Self-Managed

このAPIを使用して、LDAPグループリンクを管理します。詳細については、LDAPによるグループメンバーシップの管理を参照してください。

すべてのLDAPグループリンクを一覧表示

すべてのLDAPグループリンクを一覧表示します。

GET /groups/:id/ldap_group_links

サポートされている属性は以下のとおりです:

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。

リクエスト例:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
     --url "https://gitlab.example.com/api/v4/groups/4/ldap_group_links"

レスポンス例:

[
  {
    "cn": "group1",
    "group_access": 40,
    "provider": "ldapmain",
    "filter": null,
    "member_role_id": null
  },
  {
    "cn": "group2",
    "group_access": 10,
    "provider": "ldapmain",
    "filter": null,
    "member_role_id": null
  }
]

CNまたはフィルターでLDAPグループリンクを追加

CNまたはフィルターを使用してLDAPグループリンクを追加します。

POST /groups/:id/ldap_group_links

サポートされている属性は以下のとおりです:

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス。
`group_access`	整数	はい	LDAPグループのメンバーのデフォルトのアクセスレベルです。使用可能な値: `0` (アクセスなし)、`5` (最小アクセス)、`10` (ゲスト)、`15` (プランナー)、`20` (レポーター)、`25` (セキュリティマネージャー)、`30` (デベロッパー)、`40` (メンテナー)、`50` (オーナー)。
`provider`	文字列	はい	LDAPグループリンクのLDAPプロバイダーIDです。
`cn`	文字列	はい/いいえ	LDAPグループのCNです。`cn`または`filter`のいずれかを指定しますが、両方は指定できません。
`filter`	文字列	はい/いいえ	グループのLDAPフィルターです。`cn`または`filter`のいずれかを指定しますが、両方は指定できません。
`member_role_id`	整数	いいえ	メンバーロールのID。Ultimateのみです。

リクエスト例:

curl --request POST \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     --header "Content-Type: application/json" \
     --data '{"group_access": 40, "provider": "ldapmain", "cn": "group2"}' \
     --url "https://gitlab.example.com/api/v4/groups/4/ldap_group_links"

レスポンス例:

{
  "cn": "group2",
  "group_access": 40,
  "provider": "main",
  "filter": null,
  "member_role_id": null
}

CNまたはフィルターでLDAPグループリンクを削除

CNまたはフィルターを使用してLDAPグループリンクを削除します。

DELETE /groups/:id/ldap_group_links

サポートされている属性は以下のとおりです:

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス
`provider`	文字列	はい	LDAPグループリンクのLDAPプロバイダーIDです。
`cn`	文字列	はい/いいえ	LDAPグループのCNです。`cn`または`filter`のいずれかを指定しますが、両方は指定できません。
`filter`	文字列	はい/いいえ	グループのLDAPフィルターです。`cn`または`filter`のいずれかを指定しますが、両方は指定できません。

リクエスト例:

curl --request DELETE \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     --header "Content-Type: application/json" \
     --data '{"provider": "ldapmain", "cn": "group2"}' \
     --url "https://gitlab.example.com/api/v4/groups/4/ldap_group_links"

成功した場合、応答は返されません。

LDAPグループリンクを削除する (非推奨)

LDAPグループリンクを削除します。非推奨。将来のリリースで削除される予定です。代わりにCNまたはフィルターでLDAPグループリンクを削除を使用してください。

CNを持つLDAPグループリンクを削除します:

DELETE /groups/:id/ldap_group_links/:cn

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス
`cn`	文字列	はい	LDAPグループのCN

特定のLDAPプロバイダーのLDAPグループリンクを削除します:

DELETE /groups/:id/ldap_group_links/:provider/:cn

属性	型	必須	説明
`id`	整数または文字列	はい	グループのIDまたはURLエンコードされたパス
`cn`	文字列	はい	LDAPグループのCN
`provider`	文字列	はい	LDAPグループリンクのLDAPプロバイダー