検索

第6章 プラグイン実装サーバー機能リファレンス

download PDF

この章では、プラグインの参考情報を紹介します。

Directory Server プラグイン機能の各設定には、独自のエントリーと、サブツリー cn=plugins,cn=config 下の属性セットがあります。

dn: cn=Telephone Syntax,cn=plugins,cn=config
objectclass: top
objectclass: nsSlapdPlugin
objectclass: extensibleObject
cn: Telephone Syntax
nsslapd-pluginPath: libsyntax-plugin
nsslapd-pluginInitfunc: tel_init
nsslapd-pluginType: syntax
nsslapd-pluginEnabled: on

これらの属性の一部はすべてのプラグインに共通するものであり、特定のプラグインに固有の場合もあります。cn=config サブツリーで ldapsearch を実行すると、特定のプラグインが使用する属性を確認できます。

すべてのプラグインは、extensibleObject オブジェクトクラスから継承された nsSlapdPlugin オブジェクトクラスのインスタンスです。次の例に示すように、両方のオブジェクトクラスが (最上位のオブジェクトクラスに加えて) エントリーに存在する場合、サーバーはプラグイン設定属性を考慮します。

dn:cn=ACL Plugin,cn=plugins,cn=config
objectclass:top
objectclass:nsSlapdPlugin
objectclass:extensibleObject

6.1. すべてのプラグインに共通の属性のリスト

このリストには、簡単な属性の説明、エントリー DN、有効な範囲、デフォルト値、構文、および各属性の例が記載されています。

各 Directory Server プラグインは nsslapdPlugin オブジェクトクラスに属します。

このオブジェクトクラスは Directory Server に定義されています。

上級クラス

top

OID

2.16.840.1.113730.3.2.41

表6.1 必要な属性
属性定義

objectClass

エントリーに割り当てられたオブジェクトクラスを指定します。

cn

エントリーの共通名を指定します。

nsslapd-pluginPath

プラグインライブラリー名を特定します (ライブラリー接尾辞なし)。

nsslapd-pluginInitfunc

プラグインの初期化機能を特定します。

nsslapd-pluginType

プラグインのタイプを識別します。

nsslapd-pluginId

プラグイン ID を特定します。

nsslapd-pluginVersion

プラグインのバージョンを特定します。

nsslapd-pluginVendor

プラグインのベンダーを特定します。

nsslapd-pluginDescription

プラグインの説明を識別します。

nsslapd-pluginEnabled

プラグインを有効にするかどうかを特定します。

nsslapd-pluginPrecedence

実行順序でプラグインの優先度を設定します。

6.1.1. nsslapd-logAccess

この属性を使用すると、プラグインにより実行される検索操作を、cn=confignsslapd-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=confignsslapd-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}

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.