[jira] [Created] (SOLR-12531) Update/Improve Kerberos-Authentication-Plugin Ref Guide page

["Jason Gerlowski (JIRA)" <ji...@apache.org>]

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: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org