第28章 設定: IdM サーバーおよびレプリカの設定
IdM サーバーおよびバックエンドサービスは、ほとんどの環境で適用可能なデフォルト設定で設定されます。
特定の状況でセキュリティーやパフォーマンスを改善するために、IdM サーバーの設定を調整できる設定エリアがあります。
本章では、IdM サーバーが使用するファイルおよびログ、IdM サーバー設定自体を更新する手順など、IdM 設定に関する情報を説明します。
28.1. Identity Management ファイルおよびログ リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
Identity Management は、異なる Linux サービスを単一の管理コンテキストに統合する統合フレームワークです。ただし、Kerberos、DNS、389 Directory Server、Dogtag Certificate System などの基盤となる技術は、独自の設定ファイルとログファイルを保持します。Identity Management は、独自の設定ファイルおよびツールを使用して、これらの要素を直接管理します。
本セクションでは、IdM が使用するディレクトリー、ファイル、およびログを説明します。IdM で使用される特定サーバーの設定ファイルまたはログの詳細は、製品ドキュメントを参照してください。
28.1.1. IdM サーバー設定ファイルおよびディレクトリーのリファレンス リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
ディレクトリーまたはファイル | 説明 | ||
---|---|---|---|
サーバー設定 | |||
/etc/ipa/ | メインの IdM 設定ディレクトリー。 | ||
/etc/ipa/default.conf | IdM の主な設定ファイル。 | ||
/etc/ipa/server.conf | IdM のオプション設定ファイルこれはデフォルトでは存在しませんが、IdM サーバーの起動時にカスタム設定を読み込むことができます。 | ||
/etc/ipa/cli.conf | IdM コマンドラインツールのオプション設定ファイル。これはデフォルトでは存在しませんが、ipa の使用時にカスタム設定を適用するために作成できます。 | ||
/etc/ipa/ca.crt | IdM サーバーの CA が発行する CA 証明書。 | ||
~/.ipa/ | ユーザーが IdM コマンドを初めて実行したときに、システムユーザーのホームディレクトリーのローカルシステムに作成された、ユーザー固有の IdM ディレクトリー。 | ||
IdM ログ | |||
~/.ipa/log/cli.log | XML-RPC 呼び出しで返されるエラーと ldM コマンドユーティリティーの応答に関するログファイルです。これは、IdM ユーザーとは異なる名前を持つツールを実行するシステムユーザーのホームディレクトリーに作成されます。 | ||
/var/log/ipaclient-install.log | クライアントサービスのインストールログ。 | ||
/var/log/ipaserver-install.log | IdM サーバーのインストールログ。 | ||
/etc/logrotate.d/ | DNS、SSSD、Apache、Tomcat、および Kerberos のログローテーションのポリシー | ||
システムサービス | |||
/etc/rc.d/init.d/ipa/ | IdM サーバーの init スクリプト。 | ||
Web UI | |||
/etc/ipa/html/ | IdM Web UI が使用する HTML ファイルのメイン設定ディレクトリーにあるシンボリックリンクディレクトリー。 | ||
| web UI アプリケーションの Apache ホストで使用される設定ファイル | ||
/etc/httpd/conf/ipa.keytab | Web UI サービスが使用するキータブファイル。 | ||
/usr/share/ipa/ | Web UI が使用するすべての HTML ファイル、スクリプト、およびスタイルシートのメインディレクトリー。 | ||
| web UI アプリケーションの Apache ホストで使用される設定ファイル | ||
/usr/share/ipa/updates/ | Identity Management の更新されたファイル、スキーマ、およびその他の要素が含まれます。 | ||
/usr/share/ipa/html/ | web UI で使用される HTML ファイル、JavaScript ファイル、およびスタイルシートが含まれます。 | ||
/usr/share/ipa/ipaclient/ | Firefox の自動設定機能にアクセスし、IdM Kerberos レルムで機能するように Firefox ブラウザーを設定するのに使用する JavaScript ファイルが含まれています。 | ||
/usr/share/ipa/migration/ | IdM サーバーを移行モードで実行する際に使用される HTML ページ、スタイルシート、および Python スクリプトが含まれます。 | ||
/usr/share/ipa/ui/ | IdM 操作を実行するために UI が使用するすべてのスクリプトが含まれます。 | ||
/var/log/httpd/ | Apache Web サーバーのログファイル。 | ||
Kerberos | |||
/etc/krb5.conf | Kerberos サービスの設定ファイル | ||
SSSD | |||
/usr/share/sssd/sssd.api.d/sssd-ipa.conf | SSSD が使用する IdM サーバー、IdM Directory Server、およびその他の IdM サービスの特定に使用される設定ファイル。 | ||
/var/log/sssd/ | SSSD のログファイル。 | ||
389 ディレクトリーサーバー | |||
/var/lib/dirsrv/slapd-REALM_NAME/ | IdM サーバーが使用する Directory Server インスタンスに関連付けられたスキーマ、設定、およびデータベースファイルすべて。 | ||
/var/log/dirsrv/slapd-REALM_NAME/ | IdM サーバーが使用する Directory Server インスタンスに関連付けられたログファイル | ||
Dogtag Certificate System | |||
/etc/pki-ca/ | IdM CA インスタンスのメインディレクトリー。 | ||
/var/lib/pki-ca/conf/CS.cfg | IdM CA インスタンスの主な設定ファイル。 | ||
/var/lib/dirsrv/slapd-PKI-IPA/ | IdM CA が使用する Directory Server インスタンスに関連付けられたスキーマ、設定、およびデータベースファイルすべて。 | ||
/var/log/dirsrv/slapd-PKI-IPA/ | IdM CA が使用する Directory Server インスタンスに関連付けられたログファイル | ||
キャッシュファイル | |||
/var/cache/ipa/ | IdM サーバーおよび IdM Kerberos パスワードデーモンのキャッシュファイル。 | ||
システムバックアップ | |||
/var/lib/ipa/sysrestore/ | ldM サーバーのインストール時に再設定されたスクリプトおよびすべてのシステムファイルのバックアップが格納されます。NSS、Kerberos (krb5.conf と kdc.conf の両方)、および NTP の元の .conf ファイルが含まれます。 | ||
/var/lib/ipa-client/sysrestore/ | ldM クライアントのインストール時に再設定されたスクリプトおよびすべてのシステムファイルのバックアップが格納されます。一般的には、これは SSSD 認証サービスの sssd.conf ファイルです。 |
28.1.2. IdM ドメインサービスとログローテーション リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
IdM がバックエンドとして使用し、Dogtag Certificate System が使用する 389 Directory Server インスタンスには、独自の内部ログローテーションポリシーがあります。ファイルのサイズ、ログローテーションの間隔、およびログファイルが保持される期間など、ログロテーション設定は、389 Directory Server 設定を編集して、すべて設定できます。これは、Red Hat Directory Server Administrator's Guide に記載されています。
複数の IdM ドメインサービスは、システム logrotate サービスを使用してログローテーションおよび圧縮を処理します。
- ネームド (DNS)
- httpd (Apache)
- tomcat6
- sssd
- krb5kdc (Kerberos ドメインコントローラー)
これらのポリシーのほとんどは、ローテーションスケジュール (週) およびログのアーカイブ (4 週間で 4 週間) の logrotate デフォルトを使用します。
ログローテーション後にサービスを再起動する個々のポリシーは、欠落しているログファイルが受け入れ可能で、圧縮設定になります。
例28.1 デフォルトの httpd ログローテーションファイル
圧縮設定やログファイルのサイズなど、その他の潜在的なログ設定は、グローバルの logrotate 設定または個々のポリシーのいずれかで編集できます。この logrotate 設定は、logrotate の man ページで説明されています。
警告
2 つのポリシーは特殊な
create
ルールを設定します。すべてサービスでは、以前のログと同じ名前、デフォルトの所有者、デフォルトのパーミッションで新しいログファイル作成します。named および tomcat6 ログの場合、create は明示的なパーミッションとユーザー/グループの所有権で設定されます。
ログファイルを所有するユーザーおよびグループは変更しないでください。これは、IdM 操作と SELinux 設定の両方に必要です。ログ移動ポリシーまたはファイルの所有権を変更すると、IdM ドメインサービスが失敗したり、起動できなくなる可能性があります。
28.1.3. default.conf およびコンテキスト設定ファイル リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
レルム情報、LDAP 設定、CA 設定など、一部のグローバルデフォルトは
default.conf
ファイルに保存されます。この設定ファイルは、IdM クライアントおよびサーバーが起動し、ipa コマンドが操作を実行する際に情報を提供するたびに参照されます。
default.conf
ファイルのパラメーターは単なる attribute=value のペアです。属性は大文字と小文字を区別せず、順序を区別しません。
設定属性を追加したり、グローバル値をオーバーライドする場合、ユーザーは コンテキスト 設定ファイルを追加することができます。IdM サーバーの開始時または ipa コマンドの実行時に、異なるオプションを作成する場合ために
server.conf
および cli.conf
ファイルを別々に作成できます。IdM サーバーは、まず server.conf
および cli.conf
ファイルを確認してから default.conf
ファイルを確認します。
/etc/ipa
ディレクトリー内の設定ファイルは、システムのすべてのユーザーに適用されます。ユーザーは、ローカル IdM ディレクトリー ~/.ipa/
に default.conf
、server.conf
、または cli.conf
ファイルを作成して、個別のオーバーライドを設定できます。このオプションのファイルは、ローカルの IdM サービス default.conf
とマージされ、使用されます。
28.1.4. IdM サーバーログの確認 リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
Identity Management は複数の異なる Linux サービスを統合するため、それらのサービスのネイティブログを使用して、それらのサービスの追跡とデバッグを行います。
その他のサービス (Apache、389 Directory Server、および Dogtag Certificate System) はすべて詳細なログとログレベルを持ちます。リターンコード、ログ形式、およびログレベルの詳細は、特定のサーバーのドキュメントを参照してください。
サービス | ログファイル | 説明 | 追加情報 | ||||
---|---|---|---|---|---|---|---|
IdM サーバー | /var/log/ipaserver-install.log | サーバーインストールログ | |||||
IdM サーバー | ~/.ipa/log/cli.log | コマンドラインツールのログ | |||||
IdM クライアント | /var/log/ipaclient-install.log | クライアントインストールログ | |||||
Apache サーバー |
| これは、Apache サーバーの標準的なアクセスログおよびエラーログです。Web UI と XML-RPC コマンドラインインターフェースは Apache を使用するため、IdM 固有のメッセージは Apache メッセージとともにエラーログに記録されます。 | Apache ログの章 | ||||
Dogtag Certificate System | /var/log/pki-ca-install.log | IdM KRA のインストールログ | |||||
Dogtag Certificate System |
| これらのログは、主に証明書操作に関連します。IdM では、これは証明書を使用するサービスプリンシパル、ホスト、およびその他のエンティティーに使用されます。 | ロギングの章 | ||||
389 ディレクトリーサーバー |
| アクセスログとエラーログには、ドメイン Directory Server インスタンスのアクセスと操作の詳細情報が含まれます。エラーログ設定を変更して、非常に詳細な出力を提供できます。 | アクセスログはバッファーされるため、サーバーはデフォルトでは 30 秒ごとにログでのみ書き込みます。 | ||||
389 ディレクトリーサーバー |
| このディレクトリーサーバーインスタンスは、証明書情報を保存するために IdM CA により使用されます。ここでの操作データの多くは、server-replica の対話に関連します。 | アクセスログはバッファーされるため、サーバーはデフォルトでは 30 秒ごとにログでのみ書き込みます。 | ||||
Kerberos | /var/log/krb5libs.log | これは、Kerberos 接続のプライマリーログファイルです。 | この場所は krb5.conf ファイルで設定されるため、一部のシステムで異なる可能性があります。 | ||||
Kerberos | /var/log/krb5kdc.log | これは、Kerberos KDC サーバーの主なログファイルです。 | この場所は krb5.conf ファイルで設定されるため、一部のシステムで異なる可能性があります。 | ||||
Kerberos | /var/log/kadmind.log | これは、Kerberos 管理システムサーバーの主なログファイルです。 | この場所は krb5.conf ファイルで設定されるため、一部のシステムで異なる可能性があります。 | ||||
DNS | /var/log/messages | DNS エラーメッセージは、他のシステムメッセージに含まれます。 | DNS ロギングはデフォルトでは有効になって いません。DNS ロギングは、以下の querylog コマンドを実行して有効にします。
/usr/sbin/rndc querylog
/var/log/messages ファイルにログメッセージが書き込まれます。ログを無効にするには、querylog コマンドを実行します。 |
28.1.4.1. サーバーデバッグロギングの有効化 リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
IdM サーバーのデバッグロギングが
server.conf
ファイルに設定されます。
注記
default.conf
設定ファイルを編集すると、IdM サーバーだけでなく、すべての IdM コンポーネントに影響します。
server.conf
ファイルを編集するか、または作成します。vim server.conf
vim server.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - debug 行を追加し、その値を true に設定します。
[global] debug=True
[global] debug=True
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Apache デーモンを再起動して、変更を読み込みます。
service httpd restart
service httpd restart
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
28.1.4.2. コマンドライン操作のデバッグ リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
ipa コマンドによるコマンドライン操作は、
-v
オプションを指定してデバッグ情報を返すことができます。たとえば、以下のようになります。
オプションを 2 回使用して (
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
-vv
)、XML-RPC 交換を表示します。
重要
-v
と -vv
オプションは グローバル オプションであり、ipa の実行時にサブコマンドの前に使用する必要があります。