ENCRYPTBYPASSPHRASE (Transact-SQL)

Syntax

EncryptByPassPhrase ( { 'passphrase' | @passphrase } 
        , { 'cleartext' | @cleartext }
    [ , { add_authenticator | @add_authenticator }
        , { authenticator | @authenticator } ] )

Argumente

• passphrase
  Ein Pass-Ausdruck, von dem ein symmetrischer Schlüssel generiert wird.

• @passphrase
  Eine Variable vom Datentyp nvarchar, char, varchar, binary, varbinary, oder nchar, die einen Pass-Ausdruck enthält, aus dem ein symmetrischer Schlüssel generiert wird.

• cleartext
  Der zu verschlüsselnde Klartext.

• @cleartext
  Eine Variable vom Datentyp nvarchar, char, varchar, binary, varbinary oder nchar, die Klartext enthält. Die maximale Größe beträgt 8.000 Bytes.

• add_authenticator
  Gibt an, ob ein Authentifikator zusammen mit dem Klartext verschlüsselt werden soll. Mit dem Wert 1 wird ein Authentifikator hinzugefügt. int.

• @add_authenticator
  Gibt an, ob ein Hash zusammen mit dem Klartext verschlüsselt wird.

• authenticator
  Daten, von denen ein Authentifikator abgeleitet wird. sysname.

• @authenticator
  Eine Variable, die Daten enthält, von denen ein Authentifikator abgeleitet wird.

Rückgabetypen

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

Hinweise

Ein Pass-Ausdruck ist ein Kennwort, das Leerzeichen enthält. Die Verwendung eines Pass-Ausdrucks bietet den Vorteil, dass ein aussagekräftiger Ausdruck oder Satz leichter zu merken ist als eine vergleichsweise lange Zeichenfolge.

Die Kennwortkomplexität wird mit dieser Funktion nicht überprüft.

Beispiele

Im folgenden Beispiel wird ein Datensatz in der SalesCreditCard-Tabelle aktualisiert und der Wert der Kreditkartennummer, die in der CardNumber_EncryptedbyPassphrase-Spalte gespeichert ist, mithilfe des Primärschlüssels als Authentifikator verschlüsselt.

USE AdventureWorks;
GO
-- Create a column in which to store the encrypted data.
ALTER TABLE Sales.CreditCard 
    ADD CardNumber_EncryptedbyPassphrase varbinary(256); 
GO
-- First get the passphrase from the user.
DECLARE @PassphraseEnteredByUser nvarchar(128);
SET @PassphraseEnteredByUser 
    = 'A little learning is a dangerous thing!';

-- Update the record for the user's credit card.
-- In this case, the record is number 3681.
UPDATE Sales.CreditCard
SET CardNumber_EncryptedbyPassphrase = EncryptByPassPhrase(@PassphraseEnteredByUser
    , CardNumber, 1, CONVERT( varbinary, CreditCardID))
WHERE CreditCardID = '3681';
GO

Siehe auch

Verweis