Changes for page sql-tde
Last modified by Nikhil Singh on 2026/07/03 08:32
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 1 added, 0 removed)
-
Objects (0 modified, 1 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,267 +1,317 @@ 1 -= TDE( 1) =1 += **1. Steps for Implementing Transparent Data Encryption (TDE) FROM SQL Server** = 2 2 3 -1 CREATE MASTER KEY ENCRYPTION BY PASSWORD = 'YourStrongPasswordHere!'; 4 -GO 5 5 6 -CREATE CERTIFICATE TDE_Certificate 7 -WITH SUBJECT = 'TDE Certificate'; 8 -GO 4 +This document outlines the process of **encrypting SQL Server databases** using **Transparent Data Encryption (TDE)** and backing them up to **Azure Storage**. TDE ensures data at rest is encrypted, leveraging a **Master Key (MK)**, **TDE Certificate**, and **Database Encryption Key (DEK)** for encryption. 9 9 10 -2 USE master; 11 -GO 6 +The process also includes creating a **credential** for secure backup to **Azure Blob Storage**, providing a scalable and secure solution for storing encrypted databases in the cloud. 12 12 13 -SELECT 14 - cert.name AS Certificate_Name, 15 - cert.subject AS Certificate_Subject, 16 - cert.issuer_name AS Issuer_Name, 17 - cert.pvt_key_encryption_type AS Private_Key_Encryption_Type 18 -FROM 19 - sys.certificates cert 20 -WHERE 21 - cert.name LIKE 'TDE%'; 22 22 9 +[[image:image-20250305152543-1.png]] 23 23 24 -3 BACKUP CERTIFICATE TDE_Certificate 25 -TO FILE = https://zagpebslab.blob.core.windows.net/sql-backups?sp=racwl&st=2025-02-25T13:28:42Z&se=2026-02-25T21:28:42Z&spr=https&sv=2022-11-02&sr=c&sig=eQKxB%2F0bg5cX71PmhUTlGHLCnIwSbe5CLOWVVkaDR1g%3D\TDE_Certificate.cer' 26 -WITH PRIVATE KEY ( 27 - FILE = https://zagpebslab.blob.core.windows.net/sql-backups?sp=racwl&st=2025-02-25T13:28:42Z&se=2026-02-25T21:28:42Z&spr=https&sv=2022-11-02&sr=c&sig=eQKxB%2F0bg5cX71PmhUTlGHLCnIwSbe5CLOWVVkaDR1g%3D\TDE_PrivateKey.pvk', 28 - ENCRYPTION BY PASSWORD = 'AnotherStrongPasswordHere!' 29 -); 30 -GO 31 31 12 +**~1. Create a Master Key in the master Database** 13 +The first step is to create a **Master Key** in the master database. This key will be used to encrypt other cryptographic objects, such as certificates and symmetric keys, within SQL Server. 32 32 33 -USE Normal; 34 -GO 35 35 36 --- 6. Create a Database Encryption Key (DEK) and encrypt it with the TDE certificate 37 -CREATE DATABASE ENCRYPTION KEY 38 -WITH ALGORITHM = AES_256 39 -ENCRYPTION BY SERVER CERTIFICATE TDE_Certificate; 40 -GO 16 +**2. Create a TDE Certificate (Encrypted by the Master Key)** 17 +Next, generate a **TDE certificate** that will be used to encrypt the **Database Encryption Key (DEK)**. This certificate is encrypted by the **Master Key** created in step 1, providing an additional layer of security. 41 41 42 -USE [dba] 43 -GO 44 44 45 -CREATE DATABASE ENCRYPTION KEY 46 -WITH ALGORITHM = AES_256 47 -ENCRYPTION BY SERVER CERTIFICATE TDE_Certificate; 48 -GO 20 +**3. Choose the Database to Create the Database Encryption Key (DEK)** 21 +For the selected database, create the **Database Encryption Key (DEK)**. The DEK will be encrypted by the **TDE certificate** and will use the **AES-256 encryption algorithm** to ensure data is securely encrypted at rest. 49 49 50 50 51 - USE[dba1]52 - GO24 +**4. Enable Encryption for the Database** 25 +Once the **DEK** has been created, enable **TDE** for the database. This ensures that all data written to the database is automatically encrypted at rest, providing full protection for sensitive information. 53 53 54 -CREATE DATABASE ENCRYPTION KEY 55 -WITH ALGORITHM = AES_256 56 -ENCRYPTION BY SERVER CERTIFICATE TDE_Certificate; 57 -GO 58 58 28 +**5. Create a Credential with a SAS Token** 29 +Finally, create a **credential** that allows SQL Server to access Azure Blob Storage. This credential is created using a **Shared Access Signature (SAS) token**, which ensures secure and authenticated access to the storage account for backup purposes. 59 59 60 -USE [dba2] 31 +{{code language="sql"}} 32 +drop credential [https://zagpebslab.blob.core.windows.net/sql-backups] 33 +CREATE CREDENTIAL [https://zagpebslab.blob.core.windows.net/sql-backups] 34 +WITH IDENTITY='SHARED ACCESS SIGNATURE' 35 +, SECRET = 'sp=racwdli&st=2025-02-25T13:28:42Z&se=2026-02-25T21:28:42Z&spr=https&sv=2022-11-02&sr=c&sig=kBFwlj5S5eqBEE32LM1EFebBY0W94uEFiwOXo3R0yt4%3D' 61 61 GO 37 + 38 +{{/code}} 62 62 63 -CREATE DATABASE ENCRYPTION KEY 64 -WITH ALGORITHM = AES_256 65 -ENCRYPTION BY SERVER CERTIFICATE TDE_Certificate; 66 -GO 67 67 41 +**~ 6. Use a Stored Procedure to Back Up to Azure Storage Account** 68 68 69 -USE [dba3] 70 -GO 43 +{{code language="sql"}} 44 +EXECUTE dba.dbo.DatabaseBackup 45 +@Databases = 'dba', 46 +@URL = 'https://zagpebslab.blob.core.windows.net/sql-backups', 47 +@BackupType = 'Full', 48 +@CopyOnly = 'Y', 49 +@Compress = 'Y', 50 +@Verify = 'N' 51 +{{/code}} 71 71 72 -CREATE DATABASE ENCRYPTION KEY 73 -WITH ALGORITHM = AES_256 74 -ENCRYPTION BY SERVER CERTIFICATE TDE_Certificate; 75 -GO 53 +=== === 76 76 77 -USE [xwiki] 78 -GO 55 +=== Conclusion: Backup to Azure Storage Account with TDE Encrypted Databases === 79 79 80 -CREATE DATABASE ENCRYPTION KEY 81 -WITH ALGORITHM = AES_256 82 -ENCRYPTION BY SERVER CERTIFICATE TDE_Certificate; 83 -GO 57 +The attempt to back up an **encrypted database** (with Transparent Data Encryption - TDE) from **SQL Server Management Studio (SSMS)** to an Azure Storage Account was unsuccessful. This issue arises because **Azure does not permit TDE-encrypted databases to be backed up directly to Azure Storage using SSMS**. 84 84 59 +However, after decrypting the database, we were able to successfully back it up to the Azure Storage Account via SSMS. This confirms that **backups can be performed on an unencrypted database**, but **not on an encrypted database**. 85 85 86 --- 7. Enable Transparent Data Encryption (TDE) on the database 87 -ALTER DATABASE dba 88 -SET ENCRYPTION ON; 89 -GO 90 90 91 91 92 -select name, database_id, state_desc 93 -from sys.databases 94 94 95 95 96 -SELECT 97 - database_id, 98 - key_algorithm, 99 - key_length, 100 - encryption_state_desc 101 - encryptor_type 65 += **2. Enabling Transparent Data Encryption (TDE) Using Azure Key Vault** = 102 102 103 -FROM 104 - sys.dm_database_encryption_keys; 105 105 68 +**Introduction:** This document outlines the process of enabling **Transparent Data Encryption (TDE)** on an **Azure SQL Managed Instance (SQL MI)** using a **Customer-Managed Key (CMK)** stored in **Azure Key Vault**. The encryption is managed using an asymmetric key from **Azure Key Vault**, ensuring that all data within the SQL Managed Instance is encrypted using a strong encryption algorithm. 106 106 107 - Select * from sys.dm_database_encryption_keys 108 108 71 +===== **1. Generate a Key in Azure Key Vault** ===== 109 109 110 - BACKUP DATABASE [dba2] 111 -TO URL = 'https://zagpebslab.blob.core.windows.net/sql-backups?sp=racwl&st=2025-02-25T13:28:42Z&se=2026-02-25T21:28:42Z&spr=https&sv=2022-11-02&sr=c&sig=eQKxB%2F0bg5cX71PmhUTlGHLCnIwSbe5CLOWVVkaDR1g%3D' 112 -With copy_only 113 -GO 114 114 74 +**- Navigate to Azure Key Vault:** 115 115 116 -BACKUP DATABASE [dba2] 117 -TO URL = 'https://zagpebslab.blob.core.windows.net/sql-backups?sp=racwl&st=2025-02-25T13:28:42Z&se=2026-02-25T21:28:42Z&spr=https&sv=2022-11-02&sr=c&sig=eQKxB%2F0bg5cX71PmhUTlGHLCnIwSbe5CLOWVVkaDR1g%3D', 118 - 119 - COPY_ONLY, -- Ensures the backup does not affect the regular backup chain 120 - COMPRESSION, -- Optional: Compresses the backup to save storage space 121 - STATS = 10 -- Optional: Provides backup progress status 122 -GO 76 +* Go to the **Azure Portal** and select **Key Vault** (DemoRudiTest). 123 123 78 +**- Generate a New Key:** 124 124 80 +* Go to the **Keys** section and click **Generate** to create a new key. 125 125 126 --- Step 1: Drop the existing credential (if needed) 127 -DROP CREDENTIAL [https://zagpebslab.blob.core.windows.net/sql-backups]; 128 -GO 82 +**- Configure Key Settings:** 129 129 130 --- Step 2: Create a new credential with the SAS token 131 -CREATE CREDENTIAL [https://zagpebslab.blob.core.windows.net/sql-backups] 132 -WITH IDENTITY = 'SHARED ACCESS SIGNATURE', 133 -SECRET = 'sp=racwdli&st=2025-02-25T13:28:42Z&se=2026-02-25T21:28:42Z&spr=https&sv=2022-11-02&sr=c&sig=kBFwlj5S5eqBEE32LM1EFebBY0W94uEFiwOXo3R0yt4%3D'; 134 -GO 84 +* **Name the Key**: Choose a name for your key, e.g., mysqlmikey. 85 +* **Key Type**: Select **RSA** as the key type. 86 +* **RSA Key Size**: Choose an **RSA key size** of **2048-bit**. (optional) 135 135 136 --- Step 3: Perform the database backup with the provided parameters 137 -EXECUTE dba.dbo.DatabaseBackup 138 - @Databases = 'dba', -- Replace with your database name 139 - @URL = 'https://zagpebslab.blob.core.windows.net/sql-backups', -- Azure Blob Storage URL 140 - @BackupType = 'Full', -- Full backup 141 - @CopyOnly = 'Y', -- Copy-only backup to avoid breaking backup chain 142 - @Compress = 'Y', -- Compress the backup 143 - @Verify = 'N'; -- No verification of backup 144 -GO 88 + Note: 145 145 90 +* switching from 2048-bit RSA to 4096-bit RSA for TDE will affect performance, but the actual impact might be minor, especially on modern hardware and typical workloads. 91 +* **It will likely affect CPU usage** more than disk I/O, and the impact might be more noticeable during key management operations (key generation, encryption, etc.). 92 +* If your database is not under heavy load and your hardware can handle the extra processing, the trade-off for better security may be worth it. 146 146 94 +**- Create the Key:** 147 147 96 +* Click **Create** to generate the key. 148 148 98 +===== **2. Enable TDE on the SQL Managed Instance** ===== 149 149 150 -select name, database_id, state_desc 151 -from sys.databases 100 +===== ===== 152 152 102 +**- Navigate to Your Managed Instance:** 153 153 154 -SELECT 155 - database_id, 156 - key_algorithm, 157 - key_length, 158 - encryption_state_desc 159 - encryptor_type 104 +* Go to your **SQL Managed Instance** (sqlmi-ebs-lab). 160 160 161 -FROM 162 - select * from sys.dm_database_encryption_keys; 106 +**- Enable Transparent Data Encryption (TDE):** 163 163 108 +* Under **Security**, select **Transparent Data Encryption**. 164 164 165 - selectname,is_encrypted fromsys.databases110 +**- Configure TDE with a Customer-Managed Key (CMK):** 166 166 112 +* Select **Customer-managed key** as the encryption type. 113 +* Choose the key you created earlier from **Azure Key Vault** (mysqlmikey). 167 167 168 - SELECT 169 - cert.name AS Certificate_Name, 170 - cert.subject AS Certificate_Subject, 171 - cert.issuer_name AS Issuer_Name, 172 - cert.pvt_key_encryption_type AS Private_Key_Encryption_Type 173 -FROM 174 - sys.certificates cert 175 -WHERE 176 - cert.name LIKE 'TDE%'; 115 +**- Set the Key as Default TDE Protector:** 177 177 178 - ALTER DATABASE dba1 179 -SET ENCRYPTION off; 180 -GO 117 +* Make the key the **default TDE protector** for your instance. 181 181 119 +**- Save Configuration:** 182 182 183 -Use dba1; 184 -DROP DATABASE ENCRYPTION KEY; 121 +* Click **Save** to apply the changes. 185 185 123 +=== **Conclusion** === 186 186 187 -USE [dba1] 188 -GO 125 +After following these steps, **TDE** has been successfully enabled on your **SQL Managed Instance** using an **asymmetric key** stored in **Azure Key Vault**. All databases within the instance are now encrypted using the same encryption key (identified by the same encryption thumbprint). You can now securely back up these encrypted databases from **SSMS** to **Azure Storage**. 189 189 190 -CREATE DATABASE ENCRYPTION KEY 191 -WITH ALGORITHM = AES_256 192 -ENCRYPTION BY SERVER CERTIFICATE TDE_Certificate; 193 -GO 127 +This process ensures that your data is protected both at rest and during backup, offering enhanced security for your managed databases in the cloud. 194 194 195 195 196 196 197 -ALTER DATABASE dba1 198 -SET ENCRYPTION ON 131 +=== **1. Backup Specific Databases Using SQL Server Agent Jobs** === 199 199 133 +This document describes the process of creating an automated **SQL Server Agent Job** to back up only the **DBA databases** in a SQL Server instance. The backups will occur **daily at 3:00 AM** and will be stored in an **Azure Storage Account** for secure and reliable cloud storage. 200 200 135 +---- 201 201 137 +==== **1. Create the Backup Script** ==== 202 202 203 203 140 +====== **- Declaring Variables** ====== 204 204 142 +{{code language="sql"}} 143 +DECLARE @DatabaseName NVARCHAR(128) 144 +DECLARE @BackupContainerURL NVARCHAR(512) 145 +{{/code}} 205 205 147 +DECLARE @DatabaseName NVARCHAR(128) DECLARE @BackupContainerURL NVARCHAR(512) 206 206 149 +* **@DatabaseName**: A variable to hold the name of the database during each iteration of the loop. 150 +* **@BackupContainerURL**: A variable to store the URL of the Azure Blob Storage container where the database backups will be stored. 207 207 152 +---- 208 208 154 +====== **2. Setting the Azure Blob Storage URL** ====== 209 209 156 +{{code language="sql"}} 157 +SET @BackupContainerURL = 'https://<your_storage_account>.blob.core.windows.net/sql-backups/' 158 +{{/code}} 210 210 211 211 161 +---- 212 212 163 +====== **3. Declaring the Cursor** ====== 213 213 214 214 166 +{{code language="sql"}} 167 +DECLARE db_cursor CURSOR FOR 168 +SELECT name 169 +FROM sys.databases 170 +WHERE name LIKE 'dba%' -- Only pick databases that start with 'dba' 171 +{{/code}} 215 215 173 +* **Cursor Declaration**: 174 +** The cursor db_cursor is declared to loop through the list of databases in the sys.databases system view. 175 +** The **WHERE name LIKE 'dba%'** clause ensures that only databases with names starting with dba will be processed. For example, databases like dbaTest, dbaProd, etc., will be included in the loop. 176 +** **sys.databases**: A system catalog view that contains information about each database in the SQL Server instance. 216 216 178 +---- 217 217 180 +====== **4. Opening the Cursor** ====== 218 218 182 +{{code language="sql"}} 183 +OPEN db_cursor 184 +FETCH NEXT FROM db_cursor INTO @DatabaseName 185 +{{/code}} 219 219 187 +OPEN db_cursor FETCH NEXT FROM db_cursor INTO @DatabaseName 220 220 189 +* **OPEN db_cursor**: This opens the cursor for reading the results. 190 +* **FETCH NEXT**: The FETCH NEXT statement retrieves the first database name that meets the LIKE 'dba%' condition and stores it in the @DatabaseName variable. This will be used in the next step where the backup procedure is executed. 221 221 192 +---- 222 222 194 +====== **5. Looping Through Databases** ====== 223 223 196 +{{code language="sql"}} 197 +-- Loop through each database and execute the stored procedure 198 +WHILE @@FETCH_STATUS = 0 199 +BEGIN 200 + -- Print current database for logging/debugging 201 + PRINT 'Backing up database: ' + @DatabaseName 224 224 203 + -- Execute the DatabaseBackup stored procedure for each database 204 + EXECUTE dba.dbo.DatabaseBackup 205 + @Databases = @DatabaseName, -- Specify the current database 206 + @URL = @BackupContainerURL, -- Azure Blob Storage URL 207 + @BackupType = 'Full', -- Full backup type 208 + @CopyOnly = 'Y', -- Use copy-only backup (this doesn’t affect the transaction log chain) 209 + @Compress = 'Y', -- Enable compression 210 + @Verify = 'N'; -- Skip verification after backup 225 225 212 +{{/code}} 226 226 227 227 215 +* **WHILE @@FETCH_STATUS = 0**: The loop will continue as long as the FETCH command successfully retrieves a database name. @@FETCH_STATUS is a system function that returns 0 if the fetch operation is successful. 216 +* **PRINT**: This line prints the name of the database that is currently being backed up. It helps with logging or debugging purposes, as you can track which database is being processed at any given time. 217 +* ((( 218 +**EXECUTE dba.dbo.DatabaseBackup**: 228 228 220 +* This calls a stored procedure named dba.dbo.DatabaseBackup for each database. 221 +* The parameters passed to the stored procedure: 222 +** **@Databases = @DatabaseName**: Specifies which database to back up (the current database being processed). 223 +** **@URL = @BackupContainerURL**: Specifies the destination Azure Blob Storage URL. 224 +** **@BackupType = 'Full'**: Specifies the backup type, which is a **Full** backup (this means all data in the database is backed up). 225 +** **@CopyOnly = 'Y'**: Specifies that this is a **copy-only backup**. This ensures that the backup does not affect the transaction log chain and does not interfere with regular backups. 226 +** **@Compress = 'Y'**: Enables compression of the backup, reducing the size of the backup file. 227 +** **@Verify = 'N'**: Specifies that the backup verification step should be skipped. (Verification can be added if needed for additional safety.) 228 +))) 229 229 230 +---- 230 230 232 +====== **6. Fetch the Next Database** ====== 231 231 234 +{{code language="sql"}} 235 + -- Fetch the next database in the cursor 236 + FETCH NEXT FROM db_cursor INTO @DatabaseName 232 232 238 +{{/code}} 233 233 240 +~-~- Fetch the next database in the cursor FETCH NEXT FROM db_cursor INTO @DatabaseName 234 234 242 +* **FETCH NEXT**: After executing the backup for the current database, this statement retrieves the next database from the cursor and stores it in the @DatabaseName variable. The loop will continue until all matching databases have been processed. 243 + 244 +---- 245 + 246 +====== **7. Closing and Deallocating the Cursor** ====== 247 + 235 235 {{code language="sql"}} 236 - USEmaster;237 - GO238 - CREATE MASTERKEY ENCRYPTION BY PASSWORD = '******';239 - GO249 +-- Close and deallocate the cursor to clean up resources 250 +CLOSE db_cursor 251 +DEALLOCATE db_cursor 252 + 240 240 241 -CREATE CERTIFICATE EBSphere_TDE_SQL2019_Cert WITH SUBJECT = 'Database_Encryption'; 242 -GO 254 +{{/code}} 243 243 244 -BACKUP CERTIFICATE EBSphere_TDE_SQL2019_Cert TO FILE = 'D:\temp\EBSphere_TDE_SQL2019_Cert' 245 -WITH PRIVATE KEY (file = 'D:\temp\EBSphere_TDE_SQL2019_Cert_Key.pvk', 246 -ENCRYPTION BY PASSWORD='*****') 256 +* **CLOSE db_cursor**: This closes the cursor once the loop finishes processing all databases. 257 +* **DEALLOCATE db_cursor**: This deallocates the cursor, freeing up any resources used by the cursor. It’s a good practice to always deallocate cursors to avoid resource leaks. 247 247 248 -USE Everest_TDE_Master; 249 -GO 250 -CREATE DATABASE ENCRYPTION KEY 251 -WITH ALGORITHM = AES_256 252 -ENCRYPTION BY SERVER CERTIFICATE EBSphere_TDE_SQL2019_Cert; 253 -GO 254 -ALTER DATABASE Everest_TDE_Master 255 -SET ENCRYPTION ON; 256 -GO 259 +====== ====== 257 257 258 -USE Everest_TDE_Master_Documents; 259 -GO 260 -CREATE DATABASE ENCRYPTION KEY 261 -WITH ALGORITHM = AES_256 262 -ENCRYPTION BY SERVER CERTIFICATE EBSphere_TDE_SQL2019_Cert; 263 -GO 264 -ALTER DATABASE Everest_TDE_Master_Documents 265 -SET ENCRYPTION ON; 266 -GO 261 +====== **8. Full Script** ====== 262 + 263 + 264 +{{code language="sql"}} 265 +DECLARE @DatabaseName NVARCHAR(128) 266 +DECLARE @BackupContainerURL NVARCHAR(512) 267 + 268 +SET @BackupContainerURL = 'https://zagpebslab.blob.core.windows.net/sql-backups' 269 + 270 +DECLARE db_cursor CURSOR FOR 271 +SELECT name 272 +FROM sys.databases 273 +WHERE name LIKE 'dba%' 274 + 275 +OPEN db_cursor 276 +FETCH NEXT FROM db_cursor INTO @DatabaseName 277 + 278 +WHILE @@FETCH_STATUS = 0 279 +BEGIN 280 + 281 +PRINT 'Backing up database: ' + @DatabaseName 282 + 283 +EXECUTE dba.dbo.DatabaseBackup 284 + @Databases = @DatabaseName, 285 + @URL = @BackupContainerURL, 286 + @BackupType = 'Full', 287 + @CopyOnly = 'Y', 288 + @Compress = 'Y', 289 + @Verify = 'N'; 290 + 291 +FETCH NEXT FROM db_cursor INTO @DatabaseName 292 +END 293 + 294 +CLOSE db_cursor 295 +DEALLOCATE db_cursor 296 + 267 267 {{/code}} 298 + 299 + 300 + 301 + 302 +=== === 303 + 304 + 305 + 306 + 307 + 308 + 309 + 310 + 311 + 312 + 313 + 314 + 315 + 316 + 317 +
- image-20250305152543-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.rudim - Size
-
... ... @@ -1,0 +1,1 @@ 1 +19.6 KB - Content
- XWiki.XWikiComments[0]
-
- Date
-
... ... @@ -1,0 +1,1 @@ 1 +2025-02-26 16:00:04.223 - Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.rudim - Comment
-
... ... @@ -1,0 +1,1 @@ 1 +put the sql code in code tags to start with otherwise its very hard to read