LDAPSの構成

最終公開日 : Nov 13, 2026
セキュアLDAP (LDAPS) を使用すると、Active Directory管理ドメイン向けにセキュアな軽量ディレクトリアクセスプロトコルを有効にし、SSL (Secure Socket Layer)/TLS (Transport Layer Security) を介した通信を提供できます。
デフォルトでは、クライアントとサーバーアプリケーション間のLDAP通信は暗号化されていません。SSL/TLS (LDAPS) を使用するLDAPにより、Linux VDAとLDAPサーバー間のLDAPクエリコンテンツを保護できます。
以下のLinux VDAコンポーネントはLDAPSに依存しています。
  • ブローカーエージェント: Delivery Controller™へのLinux VDA登録
  • ポリシーサービス: ポリシー評価
LDAPSの構成には以下が含まれます。
  • Active Directory (AD)/LDAP サーバーで LDAPS を有効にする
  • クライアントで使用するためにルートCAをエクスポートする
  • Linux VDA で LDAPS を有効/無効にする
  • サードパーティプラットフォーム向けにLDAPSを構成する
  • SSSDを構成する
  • Winbindを構成する
  • Centrifyを構成する
  • Questを構成する
注:
次のコマンドを実行して、LDAPサーバーの監視サイクルを設定できます。デフォルト値は15分です。少なくとも10分に設定してください。
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "ListOfLDAPServersMonitorPeroid" -t "REG_DWORD" -d "0x0000000f" --force
Related information
Linux VDA の構成

AD/LDAPサーバーでLDAPSを有効にする

Microsoft認証局（CA）またはMicrosoft以外のCAのいずれかから、適切にフォーマットされた証明書をインストールすることで、LDAP over SSL（LDAPS）を有効にできます。
ヒント:
ドメインコントローラーにエンタープライズルートCAをインストールすると、LDAP over SSL/TLS（LDAPS）は自動的に有効になります。
証明書のインストール方法とLDAPS接続の確認方法の詳細については、Microsoftサポートサイトの「How to enable LDAP over SSL with a third-party certification authority」を参照してください。
多層（2層または3層など）の認証局階層がある場合、ドメインコントローラーでLDAPS認証に適した証明書が自動的に提供されるわけではありません。
多層認証局階層を使用してドメインコントローラーのLDAPSを有効にする方法については、Microsoft TechNetサイトの「LDAP over SSL (LDAPS) Certificate」の記事を参照してください。

クライアント使用のためにルート認証局を有効にする

クライアントは、LDAPサーバーが信頼するCAからの証明書を使用する必要があります。クライアントのLDAPS認証を有効にするには、ルートCA証明書を信頼されたキーストアにインポートします。
ルートCAのエクスポート方法の詳細については、MicrosoftサポートWebサイトの「How to export Root Certification Authority Certificate」を参照してください。

Linux VDAでLDAPSを有効または無効にする

Linux VDAでLDAPSを有効または無効にするには、次のスクリプトを（管理者としてログオンして）実行します。
このコマンドの構文には、次のものが含まれます。
  • 提供されたルートCA証明書を使用してLDAP over SSL/TLSを有効にする：
    /opt/Citrix/VDA/sbin/enable_ldaps.sh -Enable pathToRootCA
  • チャネルバインディングを使用してLDAP over SSL/TLSを有効にする：
    /opt/Citrix/VDA/sbin/enable_ldaps.sh -Enablecb pathToRootCA
    注:
    チャネルバインディング用のルートCA証明書はPEM形式である必要があります。LDAPSを有効にしてもPython3仮想環境が正常に作成されない場合は、Python3仮想環境の作成の手順に従って手動で作成してください。
    pipツールを使用する際に発生する可能性のあるSSL接続エラーに対処するには、次の信頼済みホストを/etc/pip.confファイルに追加することを検討してください:
    \>[global]
    trusted-host =
    \>pypi.org
    files.pythonhosted.org
  • SSL/TLSなしでLDAPにフォールバックする
/opt/Citrix/VDA/sbin/enable_ldaps.sh -Disable
LDAPS専用のJavaキーストアは**/etc/xdl/.keystore**にあります。影響を受けるレジストリキーは次のとおりです。
HKLM\Software\Citrix\VirtualDesktopAgent\ListOfLDAPServers

HKLM\Software\Citrix\VirtualDesktopAgent\ListOfLDAPServersForPolicy

HKLM\Software\Citrix\VirtualDesktopAgent\UseLDAPS

HKLM\Software\Policies\Citrix\VirtualDesktopAgent\Keystore

HKLM\Software\Citrix\VirtualDesktopAgent\EnableChannelBinding

サードパーティプラットフォームのLDAPSを構成する

Linux VDAコンポーネントの他に、VDAに準拠するいくつかのサードパーティソフトウェアコンポーネント（SSSD、Winbind、Centrify、Questなど）もセキュアLDAPを必要とする場合があります。以下のセクションでは、LDAPS、STARTTLS、またはSASL署名と封印を使用してセキュアLDAPを構成する方法について説明します。
ヒント:
これらのソフトウェアコンポーネントのすべてが、セキュアLDAPを確保するためにSSLポート636を使用することを好むわけではありません。また、ほとんどの場合、LDAPS（ポート636のSSL経由LDAP）はポート389のSTARTTLSと共存できません。

SSSD

オプションに従って、ポート636またはポート389でSSSDセキュアLDAPトラフィックを構成します。詳細については、SSSD LDAP Linux manページを参照してください。

ウィンバインド

Winbind LDAPクエリはADSメソッドを使用します。Winbindはポート389でのStartTLSメソッドのみをサポートします。影響を受ける構成ファイルは**/etc/samba/smb.confおよび/etc/openldap/ldap.conf** (RHELの場合) または**/etc/ldap/ldap.conf** (Ubuntuの場合) です。ファイルを次のように変更します。
  • smb.conf
    ldap ssl = start tls
    ldap ssl ads = yes client ldap sasl wrapping = plain
  • ldap.conf
    TLS_REQCERT never
あるいは、セキュアLDAPはSASL GSSAPI署名と封印によって構成できますが、TLS/SSLとは共存できません。SASL暗号化を使用するには、smb.conf構成を変更します。
ldap ssl = off
ldap ssl ads = no client ldap sasl wrapping = seal

セントリファイ

Centrify はポート 636 で LDAPS をサポートしていません。ただし、ポート 389 では安全な暗号化を提供します。詳細については、Centrify サイトを参照してください。

クエスト

Quest Authentication Service はポート 636 で LDAPS をサポートしていませんが、別の方法を使用してポート 389 で安全な暗号化を提供します。

トラブルシューティング

この機能を使用すると、次の問題が発生する可能性があります。
  • LDAPS サービスの可用性
    AD/LDAP サーバーで LDAPS 接続が利用可能であることを確認してください。ポートはデフォルトで 636 です。
  • LDAPS が有効な場合に Linux VDA の登録に失敗しました
    LDAP サーバーとポートが正しく構成されていることを確認してください。まずルート CA 証明書を確認し、それが AD/LDAP サーバーと一致していることを確認してください。
  • 誤ってレジストリが変更された
    enable\_ldaps.sh を使用せずに誤って LDAPS 関連のキーが更新された場合、LDAPS コンポーネントの依存関係が壊れる可能性があります。
  • Wireshark またはその他のネットワーク監視ツールから SSL/TLS を介して LDAP トラフィックが暗号化されていない
    デフォルトでは、LDAPS は無効になっています。強制的に有効にするには、/opt/Citrix/VDA/sbin/enable\_ldaps.sh を実行してください。
  • Wireshark またはその他のネットワーク監視ツールから LDAPS トラフィックがない
    LDAP/LDAPS トラフィックは、Linux VDA の登録とグループポリシーの評価が行われるときに発生します。
  • AD サーバーで ldp connect を実行して LDAPS の可用性を確認できませんでした
    IPアドレスの代わりにAD FQDNを使用します。
  • /opt/Citrix/VDA/sbin/enable\_ldaps.sh スクリプトの実行によるルートCA証明書のインポートに失敗しました
    CA証明書のフルパスを指定し、ルートCA証明書が正しいタイプであることを確認してください。これは、サポートされているほとんどのJava Keytoolタイプと互換性があるはずです。サポートリストにない場合は、まずタイプを変換できます。証明書形式の問題が発生した場合は、base64エンコードされたPEM形式をお勧めします。
  • Keytool -list を使用してルートCA証明書の表示に失敗しました
    /opt/Citrix/VDA/sbin/enable_ldaps.sh を実行してLDAPSを有効にすると、証明書は /etc/xdl/.keystore にインポートされ、キーストアを保護するためにパスワードが設定されます。パスワードを忘れた場合は、スクリプトを再実行してキーストアを作成できます。