> 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. # UCIDM 用語集 \{#glossary} ## experimental: 実験的な機能 \{#experimental} まだ開発中の実験段階の機能であることを表しています。実際のデータを使ってシステム管理者の方にご利用いただき、弊社へのフィードバックを頂けることを目的としています。機能をより良くするための改善点や不具合報告を歓迎します。 experimentalとして提供している機能は今後の開発において提供範囲の変更が発生したり、正常に動作しない条件が含まれるなど安定的に機能を提供できない可能性があります。また原則として弊社のサポートは行っておりません。experimentalの機能を使って、お客様の運用環境で問題が生じたとしても弊社から完全なサポートは提供できないことをご理解いただいたうえでご利用ください。 ## 外部連携モジュール \{#destination-module} UCIDM サーバー内で外部の連携先に ID 連携のための通信を行うモジュールのことです。 サポートしている外部サービスや連携プロトコルの詳細については [外部連携](/resource/ucidm/docs/on-premise/dev/administration/admin-ui/destination/index.md) を参照してください。 ## Agent モジュール \{#agent-module} 内部ディレクトリサービスのサーバーまたはクラウドシステムから変更された ID 情報を検出して UCIDM サーバーへそれらの情報を連携するモジュールのことです。連携元データソースのシステムによっては定期的な問い合わせ (ポーリングと呼ぶ) を行います。 詳細については [Agent モジュール](/resource/ucidm/docs/on-premise/dev/configuration/agent/index.md) を参照してください。 ### PassSync Agent パスワードを扱う特別な Agent モジュールのことです。 一般的にパスワードは暗号化して保存されるため、パスワードを連携するには暗号化される前の文字列 (平文パスワードまたは生パスワードと呼ばれる) を取得する必要があります。そのための特別な処理を行うモジュールが PassSync Agent になります。 PassSync Agent は内部ディレクトリサービスが稼働するサーバーにインストールする必要があります。詳細については [PassSync Agent モジュール](/resource/ucidm/docs/on-premise/dev/configuration/passsync/index.md) を参照してください。 ## ディレクトリサービス \{#directory-service} ネットワーク上のリソースに対して ID と名前を管理するサービスの総称です。 - ユーザー／グループ管理などに X.500 ベースの [LDAP](https://ja.wikipedia.org/wiki/Lightweight_Directory_Access_Protocol) プロトコルがよく使われる - LDAP プロトコルの実装には様々なプロダクトがある - [Active Directory](https://ja.wikipedia.org/wiki/Active_Directory): Windows 向けのマイクロソフト社のディレクトリサービスの実装 - [OpenLDAP](https://ja.wikipedia.org/wiki/OpenLDAP): ミシガン大学のオリジナルの LDAP 実装から派生したもので OpenLDAP Project が開発している ### 内部ディレクトリサービス \{#internal-directory-service} ID 連携の連携元になる内部のサービスを指します。 ## 外部サービス \{#external-service} ID 連携の連携先になる外部のサービスを指します。 [外部連携モジュール](/resource/ucidm/docs/on-premise/dev/glossary/index.md#destination-module) により、複数の外部のディレクトリサービスやクラウドサービスと連携できます。 ## ID 連携 \{#id-federation} ### DN (Distinguished Name) LDAP または UCIDM で管理するエントリー (ユーザーやグループなど) を一意に識別できる ID です。[RFC 4514](https://datatracker.ietf.org/doc/html/rfc4514) で提案されています。後述する **entryUUID との違いは変更可能** であることです。DN の値は更新できます。 ### entryUUID LDAP または UCIDM で管理するエントリー (ユーザーやグループなど) を一意に識別できる ID です。[RFC 4530](https://datatracker.ietf.org/doc/html/rfc4530) で提案されています。前述した **DN との違いは変更できない** ことです。DN の値を更新したいときは entryUUID をエントリーを識別する一意な ID として指定します。 連携元システムの次の属性の値を UCIDM へ ID 連携する際に entryUUID として管理します。 | データソース | 連携元属性名 | UCIDM | | :----------------- | :--------- | :-------- | | OpenLDAP | entryUUID | entryUUID | | Active Directory | objectGUID | entryUUID | | Microsoft Entra ID | objectID | entryUUID | ### primaryID LDAP 認証のユーザー名や外部サービスへ ID 連携するときのアカウント名に相当し、UCIDM のシステム内でユーザー/グループを一意に識別できる ID です。 詳細は [PrimaryID マッピング設定](/resource/ucidm/docs/on-premise/dev/administration/admin-ui/primaryid-mapping.md) を参照してください。 ### primaryGroupID [Active Directory におけるデフォルトグループを定義する属性](https://learn.microsoft.com/ja-jp/windows/win32/adschema/a-primarygroupid) です。ユーザーを作成したときはデフォルトで `Domain Users` グループ (`513`) に関連付けられます。UCIDM のシステム内で管理している primaryID と直接関係はありませんが、ID 連携された任意のグループを primaryGroupID に設定したい場合はそのグループの primaryID を設定します。 ### ID 連携のフロー種別 \{#federation-flow-types} ID 連携のフローについて次の種別があります。 #### 自動同期型 (provisioning, pull) \{#auto-sync} [Agent モジュール](/resource/ucidm/docs/on-premise/dev/glossary/index.md#agent-module) を介して、社内にある [ディレクトリサービス](/resource/ucidm/docs/on-premise/dev/glossary/index.md#directory-service) からエントリーの変更を自動的に検出して、その都度、更新内容を外部サービスへ ID 連携するフローを指します。 ![](/resource/ucidm/docs/on-premise/static/svg/federation-auto-sync.d3c3963fc8.svg) #### 配信型 (push) \{#push-sync} 利用者が管理画面を介して、エントリーの情報を更新したときに外部サービスへ ID 連携するフローを指します。 ![](/resource/ucidm/docs/on-premise/static/svg/federation-push-sync.fa083e0395.svg) ## ユーザープロファイル画面 \{#user-profile} ### 一時パスワード \{#temporary-password} 管理者がユーザーに発行する、次回ログイン時に変更を求めるパスワードのことです。 一時パスワードでログインしたユーザーは、新しいパスワードを設定するまでほかの画面を使えません。 1.10.0 までは「仮パスワード」と呼んでいました。 発行の手順は [ユーザーパスワード変更](/resource/ucidm/docs/on-premise/dev/administration/ucidm-ui/admin.md#user-password-change) を参照してください。 ### 標準ロール \{#standard-role} すべての一般ユーザーに適用するロールのことです。 システムロール `ldap-user` にあたります。 ロールの割り当て方を「ユーザーごとに割り当てる」にしたときは使われません。 詳細については [ロール設定](/resource/ucidm/docs/on-premise/dev/administration/ucidm-ui/admin.md#role-settings) を参照してください。 ### 登録先 OU \{#target-ou} ユーザープロファイル画面でユーザーやグループを登録するときに、どの OU の下にエントリーを作るかを選ぶ欄のことです。 属性定義に `ucidmParentDN` という名前で定義します。 LDAP の属性ではないため、エントリーには書き込まれません。 詳細については [登録先 OU](/resource/ucidm/docs/on-premise/dev/administration/ucidm-ui/admin.md#target-ou) を参照してください。 ### 表示値 \{#view-value} 属性定義のスクリプトの view 関数が、LDAP に格納されている値から作る表示用の値のことです。 LDAP のエントリーには書き込まれません。 エントリー取得 API のレスポンスでは viewAttributes に入ります。 詳細については [表示値と格納値](/resource/ucidm/docs/on-premise/dev/administration/ucidm-ui/admin.md#view-values) を参照してください。 ### スクリプトを動かす属性をこの行で編集する \{#edit-depends} 属性定義で、ある属性 (表示属性) の行で、そのスクリプトの「スクリプトを動かす属性」に選んだ属性 (更新属性) を編集するための設定のことです。 設定の項目名は、属性定義の evaluation の editDepends (真偽値) です。 詳細については [スクリプトを動かす属性をこの行で編集する](/resource/ucidm/docs/on-premise/dev/administration/ucidm-ui/admin.md#edit-depends) を参照してください。 ### 入力の形 \{#attribute-type} 属性定義で、ユーザー詳細・ユーザー登録・登録情報の編集などで値を入力する欄の形を選ぶ設定のことです。 設定の項目名は、属性定義の attributeType (文字列) です。 詳細については [入力の形](/resource/ucidm/docs/on-premise/dev/administration/ucidm-ui/admin.md#attribute-type) を参照してください。 ## タスクキュー \{#task-queue} 詳細は [タスクキュー機能](/resource/ucidm/docs/on-premise/dev/administration/admin-ui/task.md) を参照してください。 ### タスク \{#task-task} バッチ処理の実行単位を指す。種別 (type) とパラメーター (payload) をもつ。 ### キュー (レーン) \{#task-lane} タスクを保持する待ち行列を指す。タスク種別ごとに分離できる。 基本的に異なるタスク種別は並行に実行される。負荷の高いタスクは同時実行数を1つに制限している場合もあるが、タスクによっては複数キューで同時実行される場合もある。 ### ワーカー \{#task-worker} キューからタスクを取り出して実際に実行するインスタンスを指す。 ### at-least-once \{#task-at-least-once} サーバーの停止やワーカーの異常終了などにより、同一タスクが2回以上実行される可能性があることを指します。原則としてタスクは何度実行しても結果が変わらないことを前提に実装されています (冪等性) 。 障害調査など、重複実行が起きうることを想定してください。 ## リカバリとリトライ \{#recovery-and-retry} ### リカバリ \{#recovery} エンドユーザーの平文パスワードは再取得できないことから一時的に PassSync Agent が稼働しているサーバー内に難読化した上で保存し、定期的にそれらを読み込んで再送を試みます。環境変数 UCIDM_RECOVERY_XXX で設定します。 ### リトライ \{#retry} 主にはネットワークエラーのような、一時的な障害に対して短い時間をあけて再リクエストすることで復旧できることを想定しています。環境変数 CLIENT_RETRY_XXX で設定します。