LogLevel

{logging level}

コンポーネントのロギングレベル。

パラメータの値が指定されていない場合は、[Root]セクションのDefaultLogLevelパラメータの値が使用されます。

デフォルト値：Notice

Log

{log type}

コンポーネントのロギング方式。

デフォルト値：Auto

ExePath

{path to file}

コンポーネントの実行パス。

デフォルト値：<opt_dir>/bin/drweb-lookupd

•GNU/Linuxの場合：/opt/drweb.com/bin/drweb-lookupd

•FreeBSDの場合：/usr/local/libexec/drweb.com/bin/drweb-lookupd

RunAsUser

{UID | user name}

このパラメータは、コンポーネントを実行するユーザー名を決定します。ユーザー名は、ユーザーのUIDまたはユーザーのログインとして指定できます。ユーザー名が数字で構成されている場合（つまりUIDに似ている場合）は、「name:」というプレフィックスを付けて指定します。たとえば、RunAsUser = name:123456です。

ユーザー名が指定されていない場合、コンポーネント操作は開始後にエラーが発生して終了します。

デフォルト値：drweb

IdleTimeLimit

{time interval}

コンポーネントの最大アイドル時間。指定された時間が経過すると、コンポーネントはシャットダウンします。

指定可能な値：10秒（10s）から30日（30d）まで。
None値が設定されている場合、コンポーネントは永続的に機能します。コンポーネントがアイドル状態になると、SIGTERMシグナルは送信されません。

デフォルト値：30s

DebugLibldap

{Boolean}

libldapライブラリのデバッグメッセージもデバッグレベルでログファイルに含めるかどうかを示します（つまり、LogLevel = DEBUGの場合）。

デフォルト値：No

LdapCheckCertificate

{No | Allow | Try | Yes}

SSL/TLS経由のLDAP接続の証明書検証モード。

使用可能な値：

•No - サーバーの証明書を要求しない。

•Allow - サーバーの証明書を要求する。証明書が提供されない場合、セッションは通常どおりに続行されます。サーバーの証明書が提供されてもスキャンできない（対応するルート証明書が見つからない）場合、その証明書は無視され、セッションは通常どおりに続行されます。

•Try - サーバーの証明書を要求する。証明書が提供されない場合、セッションは通常どおりに続行されます。サーバーの証明書が提供されても確認できない（対応するルート証明書が見つからない）場合、セッションは終了します。

•Yes - サーバーの証明書を要求する。証明書が提供されないか、スキャンできない場合（対応するルート証明書が見つからない場合）、セッションは終了します。

LDAPデータソースの場合、この証明書検証モードは、ldaps://スキームまたはStartTLS拡張機能が使用されるときのURLの処理方法に影響します。ADデータソースの場合は、対応するセクションでUseSSL=Yesが指定されていると（以下参照）、サーバーへの接続に影響します。

デフォルト値：Yes

LdapCertificatePath

{path to file}

安全なSSL/TLS接続を介したLDAPサーバーへの接続（Active Directory）に使用されるSSL証明書へのパス。

証明書ファイルとプライベートキーファイル（後述のパラメータで指定されます）は、一致するペアを形成する必要があります。

デフォルト値：（未設定）

LdapKeyPath

{path to file}

安全なSSL/TLS接続を介したLDAPサーバーへの接続（Active Directory）に使用されるプライベートキーへのパス。

証明書ファイルとプライベートキーファイル（上記のパラメータで指定されます）は、一致するペアを形成する必要があります。

デフォルト値：（未設定）

LdapCaPath

{path}

SSL/TLSを介したLDAPプロトコルによるデータの共有に信頼して使用できる、信頼できるルート証明書のシステムリストを含むディレクトリまたはファイルへのパス。

デフォルト値：<path to the list of trusted certificates>。パスは、お使いのGNU/Linuxディストリビューションに依存します。

•Astra Linux、Debian、Linux Mint、SUSE Linux、Ubuntuの場合、通常はパス/etc/ssl/certs/です。

•CentOSとFedoraの場合はパス/etc/pki/tls/certs/ca-bundle.crtです。

•他のディストリビューションでは、コマンドopenssl version -dの実行結果によってパスを定義できます。

•コマンドが使用できない場合、またはOSディストリビューションを特定できない場合は、値/etc/ssl/certs/が使用されます。

DbIdleTimeout

{time interval}

データベース（またはRedisストレージ）への確立された接続がアイドル状態になっている場合に、その接続を切断するまでのタイムアウト期間。

デフォルト値：5m

MysqlDefaultConn

{URL}

MySQLデータベースに接続するためのパラメータをデフォルトで設定するURI。

使用可能な値：

•tcp://[<user>[:<password>]@][<host>][:<port>][/<database name>][?<parameter>=<value>[&…]]

•unix://[<user>[:<password>]@]<path to socket>[:<database name>][?<parameter>=<value>[&…]]

URI要件に注意してください。

デフォルト値：（未設定）

PqDefaultConn

{URL}

PostgreSQLデータベースに接続するためのパラメータをデフォルトで設定するURI。

使用可能な値：

•tcp://[<user>[:<password>]@][<host>][:<port>][/<database name>][?<parameter>=<value>[&…]]

•unix://[<user>[:<password>]@]<path to socket>[:<database name>][?<parameter>=<value>[&…]]

URI要件に注意してください。

デフォルト値：（未設定）

SqliteDefaultConn

{path to file}

デフォルトのSQLiteデータベースファイルへのパス（file://スキームプレフィックスを指定）。

デフォルト値：（未設定）

RedisDefaultConn

{URL}

Redisデータベースへの接続パラメータをデフォルトで設定するURLです。

使用可能な値：

•tcp://[<password>@][<host>][:<port>][/<database index>]

•unix://[<password>@]<socket path>[:<database index>]

URI要件に注意してください。

デフォルト値：（未設定）

init

MYSQL_INIT_COMMAND

文字列

データベースへの接続後に実行するSQLコマンド

compression

MYSQL_OPT_COMPRESS

論理

データ圧縮を使用する

connect-timeout

MYSQL_OPT_CONNECT_TIMEOUT

整数

未使用の接続を切断するためのタイムアウト（秒）

reconnect

MYSQL_OPT_RECONNECT

論理

自動再接続を許可または拒否する

read-timeout

MYSQL_OPT_READ_TIMEOUT

整数

サーバーからのパケット受信のタイムアウト（秒）

write-timeout

MYSQL_OPT_WRITE_TIMEOUT

整数

パケットをサーバーに送信するためのタイムアウト（秒）

charset

MYSQL_SET_CHARSET_NAME

文字列

デフォルトの接続に使用される文字エンコーディングの名前

plugin-dir

MYSQL_PLUGIN_DIR

文字列

プラグインを格納するサーバーのディレクトリへのパス

nonblock

MYSQL_OPT_NONBLOCK

整数

ブロック以外のI/O操作のスタックサイズ

ssl-key

MYSQL_OPT_SSL_KEY

文字列

安全な接続を確立するために使用されるプライベートキー（PEM形式）へのパス

ssl-cert

MYSQL_OPT_SSL_CERT

文字列

安全な接続を確立するために使用されるパブリックキー証明書（PEM形式）へのパス

ssl-ca

MYSQL_OPT_SSL_CA

文字列

信頼できるCA証明書を含むファイル（PEM形式）へのパス

ssl-capath

MYSQL_OPT_SSL_CAPATH

文字列

信頼できるCA証明書を含むディレクトリへのパス（PEM形式）

ssl-cipher

MYSQL_OPT_SSL_CIPHER

文字列

安全な接続でサポートされている暗号化アルゴリズムのリスト

ssl-crl

MYSQL_OPT_SSL_CRL

文字列

失効した証明書を含むファイル（PEM形式）へのパス

ssl-crlpath

MYSQL_OPT_SSL_CRLPATH

文字列

失効した証明書を含むディレクトリへのパス（PEM形式）

ssl-fp

MARIADB_OPT_SSL_FP

文字列

有効なサーバー証明書のSHA1ハッシュ

ssl-fp-list

MARIADB_OPT_SSL_FP_LIST

文字列

有効なサーバー証明書のSHA1ハッシュを含むファイルへのパス

tls-passphrase

MARIADB_OPT_TLS_PASSPHRASE

文字列

パスワードで保護されたクライアントプライベートキーのパスワード

tls-version

MARIADB_OPT_TLS_VERSION

文字列

サポートされるTLSバージョンのリスト

server-verify-cert

MYSQL_OPT_SSL_VERIFY_SERVER_CERT

論理

サーバー証明書の検証を許可または禁止する

server-public-key-path

MYSQL_SERVER_PUBLIC_KEY

文字列

RSAサーバーパブリックキーを含むファイル（PEM形式）へのパス

パラメータ

説明

Url

{string}

使用されるLDAPサーバーと抽出されるデータを定義するURL。URLは、RFC 4516に従って次のスキームに基づいて構築されます。

<scheme>://<host>[:<port>]/<dn>[?<attrs>[?<scope>[?<filter>[?<extensions>]]]]

各パラメータは次のとおりです。

<scheme> - サーバーへの接続方法（許可されるスキーム：ldap、ldaps、ldapi）。

<host>[:<port>] - リクエストを受信するLDAPサーバーアドレス。

<dn> - オブジェクトの識別名。このオブジェクトに関する情報が送信されました。

<attrs> - レコード属性の名前。この値はリクエスト内で受信する必要があります。

<scope> - 検索範囲（base、one、sub）。

<filter> - 抽出された属性の値に対するフィルター条件。

<extensions> - リクエストで使用されるLDAP拡張子のリスト。

機能

•属性のリスト<attrs>では、「*」、「+」、「1.1」の任意の特殊文字を使用できます。

•以下の自動的に解決されるプレースホルダーは、URLの<dn>および<filter>部分で使用できます。

▫$uは、クライアントコンポーネントによって送信されたユーザー名（user）に自動的に置き換えられます。

▫$dは、クライアントコンポーネントによって送信されたドメイン（domain）に自動的に置き換えられます。

▫$D - dc=<subdomain>,dc=<domain>に変更される<subdomain>.<domain>チェーン。

▫$$ - 「$」文字。

•<filter>条件で特殊文字（「*」、「(」、「)」、「\」、コードが0の文字など）を通常の文字として使用する必要がある場合、それらの文字は\XXと記述する必要があります。さらに、URL LDAPの特殊文字は、シーケンス%XXを使用してエンコードされます。たとえば、「/」文字のldapiスキームに従ってURLをローカルLDAPサーバーソケットへのパスの一部として使用する場合、この文字は%2fとしてエンコードされます。

•<extensions>で許可される拡張機能として、StartTLSと1.3.6.1.4.1.1466.20037のみがサポートされます。これらの拡張機能では、保護されたスキームであるldapsを使用することが明示されていない場合でも、TLSメカニズム（つまり、LDAPサーバーとの保護された接続の確立）が使用されます。使用される拡張機能の名前の前に「!」文字がある場合は、TLSを使用する必要があります。つまり、安全な接続を確立できない場合には、リクエストは処理されません。それ以外の場合は、安全な接続が確立されていなくてもリクエストは処理されます。

例：

"ldaps://ds.example.com:990/$D?givenName,sn,cn?sub?(uid=$u)"
"ldap://ldap.local/o=org,dc=nodomain?ipNetworkNumber?sub?(objectClass=ipNetwork)?!StartTLS"

デフォルト値：（未設定）

BindDn

{string}

ユーザーが認証を受けなければならないLDAPディレクトリ内のオブジェクト。

例："cn=admin,dc=nodomain"

デフォルト値：（未設定）

BindPassword

{string}

LDAPサーバー上での認証に使用するユーザーのパスワード。

デフォルト値：（未設定）

ChaseReferrals

{Boolean}

現在のLDAPサーバーがリクエストへの応答として他のLDAPサーバーへの参照を返す場合、その参照に従うようコンポーネントに指示します。

デフォルト値：No

パラメータ

説明

Host

{string}

接続するActive Directoryサービスのサーバーが稼働しているホストのドメイン名（FQDN）またはIPアドレス。

例："win2012.win.local"

デフォルト値：（未設定）

Port

{integer}

Active Directoryサービスのサーバーがリッスンするホスト上のポート。

デフォルト値：389

Dn

{string}

Active Directory内のオブジェクトのDN。これはLDAP URLのdn部分に似ています。

例："dc=win,dc=local"

デフォルト値：（未設定）

User

{string}

識別に使用される、サーバー上のユーザーID。

例："Administrator@WIN.LOCAL"

デフォルト値：（未設定）

Password

{string}

Active Directoryサーバー上での認証に使用されるユーザーのパスワード。

デフォルト値：（未設定）

ChaseReferrals

{Boolean}

現在のActive Directoryサーバーがリクエストへの応答として他のLDAPサーバーへの参照を返す場合、その参照に従うようコンポーネントに指示します。

デフォルト値：No

UseSSL

{Boolean}

Active Directoryサーバーへの接続にSSL/TLSを使用するよう指示します。

デフォルト値：No

パラメータ

説明

File

{path}

検索文字列を含むテキストファイルへのパス。

例："/etc/file1"

デフォルト値：（未設定）

Conn

{string}

データベース接続文字列。

使用可能な値：

•Mysql（MySQL）、Pq（PostgreSQL）セクションの場合：

tcp://[<user>[:<password>]@]<host>[:<port>][/<database name>][?<parameter>=<value>[&…]]

unix://[<user>[:<password>]@]<path to socket>[:<database name>][?<parameter>=<value>[&…]]

例："tcp://user:pwd@localhost:1234/userdb"、"unix://user:pwd@/tmp/pgsql.sock:userdb"

URI要件に注意してください。

•Sqlite（SQLite）セクションの場合：

データベースファイルへのパス（file://スキームプレフィックスを指定）。

例："file:///home/user/users.db"

デフォルト値：対応する*DefaultConnパラメータ値によって定義

Request

{string}

データベースへのSQLクエリー文字列（SELECT）。ADおよびLDAPタイプのソースについては、以下の自動的に許可されるマーカーをクエリーで使用できます。

•$u、$Uは、クライアントコンポーネントによって送信されたユーザー名（user）に自動的に置き換えられます。

•$d、$Dは、クライアントコンポーネントによって送信されたドメイン（domain）に自動的に置き換えられます。

•$$は、「$」文字に置き換えられます。

例："SELECT username FROM users INNER JOIN domains ON users.domain = domains.id WHERE domains.name = $d AND users.name = $u"

デフォルト値：（未設定）

Conn

{string}

Redisデータストレージとの接続文字列。

使用可能な値：

•tcp://[<password>@]<host>[:<port>][/<database index>]

•unix://[<password>@]<socket path>[:<database index>]

URI要件に注意してください。

例："tcp://localhost:6379"

デフォルト値：RedisDefaultConnパラメータ値によって定義

Request

{string}

Redisストレージのクエリー文字列。クエリーでは、以下の自動的に許可されるマーカーを使用できます。

•$u、$Uは、クライアントコンポーネントによって送信されたユーザー名（user）に自動的に置き換えられます。

•$d、$Dは、クライアントコンポーネントによって送信されたドメイン（domain）に自動的に置き換えられます。

•$$は、「$」文字に置き換えられます。

例："HVALS bad_users"

デフォルト値：（未設定）