> For AI agents: the complete documentation index is available at /resource/ucidm/docs/on-premise/dev/llms.txt, the full documentation bundle is available at /resource/ucidm/docs/on-premise/dev/llms-full.txt.

# SAML 認証 \{#saml-authentication}

UCIDM における SAML 認証について記載します。

UCIDM API は SAML 認証に対応しており、以下の SAML IdP に対して動作を確認できています。

- [OSSTech OpenAM](https://www.osstech.co.jp/product/openam/)

また、UCIDM API を利用しているユーザープロファイル画面においても SAML でのログイン・ログアウトが可能となります。

## 対応フロー \{#supported-flows}

UCIDM の SAML 認証は以下のフローに対応しています。

- SP 起点のログイン
- IdP 起点のログイン
- SP 起点のログアウト
- IdP 起点のログアウト

## バインディング方式 \{#binding-methods}

UCIDM の SAML 認証のログインにおいては、以下のバインディング方式に対応しています。

- HTTP POST Binding

UCIDM の SAML 認証のログアウトにおいては、以下のバインディング方式に対応しています。

- HTTP Redirect Binding

## NameID フォーマット \{#nameid-format}

UCIDM の SAML 認証は以下の NameID フォーマットに対応しています。

- urn:oasis:names:tc:SAML:2.0:nameid-format:persistent

この `urn:oasis:names:tc:SAML:2.0:nameid-format:persistent` に、システム設定 (sourceOpenLDAP/sourceActiveDirectory) の `userUniqueAttribute` に対応する値を連携させることで、その属性値を持つユーザーでログインされます。

## エンドポイント \{#endpoints}

UCIDM の SAML 認証においては、以下のエンドポイントを提供しています。（SAML 認証有効時）

API から直接レスポンスを受け取ることも可能ですが、ユーザープロファイル画面を介してのアクセスを想定しています。

### SAML SP メタデータの取得 \{#saml-sp-metadata}

以下にアクセスすることで、SAML SP のメタデータが取得できます。メタデータにはアクセス時点から 2 日後の有効期限 (validUntil) がセットされます。

- ＜プロトコル＞://＜ユーザープロファイル画面の HOST ＞:＜ PORT ＞/ui/user/api/saml/metadata

### アサーションコンシューマサービス \{#assertion-consumer-service}

以下のアサーションコンシューマサービスのエンドポイントを提供しています。

- ＜プロトコル＞://＜ユーザープロファイル画面の HOST ＞:＜ PORT ＞/ui/user/api/saml/acs

### シングルログアウト \{#single-logout}

以下のシングルログアウト用のエンドポイントを提供しています。

- ＜プロトコル＞://＜ユーザープロファイル画面の HOST ＞:＜ PORT ＞/ui/user/api/saml/slo

### SAML ログイン開始ポイント \{#saml-login-entry-point}

以下にアクセスすることで、SAML SP 起点のログインフローが開始されます。

- ＜プロトコル＞://＜ユーザープロファイル画面の HOST ＞:＜ PORT ＞/ui/user/api/saml/login