Class LoginContextFactory

java.lang.Object
com.sap.security.auth.login.LoginContextFactory

public abstract class LoginContextFactory extends Object
The factory of JAAS login contexts can be used to instantiate login contexts with the correct class loading environment for the configured login modules. Each create method corresponds to a constructor of javax.security.auth.login.LoginContext
See Also:
  • Constructor Details

    • LoginContextFactory

      public LoginContextFactory()
  • Method Details

    • createLoginContext

      public static LoginContext createLoginContext() throws LoginException
      Construct a prepared login context for the configuration of the current application.
      Returns:
      - an instance of LoginContext that can be used for authentication
      Throws:
      LoginException - - thrown in case the login context cannot be constructed, e.g. there is no current application, or the authentication stack is unknown.
    • createLoginContext

      public static LoginContext createLoginContext(String authenticationStack) throws LoginException
      Construct a login context for an already configured authentication stack with the given name.
      Parameters:
      authenticationStack - - the name of the configuration for the authentication stack.
      Returns:
      - an instance of LoginContext that can be used for authentication
      Throws:
      LoginException - - thrown in case the login context cannot be constructed, e.g. the authentication stack is unknown.
    • createLoginContext

      public static LoginContext createLoginContext(String authenticationStack, CallbackHandler callbackHandler) throws LoginException
      Construct a login context for an already configured authentication stack with the given name and call-back handler.
      Parameters:
      authenticationStack - - the name of the configuration for the authentication stack.
      callbackHandler - - an instance of JAAS call-back handler for the use of the authentication process. It can be null in case the current thread of control processes a request with associated call-back hander.
      Returns:
      - an instance of LoginContext that can be used for authentication
      Throws:
      LoginException - - thrown in case the login context cannot be constructed, e.g. the authentication stack is unknown.
    • createLoginContext

      public static LoginContext createLoginContext(String authenticationStack, Subject subject) throws LoginException
      Construct a login context for an already configured authentication stack with the given name and a Subject object.
      Parameters:
      authenticationStack - - the name of the configuration for the authentication stack.
      subject - - the subject to authenticate. If null the authentication framework will use a new one.
      Returns:
      - an instance of LoginContext that can be used for authentication
      Throws:
      LoginException - - thrown in case the login context cannot be constructed, e.g. the authentication stack is unknown.
    • createLoginContext

      public static LoginContext createLoginContext(String authenticationStack, Subject subject, CallbackHandler callbackHandler) throws LoginException
      Construct a login context using the given authentication configuration and call-back handler.
      Parameters:
      authenticationStack - - the name of the authentication stack, used only for logging purposes
      subject - - the subject to authenticate. If null the authentication framework will use a new one.
      callbackHandler - - an instance of JAAS call-back handler for the use of the authentication process. It can be null in case the current thread of control processes a request with associated call-back hander.
      Returns:
      - an instance of LoginContext that can be used for authentication
      Throws:
      LoginException - - thrown in case the login context cannot be constructed, e.g. the authentication stack is unknown.
    • createLoginContext

      public static LoginContext createLoginContext(String authenticationStack, Subject subject, CallbackHandler callbackHandler, Configuration configuration) throws LoginException
      Construct a login context using the given authentication configuration and call-back handler.
      Parameters:
      authenticationStack - - the name of the authentication stack, used only for logging purposes
      subject - - the subject to authenticate. If null the authentication framework will use a new one.
      callbackHandler - - an instance of JAAS call-back handler for the use of the authentication process. It can be null in case the current thread of control processes a request with associated call-back hander.
      configuration - - the configuration of authentication stack to be used.
      Returns:
      - an instance of LoginContext that can be used for authentication
      Throws:
      LoginException - - thrown in case the login context cannot be constructed, e.g. the authentication stack is unknown.
    • getConfiguration

      public static Configuration getConfiguration() throws LoginException
      Returns the login configuration associated to the current request processing or the default installed configuration.
      Returns:
      - the login configuration
      Throws:
      LoginException - - thrown in case the configuration cannot be obtained