模块  java.base
软件包  javax.crypto.spec

Class GCMParameterSpec

  • 实现的所有接口
    AlgorithmParameterSpec 
    public class GCMParameterSpec
extends Object
implements AlgorithmParameterSpec
    使用伽罗瓦/计数器模式（GCM）模式指定Cipher所需的参数集。

    简单的块密码模式（例如CBC）通常只需要初始化向量（例如IvParameterSpec ），但GCM需要以下参数：

    • IV ：初始化向量（IV）
    • tLen ：认证标签T的长度（以位为单位）

    除了此处描述的参数之外，还可以在Cipher类中处理其他GCM输入/输出（附加认证数据（AAD），密钥，分组密码，普通/密文和认证标记）。

    请参阅RFC 5116有关认证加密相关联的数据（AEAD）算法，和更多的信息NIST Special Publication 800-38D ，“NIST建议操作的分组密码模式：伽罗瓦/计数器模式（GCM）和GMAC。”

    GCM规范声明tLen对于某些应用程序可能仅具有值{ tLen }或{ tLen }。 可以为此类指定其他值，但并非所有CSP实现都支持它们。

    从以下版本开始：
    1.7
    另请参见：
    Cipher

    • 构造方法详细信息

      • GCMParameterSpec

        public GCMParameterSpec​(int tLen,
                        byte[] src)
        使用指定的身份验证标记位长度和IV缓冲区构造GCMParameterSpec。
        参数
        tLen - 身份验证标记长度（以位为单位）
        src - IV源缓冲区。 复制缓冲区的内容以防止后续修改。
        异常
        IllegalArgumentException - 如果 tLen为负数，或者 src为空。

      • GCMParameterSpec

        public GCMParameterSpec​(int tLen,
                        byte[] src,
                        int offset,
                        int len)
        使用指定的身份验证标记位长度和指定缓冲区的子集构造GCMParameterSpec对象作为IV。
        参数
        tLen - 身份验证标记长度（以位为单位）
        src - IV源缓冲区。 复制缓冲区的内容以防止后续修改。
        offset - IV开始的 src中的偏移量
        len - IV字节数
        异常
        IllegalArgumentException - 如果 tLen为负，则 src为空， len或 offset为负，或者 offset和 len的总和大于 src字节数组的长度。

    • 方法详细信息

      • getTLen

        public int getTLen()
        返回身份验证标记长度。
        结果
        认证标签长度（以位为单位）

      • getIV

        public byte[] getIV()
        返回初始化向量（IV）。
        结果
        四。 每次调用此方法时都会创建一个新数组。