User lookups fail with 'PartialResultExceptions' due to Active Directory 'Follow Referrals' configuration
プラットフォームについて: Data Center - この記事は、Data Center プラットフォームのアトラシアン製品に適用されます。
このナレッジベース記事は製品の Data Center バージョン用に作成されています。Data Center 固有ではない機能の Data Center ナレッジベースは、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
問題
Accessing LDAP, such as searching for users in JIRA, Confluence or Crowd (with AD integrated) fails with the exception below:
Caused by: javax.naming.PartialResultException [Root exception is javax.naming.CommunicationException: DomainDnsZones.example.net:389 [Root exception is java.net.ConnectException: Connection refused: connect]]
その他のルート例外として次のものが考えられます。
- javax.naming.PartialResultException
java.net.UnknownHostException
説明
Active Directory servers are integrated with DNS, and modify entries in the DNS server. They refer to themselves in the root of their LDAP tree. If the Confluence (or Crowd, or JIRA) server is pointed to the root of the LDAP tree, and "follow referrals" is turned on (which is the default), then:
- Confluence will search for users.
- AD サーバーは LDAP ツリーのルートにあるユーザーと照会を応答します。これは、ここには多数のユーザーがいる可能性が考えられるためです。
- Confluence will follow the referral. This will result in:
- A DNS lookup of the base DN (
dc=example,dc=com
means a lookup forexample.com
) example.com
のポート 389 または 636 へのコネクション。これは同じサーバーに戻ります。
- A DNS lookup of the base DN (
- Confluence will continue and read the rest of the objects in the domain as normal.
診断
この問題に該当するかどうかを確認するには、次の手順を実行します。
- ユーザー ディレクトリ構成の [高度な設定] セクションで [照会に従う] を無効化します。
- LDAP サーバーのルート DN に接続します。
- ログにエラーが表示されない場合、これは DNS エラーです。
原因
JIRA, Crowd or Confluence can't perform a DNS lookup on the referral in the AD server root. Problems like this are most commonly caused by the server that Confluence is running on not having the same DNS server as the Active Directory server.
ソリューション
DNS 構成の問題の修正
- Configure the server that JIRA is running on to use the DNS server that the Active Directory server is integrated with.
- Double check if the DNS server address has been change recently. Since DNS server record the Confluence information, please delete Confluence address information from the DNS server to resolve the issue.
- If this is not possible, disable 'Follow Referrals' under the advanced settings of your user directory.
[照会に従う] を無効化するとどうなりますか?
- 1 つのドメインのみを保持している場合、設定変更による悪影響はありません。
- フォレストに複数のドメインが参加している場合、クロスドメイン メンバーシップが解決されなくなります。
- If you must have cross-domain memberships and you can't fix the DNS issues, then you can point Confluence at your Global Catalog. This is read-only, but it does contain all users, groups, and memberships from across your Forest. Talk to your AD admin for Global Catalog connection details.