模块 java.security.sasl

Package javax.security.sasl

包含支持SASL的类和接口。 该包定义了SASL机制的类和接口。 开发人员使用它为使用SASL的基于连接的协议添加身份验证支持。

SASL概述

简单认证和安全层（SASL）指定质询 - 响应协议，其中在客户端和服务器之间交换数据以用于认证和（可选）建立用于进行后续通信的安全层。 它与基于连接的协议（如LDAPv3或IMAPv4）一起使用。 SASL描述于RFC 2222中 。 为SASL定义了各种机制 。 每种机制都定义了必须在客户端和服务器之间交换的数据，以便验证成功。 特定机制所需的这种数据交换称为其协议简档 。 以下是Internet标准社区定义的一些机制示例。

• DIGEST-MD5（ RFC 2831 ）。 此机制定义了HTTP摘要式身份验证如何用作SASL机制。
• 匿名（ RFC 2245 ）。 此机制是匿名身份验证，其中不需要凭据。
• 外部（ RFC 2222 ）。 此机制从外部源（例如TLS或IPsec）获取身份验证信息。
• S / Key（ RFC 2222 ）。 此机制使用MD4摘要算法基于共享密钥交换数据。
• GSSAPI（ RFC 2222 ）。 此机制使用GSSAPI获取身份验证信息。

这些机制中的一些提供安全层的认证和建立，其他仅提供认证。 匿名和S / Key不提供任何安全层。 GSSAPI和DIGEST-MD5允许协商安全层。 对于External，安全层由外部协议确定。

用法

此API的用户通常是为基于连接的协议（如LDAPv3和IMAPv4）以及编写服务器的开发人员（如LDAP服务器和IMAP服务器）生成客户端库实现的开发人员。 编写客户端库的开发人员使用SaslClient和SaslClientFactory接口。 编写服务器的开发人员使用SaslServer和SaslServerFactory接口。 在这两组用户中，每组用户可以进一步分为两组： 生成 SASL机制的用户和使用 SASL机制的用户。 SASL机制的生产者需要为这些接口提供实现，而SASL机制的用户使用此包中的API来访问这些实现。

相关文档

有关如何使用此API的信息，请参阅Java SASL Programming Guide 。

从以下版本开始：

1.5

接口摘要

接口	描述
SaslClient	作为客户端执行SASL身份验证。
SaslClientFactory	用于创建 SaslClient实例的 SaslClient 。
SaslServer	执行SASL身份验证作为服务器。
SaslServerFactory	用于创建 SaslServer实例的 SaslServer 。

类摘要

类	描述
AuthorizeCallback	SaslServer使用此回调来确定一个实体（由经过身份验证的身份验证ID标识）是否可以代表另一个实体（由授权ID标识）。
RealmCallback	SaslClient和 SaslServer使用此回调来检索领域信息。
RealmChoiceCallback	SaslClient和 SaslServer使用此回调来获取领域选项列表。
Sasl	用于创建SASL客户端和服务器的静态类。

异常摘要

异常	描述
AuthenticationException	SASL机制实现抛出此异常，以指示SASL交换由于与身份验证相关的原因（例如无效的身份，密码或密钥）而失败。
SaslException	此类表示使用SASL时发生的错误。