Red Hat Summit第6章 プラグイン実装サーバー機能リファレンス
この章では、プラグインの参考情報を紹介します。
Directory Server プラグイン機能の各設定には、独自のエントリーと、サブツリー cn=plugins,cn=config 下の属性セットがあります。
これらの属性の一部はすべてのプラグインに共通するものであり、特定のプラグインに固有の場合もあります。cn=config サブツリーで ldapsearch を実行すると、特定のプラグインが使用する属性を確認できます。
すべてのプラグインは、extensibleObject オブジェクトクラスから継承された nsSlapdPlugin オブジェクトクラスのインスタンスです。次の例に示すように、両方のオブジェクトクラスが (最上位のオブジェクトクラスに加えて) エントリーに存在する場合、サーバーはプラグイン設定属性を考慮します。
dn:cn=ACL Plugin,cn=plugins,cn=config objectclass:top objectclass:nsSlapdPlugin objectclass:extensibleObject
dn:cn=ACL Plugin,cn=plugins,cn=config
objectclass:top
objectclass:nsSlapdPlugin
objectclass:extensibleObject6.1. すべてのプラグインに共通の属性のリスト
このリストには、簡単な属性の説明、エントリー DN、有効な範囲、デフォルト値、構文、および各属性の例が記載されています。
各 Directory Server プラグインは nsslapdPlugin オブジェクトクラスに属します。
このオブジェクトクラスは Directory Server に定義されています。
上級クラス
top
OID
2.16.840.1.113730.3.2.41
| 属性 | 定義 |
|---|---|
| エントリーに割り当てられたオブジェクトクラスを指定します。 | |
| エントリーの共通名を指定します。 | |
| プラグインライブラリー名を特定します (ライブラリー接尾辞なし)。 | |
| プラグインの初期化機能を特定します。 | |
| プラグインのタイプを識別します。 | |
| プラグイン ID を特定します。 | |
| プラグインのバージョンを特定します。 | |
| プラグインのベンダーを特定します。 | |
| プラグインの説明を識別します。 | |
| プラグインを有効にするかどうかを特定します。 | |
| 実行順序でプラグインの優先度を設定します。 |
6.1.1. nsslapd-logAccess
この属性を使用すると、プラグインにより実行される検索操作を、cn=config の nsslapd-accesslog パラメーターに設定したファイルに記録できます。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | on | off |
| デフォルト値 | off |
| 構文 | DirectoryString |
| 例 | nsslapd-logAccess: Off |
6.1.2. nsslapd-logAudit
この属性を使用すると、プラグインから送られるデータベースへの変更をログに記録して監査できます。
nsslapd-auditlog-logging-enabled パラメーターが cn=config で有効になっていると、正常な変更イベントが監査ログに記録されます。プラグインで失敗した変更データベース操作をログに記録するには、cn=config で nsslapd-auditfaillog-logging-enabled 属性を有効にします。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | on | off |
| デフォルト値 | off |
| 構文 | DirectoryString |
| 例 | nsslapd-logAudit: Off |
6.1.3. nsslapd-pluginDescription
この属性では、プラグインの説明を追加します。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | nsslapd-pluginDescription: acl access check plug-in |
6.1.4. nsslapd-pluginEnabled
この属性は、プラグインを有効にするかどうかを指定します。この属性はプロトコルで変更できますが、サーバーが次回再起動されたタイミングでのみ有効になります。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | on | off |
| デフォルト値 | on |
| 構文 | DirectoryString |
| 例 | nsslapd-pluginEnabled: on |
6.1.5. nsslapd-pluginId
この属性は、プラグイン ID を指定します。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | 有効なプラグイン ID |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | nsslapd-pluginId: chaining database |
6.1.6. nsslapd-pluginInitfunc
この属性は、起動するプラグイン関数を指定します。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | 有効なプラグイン機能 |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | nsslapd-pluginInitfunc: NS7bitAttr_Init |
6.1.7. nsslapd-pluginPath
この属性は、プラグインへの完全パスを指定します。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | 有効なパス |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | nsslapd-pluginPath: uid-plugin |
6.1.8. nsslapd-pluginPrecedence
この属性は、プラグインの実行順序の優先順位を設定します。優先順位は、プラグインの実行順序を定義し、プラグインの実行前に、プラグインの操作が完了するのを待機できるので、より複雑な環境や対話が可能になります。これは、事前操作および操作後のプラグインにはより重要です。
値が 1 のプラグインの優先度が最も高く、最初に実行され、値が 99 のプラグインは優先度が最も低くなります。デフォルトは 50 です。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | 1 から 99 |
| デフォルト値 | 50 |
| 構文 | 整数 |
| 例 | nsslapd-pluginPrecedence: 3 |
6.1.9. nsslapd-pluginType
この属性は、プラグインのタイプを指定します。詳細は、nsslapd-plugin-depends-on-type を参照してください。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | 有効なプラグインタイプ |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | nsslapd-pluginType: preoperation |
6.1.10. nsslapd-pluginVendor
この属性は、プラグインのベンダーを指定します。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | 承認されたプラグインベンダー |
| デフォルト値 | Red Hat, Inc. |
| 構文 | DirectoryString |
| 例 | nsslapd-pluginVendor: Red Hat, Inc. |
6.1.11. nsslapd-pluginVersion
この属性は、プラグインのバージョンを指定します。
| プラグインパラメーター | 説明 |
|---|---|
| エントリー DN | cn=plug-in name,cn=plugins,cn=config |
| 有効な値 | 有効なプラグインバージョン |
| デフォルト値 | 製品バージョン番号 |
| 構文 | DirectoryString |
| 例 | nsslapd-pluginVersion: {VER} |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}