[SOLR-12531] Update/Improve Kerberos-Authentication-Plugin Ref Guide page

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 7.4
• Component/s: Authentication, documentation
• Assignee: Jason Gerlowski
• Reporter: Jason Gerlowski
• Created: 29/Jun/18 17:00
• Updated: 08/Jun/19 15:02

Description

The Kerberos Authentication Plugin 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.