Jason Gerlowski created SOLR-12531:
--------------------------------------
Summary: Update/Improve Kerberos-Authentication-Plugin Ref Guide
page
Key: SOLR-12531
URL: https://issues.apache.org/jira/browse/SOLR-12531
Project: Solr
Issue Type: Improvement
Security Level: Public (Default Security Level. Issues are Public)
Components: documentation
Affects Versions: 7.4
Reporter: Jason Gerlowski
Assignee: Jason Gerlowski
The [Kerberos Authentication
Plugin|https://lucene.apache.org/solr/guide/7_4/kerberos-authentication-plugin.html]
ref-guide page does a good job of informing users how to setup Kerberos in
their Solr deployments.
But it's also got some papercuts that make it tougher to follow than it needs
to be. These include:
- some code snippets use classes that no longer exist. This confuses new
users, as shown by this mailing list question that came up the other day:
http://lucene.472066.n3.nabble.com/SolrJ-Kerberos-Client-API-td4396275.html
- no mention of {{bin/solr auth}} for modifying {{security.json}} for Kerberos.
- missing explanation of {{solr.kerberos.name.rules}} syntax/meaning
- the name: the article's doesn't just cover Solr's auth plugin. It walks a
user through setting up Kerberos on their cluster. Maybe a more general name
is appropriate. ("Setting Up Kerberos"? "Kerberos Support"?)
None of these are major, but I've run into enough papercuts trying to use the
page that I think it's worth fixing. If anyone has other suggestions for
changes please let me know. I hope to have a draft up shortly for review.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
