CREATE CRYPTOGRAPHIC PROVIDER (Transact-SQL)

  • Article

Crée un fournisseur de services de chiffrement dans SQL Server à partir d'un fournisseur EKM (Extensible Key Management).

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

CREATE CRYPTOGRAPHIC PROVIDER provider_name 
    FROM FILE = path_of_DLL

Arguments

  • provider_name
    Nom du fournisseur EKM (Extensible Key Management)

  • path_of_DLL
    Chemin d'accès du fichier .dll qui implémente l'interface SQL Server EKM.

Notes

Toutes les clés créées par un fournisseur référenceront ce dernier par son GUID. Le GUID est conservé dans toutes les versions de la DLL.

La DLL qui implémente l'interface SQLEKM doit être signée numériquement à l'aide de n'importe quel certificat. SQL Server vérifiera la signature. La vérification inclut sa chaîne de certificats, dont la racine doit être installée à l'emplacement Trusted Root Cert Authorities sur un système Windows. Si la signature n'est pas vérifiée correctement, l'instruction CREATE CRYPTOGRAPHIC PROVIDER échoue. Pour plus d'informations sur les certificats et les chaînes de certificats, consultez Certificats et clés asymétriques SQL Server.

Lorsqu'une DLL de fournisseur EKM n'implémente pas toutes les méthodes nécessaires, CREATE CRYPTOGRAPHIC PROVIDER peut retourner l'erreur 33085 :

One or more methods cannot be found in cryptographic provider library '%.*ls'.

Lorsque le fichier d'en-tête utilisé pour créer la DLL de fournisseur EKM est obsolète, CREATE CRYPTOGRAPHIC PROVIDER peut retourner l'erreur 33032 :

SQL Crypto API version '%02d. %02d' implemented by provider is not supported. Supported version is '%02d. %02d'.

Autorisations

Requiert l'autorisation CONTROL SERVER ou l'appartenance au rôle serveur fixe sysadmin.

Exemples

L'exemple suivant crée un fournisseur de services de chiffrement appelé SecurityProvider dans SQL Server à partir d'un fichier .dll. Le fichier .dll est nommé c:\SecurityProvider\SecurityProvider_v1.dll et installé sur le serveur. Le certificat du fournisseur doit d'abord être installé sur le serveur.

-- Install the provider
CREATE CRYPTOGRAPHIC PROVIDER SecurityProvider
    FROM FILE = 'c:\SecurityProvider\SecurityProvider_v1.dll'

Voir aussi

Référence

ALTER CRYPTOGRAPHIC PROVIDER (Transact-SQL)

DROP CRYPTOGRAPHIC PROVIDER (Transact-SQL)

CREATE SYMMETRIC KEY (Transact-SQL)

Concepts

Gestion de clés extensible (EKM)