Package org.apache.catalina.authenticator

# Class BasicAuthenticator.BasicCredentials

java.lang.Object
org.apache.catalina.authenticator.BasicAuthenticator.BasicCredentials

Enclosing class:
  BasicAuthenticator

public static class BasicAuthenticator.BasicCredentials extends Object
Parser for an HTTP Authorization header for BASIC authentication as per RFC 2617 section 2, and the Base64 encoded credentials as per RFC 2045 section 6.8.

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `BasicCredentials(ByteChunk input, Charset charset)`
  Parse the HTTP Authorization header for BASIC authentication as per RFC 7617.
  `BasicCredentials(ByteChunk input, Charset charset, boolean trimCredentials)`
  Deprecated.
  Will be removed in Tomcat 11 onwards

- ## Method Summary

  Modifier and Type
  Method
  Description
  `String`
  `getPassword()`
  Trivial accessor.
  `String`
  `getUsername()`
  Trivial accessor.

  ### Methods inherited from class java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Constructor Details

  - ### BasicCredentials

    public BasicCredentials(ByteChunk input, Charset charset) throws IllegalArgumentException
    Parse the HTTP Authorization header for BASIC authentication as per RFC 7617.
    Parameters:
      `input` - The header value to parse in-place
      `charset` - The character set to use to convert the bytes to a string
    Throws:
      `IllegalArgumentException` - If the header does not conform to RFC 7617

  - ### BasicCredentials

    @Deprecated public BasicCredentials(ByteChunk input, Charset charset, boolean trimCredentials) throws IllegalArgumentException
    Deprecated.
    Will be removed in Tomcat 11 onwards
    Parse the HTTP Authorization header for BASIC authentication as per RFC 7617.
    Parameters:
      `input` - The header value to parse in-place
      `charset` - The character set to use to convert the bytes to a string
      `trimCredentials` - Should leading and trailing whitespace be removed from the parsed credentials
    Throws:
      `IllegalArgumentException` - If the header does not conform to RFC 7617

- ## Method Details

  - ### getUsername

    public String getUsername()
    Trivial accessor.
    Returns:
      the decoded username token as a String, which is never be `null`, but can be empty.

  - ### getPassword

    public String getPassword()
    Trivial accessor.
    Returns:
      the decoded password token as a String, or `null` if no password was found in the credentials.