SCIM API 仕様書

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

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

SCIM APIを利用することで、ユーザーやグループ情報をEntra IDやOktaなどのアイデンティティプロバイダから自動的に同期することができます。
*SCIMは、IdP（Entra IDやOktaなど）とセキュリオ間でユーザーやグループ情報を自動的に同期する仕組みです。手動での同期や更新を行う機能はありません。同期の内容を変更したい場合は、IdP側の設定を変更してください。

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

- Microsoft Entra ID
- Okta
- OneLogin

注意:

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

Google Workspaceの"SSOが事前統合されたクラウドアプリケーション"には対応していません。

SCIM APIの仕様

ベースURL

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

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

認証

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

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

例: Authorization: Bearer ◯◯

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

注意:

• カスタム属性には対応していません。
• 作成されたユーザーは、セキュリオ上で設定しているデフォルトの権限が割り当てられます。
• givenNameとfamilyNameが指定された場合、スペースで結合した文字列がセキュリオのユーザー名となります。
  • givenNameとfamilyNameが指定されていない場合、displayNameがセキュリオのユーザー名となります。

ユーザーAPI

注意:

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

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

注意:

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

グループAPI

レート制限

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

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

ユーザーAPI

グループAPI