所有已知实现类：

JndiLoginModule ， KeyStoreLoginModule ， Krb5LoginModule ， LdapLoginModule ， NTLoginModule ， UnixLoginModule
```
public interface LoginModule
```
身份验证技术提供商的服务提供商界面。 LoginModule插入应用程序下以提供特定类型的身份验证。

当应用程序写入LoginContext API时，身份验证技术提供程序会实现LoginModule接口。 A Configuration指定要与特定登录应用程序一起使用的LoginModule。因此，可以在应用程序下插入不同的LoginModule，而无需对应用程序本身进行任何修改。

LoginContext负责读取Configuration并实例化相应的LoginModule。每个LoginModule初始化为Subject ，一个CallbackHandler ，共享LoginModule状态，并且特定LoginModule的选项。 Subject表示当前正在进行身份验证的Subject ，如果身份验证成功，则会使用相关凭据进行更新。 LoginModules使用CallbackHandler与用户进行通信。例如， CallbackHandler可用于提示用户名和密码。请注意， CallbackHandler可能为null。 LoginModules绝对需要CallbackHandler来验证Subject可能会抛出LoginException 。 LoginModules可选择使用共享状态来相互共享信息或数据。

LoginModule特定选项表示管理员或用户在登录Configuration为此LoginModule配置的选项。这些选项由LoginModule本身定义，并控制其中的行为。例如， LoginModule可以定义支持调试/测试功能的选项。使用键值语法定义选项，例如debug = true 。 LoginModule将选项存储为Map以便可以使用密钥检索值。请注意， LoginModule选择定义的选项数量没有限制。

调用应用程序将身份验证过程视为单个操作。但是， LoginModule的身份验证过程LoginModule两个不同的阶段。在第一个阶段，LoginModule的login方法得到由LoginContext的调用login方法。该login的方法LoginModule然后执行实际的身份验证（提示和验证例如密码），并保存为私有状态信息其认证状态。完成后，LoginModule的login方法返回true （如果成功）或false （如果应该忽略），或者抛出LoginException指定失败。在失败的情况下， LoginModule不得重试身份验证或引入延迟。此类任务的责任属于该应用程序。如果应用程序尝试重试身份验证，则将再次调用LoginModule的login方法。

在第二阶段，如果LoginContext的整体认证成功（相关的REQUIRED，REQUISITE，SUFFICIENT和OPTIONAL LoginModules成功），则调用LoginModule的commit方法。用于LoginModule的commit方法检查其私有保存状态以查看其自身的身份验证是否成功。如果整体LoginContext身份验证成功并且LoginModule自己的身份验证成功，则commit方法将相关主体（经过身份验证的身份）和凭据（身份验证数据，如加密密钥）与位于Subject内的LoginModule 。

如果LoginContext的整体身份验证失败（相关的REQUIRED，REQUISITE，SUFFICIENT和OPTIONAL LoginModule未成功），则会调用每个LoginModule的abort方法。在这种情况下， LoginModule会删除/销毁最初保存的任何身份验证状态。

注销Subject只涉及一个阶段。 LoginContext调用LoginModule的logout方法。该logout的方法LoginModule然后执行退出过程，诸如从除去校长或凭证Subject或记录会话信息。

LoginModule实现必须具有不带参数的构造函数。这允许加载LoginModule类实例化它。

从以下版本开始：

1.4

另请参见：

LoginContext ， Configuration

方法摘要

所有方法实例方法抽象方法
变量和类型	方法	描述
`boolean`	`abort()`	中止身份验证过程的方法（阶段2）。
`boolean`	`commit()`	提交认证过程的方法（阶段2）。
`void`	`initialize(Subject subject, CallbackHandler callbackHandler, Map<String,?> sharedState, Map<String,?> options)`	初始化此LoginModule。
`boolean`	`login()`	验证 `Subject`方法（阶段1）。
`boolean`	`logout()`	注销 `Subject` 。

- 方法详细信息
  - initialize
```
void initialize(Subject subject,
                CallbackHandler callbackHandler,
                Map<String,?> sharedState,
                Map<String,?> options)
```
    初始化此LoginModule。
    此方法由被叫LoginContext这之后LoginModule已经被实例化。此方法的目的是使用相关信息初始化此LoginModule 。如果此LoginModule不了解存储在sharedState或options参数中的任何数据，则可以忽略它们。
    
    参数
    
    subject - 要经过身份验证的 Subject 。
    
    callbackHandler - 用于与最终用户通信的 CallbackHandler （例如，提示输入用户名和密码）。
    
    sharedState - 与其他已配置的LoginModule共享状态。
    
    options - 为此特定 LoginModule登录 Configuration指定的选项。
  - login
```
boolean login()
       throws LoginException
```
    验证Subject方法（阶段1）。
    此方法的实现验证Subject 。例如，它可能会提示输入用户名和密码等Subject信息，然后尝试验证密码。此方法将身份验证尝试的结果保存为LoginModule中的私有状态。
    
    结果
    
    如果验证成功， LoginModule true;如果应忽略此 LoginModule false。
    
    异常
    
    LoginException - 如果身份验证失败
  - commit
```
boolean commit()
        throws LoginException
```
    提交认证过程的方法（阶段2）。
    如果LoginContext的整体身份验证成功（相关的REQUIRED，REQUISITE，SUFFICIENT和OPTIONAL LoginModules成功），则调用此方法。
    
    如果此LoginModule自己的身份验证尝试成功（通过检索login方法保存的私有状态进行检查），则此方法将相关的Principal和Credentials与位于Subject中的LoginModule 。如果此LoginModule自己的身份验证尝试失败，则此方法将删除/销毁最初保存的任何状态。
    
    结果
    
    如果此方法成功，则 LoginModule true;如果应忽略此 LoginModule ，则 LoginModule false。
    
    异常
    
    LoginException - 如果提交失败
  - abort
```
boolean abort()
       throws LoginException
```
    中止身份验证过程的方法（阶段2）。
    如果LoginContext的整体身份验证失败，则调用此方法。（相关的必需，要求，充足和可选的LoginModule没有成功）。
    
    如果此LoginModule自己的身份验证尝试成功（通过检索login方法保存的私有状态进行检查），则此方法将清除最初保存的任何状态。
    
    结果
    
    如果此方法成功，则 LoginModule true;如果应忽略此 LoginModule ，则 LoginModule false。
    
    异常
    
    LoginException - 如果中止失败
  - logout
```
boolean logout()
        throws LoginException
```
    注销Subject 。
    此方法的实现可能会删除/销毁Subject的Principals和Credentials。
    
    结果
    
    如果此方法成功，则 LoginModule true;如果应忽略此 LoginModule ，则 LoginModule false。
    
    异常
    
    LoginException - 如果注销失败

Interface LoginModule

方法摘要

方法详细信息

initialize

login

commit

abort

logout