Update security documentation around username resolution (#5580) (#5583)

* readd auth token doc * Add docs * Remove extra file * remove please * Update _security/configuration/tls.md * Update * split pr --------- (cherry picked from commit 5f12318) Signed-off-by: Stephen Crawford <[email protected]> Signed-off-by: Stephen Crawford <[email protected]> Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
opensearch-project · Nov 13, 2023 · db0dc27 · db0dc27
1 parent 9b7c22c
commit db0dc27
Showing 1 changed file with 1 addition and 1 deletion.
diff --git a/_security/authentication-backends/authc-index.md b/_security/authentication-backends/authc-index.md
@@ -16,7 +16,7 @@ Authentication backend configurations determine the method or methods you use fo
 
 1. To identify a user who wants to access the cluster, the Security plugin needs the user's credentials.
 
-   These credentials differ depending on how you've configured the plugin. For example, if you use basic authentication, the credentials are a username and password. If you use a JSON web token, the credentials (username and roles) are stored within the token itself. If you use TLS certificates, the credentials are the distinguished name (DN) of the certificate. No matter which backend you use, these credentials are included in the request for authentication.
+   These credentials differ depending on how you've configured the plugin. For example, if you use basic authentication, the credentials are a username and password. If you use a JSON web token, the credentials (username and roles) are stored within the token itself. If you use TLS certificates, the credentials are the distinguished name (DN) of the certificate. No matter which backend you use, these credentials are included in the request for authentication. Note, the Security plugin does not distinguish between identity providers when handling standard role mappings. As a result, only backend roles will differ between two users with the same name coming from two different identity providers. 
 
 2. The Security plugin authenticates a request against a backend configured for an authentication provider. Some examples of authentication providers used with OpenSearch include Basic Auth (which uses the internal user database), LDAP/Active Directory, JSON web tokens, SAML, or another authentication protocol.