mirror of https://github.com/OpenIdentityPlatform/OpenDJ.git

Valery Kharseko
8 hours ago dd0cbf71a166a384baa2dbae5717c5a2e61b7515
refs
author Valery Kharseko <vharseko@3a-systems.ru>
Sunday, November 22, 2026 13:59 +0100
committer GitHub <noreply@github.com>
Sunday, November 22, 2026 13:59 +0100
commitdd0cbf71a166a384baa2dbae5717c5a2e61b7515
tree 3f13ee842ef37191bae91e8a7a198806f2435481 tree | zip | gz
parent 4ec75a86aed89b4221f8e932889f46da324929c6 view | diff
Document LDAP alias dereferencing in the administration guide (#1322)

## Summary

- Add an Administration Guide chapter on LDAP alias dereferencing. It
covers all four search policies and includes LDIF and `ldapsearch`
examples.
- Explain how OpenDJ applies the filter and scope to aliases found below
the search base. The one-level example shows the results of
`(objectClass=person)` and `(cn=Support)`, and the policy section
explains how to search the target's subtree.
- Use the Antora title and anchor pattern from #1321. After rebasing
onto `master`, `AntoraPageTitlesIT` covers both the alias dereferencing
and Subordinate Backends chapters.

## Validation

- Exercised all four policies on OpenDJ 5.2.1-SNAPSHOT. Verified both
one-level filter results and confirmed when a subtree search includes
descendants of the alias target.
- Passed 26 Asciidoctor extension tests and 12 `AntoraPageTitlesIT`
cases. Checked 646 cross-guide references across 78 pages.
- Verified the chapter title and anchors in the combined Administration
Guide during the initial documentation check.
2 files modified
1 files added
140 ■■■■■ changed files
opendj-doc-generated-ref/src/main/asciidoc/admin-guide/chap-alias-dereferencing.adoc 134 ●●●●● diff | view | raw | blame | history
opendj-doc-generated-ref/src/main/asciidoc/admin-guide/index.adoc 1 ●●●●● diff | view | raw | blame | history
opendj-doc-generated-ref/src/test/java/org/openidentityplatform/opendj/doc/AntoraPageTitlesIT.java 5 ●●●●● diff | view | raw | blame | history