Teilen über

DECRYPTBYKEYAUTOASYMKEY (Transact-SQL)

Gilt für:SQL ServerAzure SQL Managed Instance

Diese Funktion entschlüsselt verschlüsselte Daten. Zunächst entschlüsselt er einen symmetrischen Schlüssel mit einem separaten asymmetrischen Schlüssel und entschlüsselt dann die verschlüsselten Daten mit dem symmetrischen Schlüssel, der im ersten Schritt extrahiert wurde.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

akey_ID

Die ID des asymmetrischen Schlüssels, der für die Entschlüsselung des symmetrischen Schlüssels verwendet wird. akey_ID verfügt über einen int-Datentyp.

akey_password

Das Kennwort, mit dem der asymmetrische Schlüssel geschützt wird. akey_password können einen NULL Wert aufweisen, wenn der Datenbankmasterschlüssel (DMK) den asymmetrischen privaten Schlüssel schützt. akey_password verfügt über einen nvarchar-Datentyp.

ciphertext

Die mit dem Schlüssel verschlüsselten Daten. ciphertext verfügt über einen varbinary-Datentyp.

@ciphertext

Eine Variable vom Typ varbinary, die Daten enthält, die mit dem symmetrischen Schlüssel verschlüsselt wurden.

add_authenticator

Gibt an, ob durch den ursprünglichen Verschlüsselungsprozess ein Authentifikator zusammen mit dem Klartext einbezogen und verschlüsselt wurde. Muss dem wert entsprechen, der während des Datenverschlüsselungsprozesses an ENCRYPTBYKEY übergeben wird. add_authenticator weist den Wert 1 auf, wenn im Verschlüsselungsprozess ein Authentifikator verwendet wurde. add_authenticator verfügt über einen int-Datentyp.

@add_authenticator

Eine Variable, die angibt, ob durch den ursprünglichen Verschlüsselungsprozess ein Authentifikator zusammen mit dem Klartext einbezogen, und verschlüsselt, wurde. Muss dem wert entsprechen, der während des Datenverschlüsselungsprozesses an ENCRYPTBYKEY übergeben wird. @add_authenticator weist den Datentyp int auf.

authenticator

Die Daten, die als Grundlage für die Generierung des Authentifikators verwendet werden. Muss mit dem wert übereinstimmen, der für ENCRYPTBYKEY bereitgestellt wird. authenticator verfügt über einen sysname-Datentyp.

@authenticator

Eine Variable, die Daten für die Generierung durch den Authentifikator enthält. Muss mit dem wert übereinstimmen, der für ENCRYPTBYKEY bereitgestellt wird. @authenticator weist den Datentyp sysname auf.

@add_authenticator

Eine Variable, die angibt, ob durch den ursprünglichen Verschlüsselungsprozess ein Authentifikator zusammen mit dem Klartext einbezogen, und verschlüsselt, wurde. Muss dem wert entsprechen, der während des Datenverschlüsselungsprozesses an ENCRYPTBYKEY übergeben wird. @add_authenticator weist den Datentyp int auf.

authenticator

Die Daten, die als Grundlage für die Generierung des Authentifikators verwendet werden. Muss mit dem wert übereinstimmen, der für ENCRYPTBYKEY bereitgestellt wird. authenticator verfügt über einen sysname-Datentyp.

@authenticator

Eine Variable, die Daten für die Generierung durch den Authentifikator enthält. Muss mit dem wert übereinstimmen, der für ENCRYPTBYKEY bereitgestellt wird. @authenticator weist den Datentyp sysname auf.

Rückgabetypen

varbinary mit einer maximalen Größe von 8.000 Byte.

Bemerkungen

DECRYPTBYKEYAUTOASYMKEY kombiniert die Funktionen von OPEN SYMMETRIC KEY und DECRYPTBYKEY. In einem einzelnen Vorgang wird zunächst ein symmetrischer Schlüssel entschlüsselt, und mit diesem Schlüssel wird dann der verschlüsselte Chiffretext entschlüsselt.

Berechtigungen

Erfordert die VIEW DEFINITION-Berechtigung für den symmetrischen Schlüssel und die CONTROL-Berechtigung für den asymmetrischen Schlüssel.

Beispiele

In diesem Beispiel wird dargestellt, wie DECRYPTBYKEYAUTOASYMKEY den Entschlüsselungscode vereinfachen kann. Dieser Code sollte auf einer AdventureWorks2025 Datenbank ausgeführt werden, für die noch kein DMK vorhanden ist. Ersetzen Sie <password> es durch ein sicheres Kennwort.

--Create the keys and certificate.
USE AdventureWorks2022;

CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<password>';
OPEN MASTER KEY DECRYPTION BY PASSWORD = '<password>';

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

Verwandte Inhalte

  • Last updated on