[prev in list] [next in list] [prev in thread] [next in thread] 

List:       solr-dev
Subject:    [jira] [Created] (SOLR-12531) Update/Improve Kerberos-Authentication-Plugin Ref Guide page
From:       "Jason Gerlowski (JIRA)" <jira () apache ! org>
Date:       2018-06-29 17:01:00
Message-ID: JIRA.13169206.1530291649000.42680.1530291660042 () Atlassian ! JIRA
[Download RAW message or body]

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


[prev in list] [next in list] [prev in thread] [next in thread]