Apache Solr open-source search software
SOLR-15154: Document new options for credentials (#14)
Tomas Fernandez Lobbea946628714c3
diff --git a/solr/solr-ref-guide/src/basic-authentication-plugin.adoc b/solr/solr-ref-guide/src/basic-authentication-plugin.adocindex 28ca11acdf4..3e0fef1de03 100644--- a/solr/solr-ref-guide/src/basic-authentication-plugin.adoc+++ b/solr/solr-ref-guide/src/basic-authentication-plugin.adoc@@ -213,6 +213,16 @@ QueryResponse rsp = req.process(solrClient);While this is method is simple, it can often be inconvenient to ensure the credentials are provided everywhere they're needed. It also doesn't work with the many `SolrClient` methods which don't consume `SolrRequest` objects.+=== Per-Client credentials+Http2SolrClient supports setting the credentials at the client level when building it. This will ensure all requests issued with this particular client get the Basic Authentication headers set.++[source,java]+----+Http2SolrClient client = new Http2SolrClient.Builder(solrUrl)+ .withBasicAuthCredentials(userName, password).build();+QueryResponse rsp = req.process(client);+----+=== Global (JVM) Basic Auth CredentialsAlternatively, users can use SolrJ's `PreemptiveBasicAuthClientBuilderFactory` to add basic authentication credentials to _all_ requests automatically.To enable this feature, users should set the following system property `-Dsolr.httpclient.builder.factory=org.apache.solr.client.solrj.impl.PreemptiveBasicAuthClientBuilderFactory`.