Zum Hauptinhalt springen

Schnellstart-Anleitung

Bringen Sie DuoKey SQL EKM zum Laufen und verschlüsseln Sie Ihre erste Datenbank

Gilt für:
SQL Server 2016+30-45 Min. EinrichtungAdministratorzugriff erforderlich

Überblick

Diese Schnellstart-Anleitung führt Sie durch die Verschlüsselung Ihrer ersten SQL Server-Datenbank mit DuoKey EKM. Am Ende verfügen Sie über:

DuoKey-App

SQL EKM-App, konfiguriert in der DuoKey-Plattform

EKM-Anbieter

Kryptografischer Anbieter, installiert auf dem SQL Server

Anmeldedaten

SQL Server, konfiguriert mit DuoKey-Authentifizierung

Verschlüsselte DB

Testdatenbank, verschlüsselt mit TDE

Voraussetzungen

Voraussetzungen

  • SQL Server 2016+ (Enterprise, Standard oder Developer Edition)
  • Windows Server 2012 R2+ oder Windows 10/11
  • Administratorzugriff auf den SQL Server-Rechner
  • DuoKey-Plattformkonto mit Berechtigungen zum Erstellen von Apps
  • Netzwerkzugriff auf DuoKey (HTTPS-Port 443)
  • SQL Server Management Studio (SSMS) installiert
Vorsicht
Die SQL Server Express Edition unterstützt keine erweiterbare Schlüsselverwaltung (Extensible Key Management). Überprüfen Sie Ihre SQL Server-Edition, bevor Sie fortfahren.

Phase 1: Einrichtung der DuoKey-Plattform

1

Einrichtung der DuoKey-Plattform

~5 Minuten
1

Bei der DuoKey-Plattform anmelden

Navigieren Sie zur DuoKey-Cloud-Plattform und melden Sie sich mit Ihren Anmeldedaten an.

2

SQL EKM-App erstellen

Gehen Sie zu Apps → Create New APP → Wählen Sie DuoKey for SQL → Klicken Sie auf Install Now

3

App konfigurieren

  • Geben Sie einen App-Namen ein (z. B. "Production-SQL-EKM")
  • Fügen Sie eine Beschreibung hinzu (optional)
  • Weisen Sie Rollen für die Zugriffssteuerung zu
  • Wählen oder erstellen Sie einen Vault für Ihre Schlüssel
4

Anmeldedaten speichern

Laden Sie die Setup-Datei herunter und notieren Sie sicher:

  • Client-ID - Eindeutige Kennung für die App
  • Client-Secret - Geheimer Schlüssel für die Authentifizierung
  • Passwort - Zusätzliches App-Passwort
Wichtig
Bewahren Sie Ihre Anmeldedaten sicher auf! Das Client-Secret und das Passwort können später nicht mehr aus der DuoKey-Plattform abgerufen werden. Sie benötigen sie für die SQL Server-Konfiguration.

Ausführliche Anleitung: SQL EKM-App erstellen

Phase 2: SQL Server-Installation

2

EKM-Anbieter installieren

~10 Minuten
1

Setup-Dateien extrahieren

Extrahieren Sie die heruntergeladene Setup-ZIP-Datei an einen temporären Speicherort.

2

Installationsprogramm ausführen

Klicken Sie mit der rechten Maustaste auf setup.exe → Run as Administrator

Hinweis
Windows zeigt möglicherweise einen Schutzdialog an. Klicken Sie auf "Weitere Informationen" und dann auf "Trotzdem ausführen".
3

Installationsassistenten abschließen

  • Akzeptieren Sie die Lizenzvereinbarung
  • Wählen Sie den Installationsordner (Standard empfohlen)
  • Wählen Sie die Protokollierungsstufe (Info für die Ersteinrichtung empfohlen)
  • Klicken Sie auf "Installieren" und warten Sie auf den Abschluss
4

Installation überprüfen

Bestätigen Sie, dass diese DLL-Dateien in C:\Windows\System32 vorhanden sind:

  • DuoKeyCryptoProvider.dll
  • libcurl.dll
  • zlib1.dll
  • fmt.dll
ÜberprüfungsabfrageSQL
-- Verify DLL is accessible by SQL Server
EXEC xp_fileexist 'C:\Windows\System32\DuoKeyCryptoProvider.dll';
GO

Ausführliche Anleitung: EKM-Anbieter installieren

Phase 3: SQL Server-Konfiguration

3

SQL Server konfigurieren

~10 Minuten

Öffnen Sie SQL Server Management Studio (SSMS), stellen Sie eine Verbindung zu Ihrer Instanz her und führen Sie das folgende Konfigurationsskript aus. Ersetzen Sie alle Platzhalter durch Ihre tatsächlichen Werte.

Vollständiges Konfigurationsskript

T-SQLPlatzhalter ersetzen
-- =============================================
-- DuoKey SQL EKM Configuration Script
-- Replace <placeholders> with your values
-- =============================================

-- Step 1: Enable EKM
sp_configure 'show advanced', 1;
GO
RECONFIGURE;
GO
sp_configure 'EKM provider enabled', 1;
GO
RECONFIGURE;
GO

-- Step 2: Create Cryptographic Provider
CREATE CRYPTOGRAPHIC PROVIDER DuoKeyProvider
FROM FILE = 'C:\Windows\System32\DuoKeyCryptoProvider.dll';
GO

-- Step 3: Create Credentials
-- Format: client_secret<!COCKPITPW!>password<!COCKPITPW!>CockpitIntrospectPwd
CREATE CREDENTIAL DuoKeyCredential
WITH IDENTITY = '<your_client_id>',
SECRET = '<your_client_secret><!COCKPITPW!><your_password><!COCKPITPW!>CockpitIntrospectPwd'
FOR CRYPTOGRAPHIC PROVIDER DuoKeyProvider;
GO

-- Step 4: Map Credential to Login
ALTER LOGIN [sa]
ADD CREDENTIAL DuoKeyCredential;
GO

-- Step 5: Create Asymmetric Key
USE master;
GO
CREATE ASYMMETRIC KEY SQL_EKM_Key
FROM PROVIDER DuoKeyProvider
WITH ALGORITHM = RSA_2048,
PROVIDER_KEY_NAME = 'SQL_EKM_Key',
CREATION_DISPOSITION = CREATE_NEW;
GO

-- Step 6: Create Key Credentials
CREATE CREDENTIAL SQL_EKM_Key_Cred
WITH IDENTITY = '<your_client_id>',
SECRET = '<your_client_secret><!COCKPITPW!><your_password><!COCKPITPW!>CockpitIntrospectPwd'
FOR CRYPTOGRAPHIC PROVIDER DuoKeyProvider;
GO

-- Step 7: Create Key Login
CREATE LOGIN SQL_EKM_Key_Login
FROM ASYMMETRIC KEY SQL_EKM_Key;
GO

ALTER LOGIN SQL_EKM_Key_Login
ADD CREDENTIAL SQL_EKM_Key_Cred;
GO

PRINT 'Configuration complete. Enable Encrypt operation in DuoKey Cockpit.';
GO
Verschlüsselungsvorgang aktivieren

Bevor Sie mit Phase 4 fortfahren, müssen Sie den Verschlüsselungsvorgang (Encrypt) in DuoKey aktivieren:

  1. Melden Sie sich beim DuoKey Cockpit an
  2. Navigieren Sie zu Keys → Suchen Sie nach SQL_EKM_Key
  3. Aktivieren Sie unter "Kryptografische Vorgänge" die Option Encrypt
  4. Änderungen speichern

Ausführliche Anleitung: SQL Server konfigurieren

Phase 4: Datenbankverschlüsselung

4

Verschlüsseln Sie Ihre erste Datenbank

~5 Minuten

Erstellen wir nun eine Testdatenbank und verschlüsseln sie mit TDE und DuoKey EKM.

Skript zur DatenbankverschlüsselungSQL
-- Create test database
CREATE DATABASE TestEncryptedDB;
GO

-- Create Database Encryption Key
USE TestEncryptedDB;
GO
CREATE DATABASE ENCRYPTION KEY
WITH ALGORITHM = AES_256
ENCRYPTION BY SERVER ASYMMETRIC KEY SQL_EKM_Key;
GO

-- Enable encryption
ALTER DATABASE TestEncryptedDB
SET ENCRYPTION ON;
GO

-- Verify encryption status
SELECT
    DB_NAME(database_id) AS [Database],
    CASE encryption_state
        WHEN 0 THEN 'No encryption key'
        WHEN 1 THEN 'Unencrypted'
        WHEN 2 THEN 'Encryption in progress'
        WHEN 3 THEN 'Encrypted'
        WHEN 4 THEN 'Key change in progress'
        WHEN 5 THEN 'Decryption in progress'
    END AS [Status],
    percent_complete AS [Progress %]
FROM sys.dm_database_encryption_keys
WHERE DB_NAME(database_id) = 'TestEncryptedDB';
GO
Tipp
Der Verschlüsselungsstatus 3 bedeutet, dass die Datenbank vollständig verschlüsselt ist. Der Status 2 bedeutet, dass die Verschlüsselung noch läuft - warten Sie auf deren Abschluss, bevor Sie fortfahren.

Ausführliche Anleitung: Datenbankverschlüsselung

Überprüfung

Führen Sie diese Abfragen aus, um zu überprüfen, ob Ihre vollständige Einrichtung korrekt funktioniert:

ÜberprüfungsabfragenSQL
-- 1. EKM Provider Status
SELECT name, guid, version
FROM sys.cryptographic_providers;
GO

-- 2. Credentials Created
SELECT name, credential_identity, create_date
FROM sys.credentials
WHERE name LIKE '%DuoKey%' OR name LIKE '%EKM%';
GO

-- 3. Asymmetric Keys
SELECT name, algorithm_desc, key_length, thumbprint
FROM sys.asymmetric_keys;
GO

-- 4. Encrypted Databases
SELECT
    d.name AS DatabaseName,
    d.is_encrypted,
    dek.encryption_state
FROM sys.databases d
LEFT JOIN sys.dm_database_encryption_keys dek
    ON d.database_id = dek.database_id
WHERE d.is_encrypted = 1;
GO

Überprüfungs-Checkliste

EKM-AnbieterDuoKeyProvider sichtbar in sys.cryptographic_providers
AnmeldedatenDuoKeyCredential und SQL_EKM_Key_Cred erstellt
Asymmetrischer SchlüsselSQL_EKM_Key mit RSA_2048-Algorithmus
Datenbank verschlüsseltTestEncryptedDB mit encryption_state = 3

Kurzreferenz zur Fehlerbehebung

Häufige Probleme und Lösungen

ProblemUrsacheLösung
EKM nicht aktiviertSQL Server-Edition oder -KonfigurationÜberprüfen Sie die Edition; führen Sie sp_configure-Befehle aus
Anbieter kann nicht erstellt werdenDLL nicht gefundenÜberprüfen Sie DuoKeyCryptoProvider.dll in System32
Formatfehler bei den AnmeldedatenUngültiges SECRET-FormatÜberprüfen Sie die <!COCKPITPW!>-Trennzeichen
Schlüsselerstellung schlägt fehlEncrypt nicht aktiviertAktivieren Sie den Verschlüsselungsvorgang im DuoKey Cockpit
VerbindungszeitüberschreitungNetzwerkproblemÜberprüfen Sie den HTTPS-443-Zugriff auf die DuoKey-Plattform

Vollständige Anleitung zur Fehlerbehebung

Nächste Schritte

Herzlichen Glückwunsch! Sie haben DuoKey SQL EKM erfolgreich eingerichtet und Ihre erste Datenbank verschlüsselt. Hier erfahren Sie, was Sie als Nächstes erkunden können: