DECRYPTBYKEYAUTOASYMKEY (Transact-SQL)

语法

DecryptByKeyAutoAsymKey ( akey_ID , akey_password 
        , { 'ciphertext' | @ciphertext }
    [ , { add_authenticator | @add_authenticator } 
    [ , { authenticator | @authenticator } ] ] )

参数

• akey_ID
  用于保护对称密钥的非对称密钥的 ID。akey_ID 的数据类型为 int。

• akey_password
  用于保护非对称密钥私钥的密码。如果私钥受数据库主密钥保护，则该值可以是 NULL。akey_password 的数据类型为 varchar。

• 'ciphertext'
  它是使用密钥进行加密的数据。ciphertext 的数据类型为 varbinary。

• @ciphertext
  包含已使用密钥进行加密的数据的 varbinary 类型变量。

• add_authenticator
  指示是否与明文一起加密验证器。对数据进行加密时，该值必须与传递给 EncryptByKey 的值相同。如果使用了验证器，则为 1。add_authenticator 的数据类型为 int。

• @add_authenticator
  指示是否与明文一起加密验证器。对数据进行加密时，该值必须与传递给 EncryptByKey 的值相同。

• authenticator
  从中生成验证器的数据。必须与提供给 EncryptByKey 的值相匹配。authenticator 的数据类型为 sysname。

• @authenticator
  包含用于生成验证器的数据的变量。必须与提供给 EncryptByKey 的值相匹配。

返回类型

最大大小为 8,000 个字节的 varbinary。

注释

DecryptByKeyAutoAsymKey 组合了 OPEN SYMMETRIC KEY 和 DecryptByKey 的功能。在单个操作中，它可以解密对称密钥，并使用该密钥解密密码文本。

权限

需要对对称密钥拥有 VIEW DEFINITION 权限以及对非对称密钥拥有 CONTROL 权限。

示例

以下示例显示如何用 DecryptByKeyAutoAsymKey 来简化执行解密的代码。应当对新安装的 AdventureWorks 数据库副本运行此代码。

--Create the keys and certificate.
USE AdventureWorks;
CREATE MASTER KEY ENCRYPTION BY PASSWORD = 'mzkvdMlk979438teag$$ds987yghn)(*&4fdg^';
OPEN MASTER KEY DECRYPTION BY PASSWORD = 'mzkvdMlk979438teag$$ds987yghn)(*&4fdg^';
CREATE ASYMMETRIC KEY SSN_AKey 
    WITH ALGORITHM = RSA_2048 ; 
GO
CREATE SYMMETRIC KEY SSN_Key_02 WITH ALGORITHM = DES
    ENCRYPTION BY ASYMMETRIC KEY SSN_AKey;
GO
--
--Add a column of encrypted data.
ALTER TABLE HumanResources.Employee
    ADD EncryptedNationalIDNumber2 varbinary(128); 
OPEN SYMMETRIC KEY SSN_Key_02
   DECRYPTION BY ASYMMETRIC KEY SSN_AKey;
UPDATE HumanResources.Employee
SET EncryptedNationalIDNumber2
    = EncryptByKey(Key_GUID('SSN_Key_02'), NationalIDNumber);
GO
--Close the key used to encrypt the data.
CLOSE SYMMETRIC KEY SSN_Key_02;
--
--There are two ways to decrypt the stored data.
--
--OPTION ONE, using DecryptByKey()
--1. Open the symmetric key.
--2. Decrypt the data.
--3. Close the symmetric key.
OPEN SYMMETRIC KEY SSN_Key_02
   DECRYPTION BY ASYMMETRIC KEY SSN_AKey;
SELECT NationalIDNumber, EncryptedNationalIDNumber2  
    AS 'Encrypted ID Number',
    CONVERT(nvarchar, DecryptByKey(EncryptedNationalIDNumber2)) 
    AS 'Decrypted ID Number'
    FROM HumanResources.Employee;
CLOSE SYMMETRIC KEY SSN_Key_02;
--
--OPTION TWO, using DecryptByKeyAutoAsymKey()
SELECT NationalIDNumber, EncryptedNationalIDNumber2 
    AS 'Encrypted ID Number',
    CONVERT(nvarchar, DecryptByKeyAutoAsymKey ( AsymKey_ID('SSN_AKey') , NULL ,EncryptedNationalIDNumber2)) 
    AS 'Decrypted ID Number'
    FROM HumanResources.Employee;
GO

请参阅

参考