docs(upgrade): say what changes for LDAP permission names in 15.8 - #503
Merged
Conversation
Two permission-name changes reach an existing deployment on upgrade and neither was written down. A group or role permission is now named from the entry's RDN rather than from a slice of the DN text, so a group whose CN carries a DN-escaped character -- a comma, in practice -- gets a different permission name than it did in 15.7. Groups that used to collapse onto one name no longer read each other's documents, and documents indexed under the old name stop matching. ldap.role.search.user.enabled now takes effect. Until 15.7 the permission named after the user was granted whatever the setting said, so a deployment that turned it off has been running with the permission anyway and its users lose it on upgrade. Added to the 15.8 migration section in all seven languages.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this adds
Two permission-name changes land on an existing LDAP / Active Directory
deployment when it upgrades to 15.8, and neither was written down. Both are now
in the "15.8-specific migration" section, in all seven languages.
1. Group and role permission names are read from the RDN
A permission is now named from the entry's RDN rather than from a slice of the
DN text (codelibs/fess#3292). A group whose CN carries a character the DN
escapes -- a comma, in practice -- therefore gets a different permission name
than it did in 15.7:
CN=Sales\, EMEA,CN=Users,...2Sales2Sales, EMEACN=Sales\, APAC,CN=Users,...2Sales2Sales, APACTwo consequences worth an operator's attention, and the section states both:
groups that used to collapse onto one name no longer read each other's
documents, and documents indexed under the old name stop matching for
members of that group.
2.
ldap.role.search.user.enablednow takes effectUntil 15.7 the permission named after the user was granted whatever this setting
said, so a deployment that turned it off has been running with the permission
granted anyway. After the upgrade its users lose the permission named after
themselves, and documents permissioned to an individual user stop matching for
that user. The section says to restore the shipped default of
trueto keep theprevious behaviour.
Verification
list-tableshapes checked in all seven files(three rows of three cells each, matching
:header-rows: 1).language. The pre-existing ones are the
|Fess|substitution and:doc:roles that docutils does not resolve on its own.