SCIM API 仕様書(2024年11月更新版）

SCIM を使用したユーザーとグループ管理

※ユーザーAPIのactive属性を利用したユーザーの無効化は、12月18日(水)以降に利用可能になる予定です。

SCIM (System for Cross-domain Identity Management) は、ユーザーやそれに紐づくグループ情報の自動管理を容易にするオープンな標準規格です。セキュリオは SCIM 2.0 をサポートしており、ユーザーとグループのプロビジョニングに対応しています。

SCIM APIを利用することで、ユーザーやグループ情報をEntra IDやOktaなどのアイデンティティプロバイダから自動的に同期することができます。

サポートされているアイデンティティプロバイダ

- Microsoft Entra ID
- Okta
- OneLogin

注意:

Oktaをご利用の場合、SCIMのユーザー削除の操作を行うことは現時点では出来ません。今後対応予定です。

SCIM APIの仕様

ベースURL

SCIMを仕様してユーザーとグループを管理するには、次のベースURLをIDプロバイダーに指定します。

https://api.seculio.com/scim/v2

認証

認証には、セキュリオの設定 > SCIMページ上で発行した Bearer トークンを利用します。

SCIM APIを利用する全てのリクエストで、Authorization ヘッダーに発行した Bearer トークンを指定します。

例: Authorization: Bearer ◯◯

サポートされている SCIM ユーザー属性

注意:

• active 属性には現時点では対応しておらず、セキュリオのユーザーを非アクティブ状態にすることはできません。
• カスタム属性には対応していません。
• 作成されたユーザーは、セキュリオ上で設定しているデフォルトの権限が割り当てられます。
• givenNameとfamilyNameが指定された場合、スペースで結合した文字列がセキュリオのユーザー名となります。
  • givenNameとfamilyNameが指定されていない場合、displayNameがセキュリオのユーザー名となります。

ユーザーAPI

注意:

• filterのcountパラメータに指定可能な値の最大値は1,000です。
  • countの指定がない場合は、1ページあたりの取得件数はデフォルトで1,000件になります。

サポートされている SCIM グループ属性

注意:

• ネストされたグループには対応していません。

グループAPI

レート制限

システムが過負荷になることを防止するため、各会社毎にレート制限を設けています。この制限は調整される可能性があります。

レート制限に到達した場合、429 Too Many Requests エラーが返却されるようになります。

ユーザーAPI

グループAPI