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 Details

    • BasicCredentials

      @Deprecated public BasicCredentials(ByteChunk input, Charset charset) throws IllegalArgumentException
      Deprecated.
      Unused. Will be removed in Tomcat 10. Use 3-arg constructor
      Parse the HTTP Authorization header for BASIC authentication as per RFC 2617 section 2, and the Base64 encoded credentials as per RFC 2045 section 6.8.
      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 2617
    • BasicCredentials

      public BasicCredentials(ByteChunk input, Charset charset, boolean trimCredentials) throws IllegalArgumentException
      Parse the HTTP Authorization header for BASIC authentication as per RFC 2617 section 2, and the Base64 encoded credentials as per RFC 2045 section 6.8.
      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 2617
  • 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.