Data Protection API (DPAPI), is a widely used functionality within Windows applications to encrpyt sensitive data without taking care the encryption key and the algorithm themselves.
Every Windows user has a Master Key (located in his profile path) that he uses to encrypt and decrypt data which can be stored locally or remotely.
For Active Directory users, one copy of this Master Key is encrypted with the user's password and another copy is encrypted with the Domain BackupKey.
The second encrpytion was desgined to help users recover encrypted secrets in case they forget their own password.
The Domain BackupKey is a unique RSA key pair generated during Active Directory domain inception.
Due to the fact that the BackupKey is permanent per domain, an exposure of this key provides an adversary with the ability to decrypt users' Master keys across the domain, indefinitely.
As of writing these words, we have not seen any method to replace the domain BackupKey before, not by Microsoft or any other entity.
The BackupKeyManager is a tool to help organizations enhance their security on a post compromise scenario, where their DPAPI Domain BackupKey was exposed, and they wish to mitigate the risk of further exploitation with this key. The process is simply done by generating a new BackupKey and onboard existing users' to backup their Master Keys with the new BackupKey.
For more information and the research behind this tool you can visit our blogpost -> The downfall of DPAPI's top-secret weapon
This repository contains two projects:
- BackupKeyManager - The main Backup Key modification tool (C#) + MS-BKRP DLL (C language)
- user-key-onboarding - A utility to onboard existing AD users to the domain backup key (PS)
Follow the steps below to modify your domain DPAPI backup key. Full command lines for each step are detailed in the sections below.
- First, you will have to use the BackupKeyManager to extract the currently used (preferred) BackupKey. Write down its GUID in case you will need to revert back to it.
- Use the BackupKeyManager to create and prefer a new backup key in the domain (Note to write down the generated GUID).
- A restart will be required to the DC as we must reload the LSASS process.
- Use the BackupKeyManager to validate that the certificate's GUID being served is identical to the one generated during step #1.
- From a domain user session, execute the user-key-onboarding with the 'Exec' mode. Note which user Master keys are using the new backup key ( By comparing their GUIDs).
- Repeat step #4 for every user you would like to onboard to the new key.
New Domain users will use the new key automatically.
To list existing Backup keys, you may use the PS command below (ActiveDirectory module is required). The result will include active directory secret objects that are related to the domain's DPAPI Backup Key:
PS C:\> Get-ADObject -LDAPFilter "(objectClass=secret)" -Properties Name,whenCreated,whenChanged | FT Name,whenCreated, whenChanged
Name whenCreated whenChanged
---- ----------- -----------
BCKUPKEY_fda62c34-c58a-410e-8b49-3b11941d8d56 Secret 4/6/2022 8:45:19 AM 4/6/2022 8:45:19 AM # Preferred Legacy backup key
BCKUPKEY_P Secret 4/6/2022 8:45:19 AM 4/6/2022 8:45:19 AM
BCKUPKEY_b78e84e3-9105-439c-b0e3-94e3163e3dd4 Secret 4/6/2022 8:45:20 AM 4/6/2022 8:45:20 AM # Preferred regular backup key
BCKUPKEY_PREFERRED Secret 4/6/2022 8:45:20 AM 4/6/2022 8:45:20 AM
The BCKUPKEY_P content include fda62c34-c58a-410e-8b49-3b11941d8d56 GUID which represents what object contains the Legacy preferred DPAPI backup key.
The BCKUPKEY_PREFERRED content include 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e which represetns what object contains the regular preferred DPAPI backup key.
This set of secret objects are created during the domain inception.
The Legacy backup key is ignored in the BackupKeyManager project.
The BackupKeyManager 'help' provides information on what and how you can use it. There are few verbs alongside with specific flags you can set according to your needs. It is important to use this tool together with the Primary domain controller (PDC).
Requires .NET Framework 4.8
Domain Admin privileges required for:
- GetBackupKey
- SetPreferredBackupKey
- GenerateNewBackupKey (Only when using the push flag)
- BackupKeyFromFile (Only when using the push flag)
- Validate
Any Domain User privileges required for:
- GetPublicKey
C:\BackupKeyManager>BackupKeyManager.exe --help
BackupKeyManager 1.0.0.0
Copyright c 2022
ERROR(S):
No verb selected.
GetPublicKey Fetch the public certificate of the preferred BackupKey via MS-BKRP (Non-Admin operation).
GetBackupKey Get a BackupKey. By default will get the preferred (currently used) one.
SetPreferredBackupKey Set a new preferred BackupKey by providing its GUID
GenerateNewBackupKey Generate new BackupKey with option to push and set as preferred.
BackupKeyFromFile Load BackupKey from file with option to push and set as preferred.
Validate Validates the BackupKey setup. Validation should be made against all DCs in the domain.
help Display more information on a specific command.
version Display version information.
C:\BackupKeyManager>BackupKeyManager.exe GenerateNewBackupKey --help
BackupKeyManager 1.0.0.0
Copyright c 2022
-d, --DomainName Required. FQDN of the targeted domain. This will be included in the public certificate.
-o (Optional) Flag to save the Backupkey and certificate (DER format) outputs to files in the
current path.
--push (Optional) Push the generated BackupKey to a Domain Controller.
-s, --DomainController (Required with 'push') Primary Domain Controller FQDN to interact with.
--set (Required with 'push') Set the generated BackupKey as the Preferred BackupKey.
--help Display this help screen.
--version Display version information.
Extracts the preferred BackupKey via MS-LSAD protocol (Domain Admin is required). You may also specify alternative GUID to extract a different BackupKey contents.
C:\BackupKeyManager>BackupKeyManager.exe GetBackupKey -s dc.domain.local --analyze
[+] Setting up connection with Domain Controller: dc.domain.local
[+] Preferred backupkey Guid : b78e84e3-9105-439c-b0e3-94e3163e3dd4
[+] Getting backup key : G$BCKUPKEY_b78e84e3-9105-439c-b0e3-94e3163e3dd4
[+] BackupKey size: 1952
[+] Validating BackupKey header...
[+] Analyzing certificate information:
[Certificate] Serial Number: D4-3D-3E-16-E3-94-E3-B0-43-9C-91-05-B7-8E-84-E3
[Certificate] Version: 3
[Certificate] Issuer name: domain.local
[Certificate] Subject name: domain.local
[Certificate] Not Before: 4/6/2022 8:45:20 AM +00:00
[Certificate] Not After: 4/6/2023 8:45:20 AM +00:00
[Certificate] Validity period: 365.00:00:00
[Certificate] SignatureAlgo OID: 1.3.14.3.2.29
[Certificate] PublicKeyInfo OID: 1.2.840.113549.1.1.1
[Certificate] RSA Key Size: 2048 bits
[Certificate] Certificate Guid: b78e84e3-9105-439c-b0e3-94e3163e3dd4
[+] Validating Certificate format...
[+] Operation completed successfully!
C:\BackupKeyManager>BackupKeyManager.exe GenerateNewBackupKey -d domain.local -s dc.domain.local --set --push
[+] Generated Guid: 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] Generating 2048 bit RSA Key pair...
[+] Creating certificate
[+] Building the new Domain BackupKey...
[+] BackupKey size: 1952
[+] Analyzing certificate information:
[Certificate] Serial Number: 7E-1B-5F-EF-0A-AD-A0-EC-06-42-3D-6C-1E-2B-65-67
[Certificate] Version: 3
[Certificate] Issuer name: domain.local
[Certificate] Subject name: domain.local
[Certificate] Not Before: 11/18/2022 5:39:16 AM +00:00
[Certificate] Not After: 11/18/2023 5:39:16 AM +00:00
[Certificate] Validity period: 365.00:00:00
[Certificate] SignatureAlgo OID: 1.3.14.3.2.29
[Certificate] PublicKeyInfo OID: 1.2.840.113549.1.1.1
[Certificate] RSA Key Size: 2048 bits
[Certificate] Certificate Guid: 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] Validating BackupKey header...
[+] Validating Certificate format...
[+] Setting up connection with Domain Controller: dc.domain.local
[+] Creating Backup key with name : G$BCKUPKEY_1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] New Backup key created successfully : G$BCKUPKEY_1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] Writing bytes to Backup key...
[+] Backup key uploaded successfully
[+] Modified preferred backup GUID to: 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[?] You must restart the targeted Domain Controller for the changes to take effect
[+] Operation completed successfully!
Eventhough we set a different key as the preferred one, we must reload the LSASS process on the Domain Controller so it will serve the new public key to users in the domain.
To make sure we did not break anything, we must validate the protocol functionality and keys synchronization.
C:\BackupKeyManager>BackupKeyManager.exe Validate -s dc.domain.local
[+] Setting up connection with Domain Controller: dc.domain.local
[+] Preferred Backupkey Guid : 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] Retrieving the current BackupKey public certificate via MS-BKRP...OK -> Certificate size: 768
[+] MS-BKRP Serviced Backupkey Guid : 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] SUCCESS! The serviced Backup Key (MS-BKRP) and the Preferred Backup key (MS-LSAD) are synced
[+] Validating MS-BKRP protocol health
> Attempting secret encrypt (MySecret!).... OK
> Attempting secret decrypt.... OK -> MySecret!
[+] SUCCESS! MS-BKRP secret encryption & decryption passed!
[+] Operation completed successfully!
You may want to check what is served by the Domain Controller via the MS-BKRP protocol, and retreive informaton about the certificate
C:\BackupKeyManager>BackupKeyManager.exe GetPublicKey -s dc.domain.local --analyze
[+] Retrieving the current BackupKey public certificate via MS-BKRP...OK -> Certificate size: 768
[+] MS-BKRP Serviced Backupkey Guid : 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] Analyzing certificate information:
[Certificate] Serial Number: 7E-1B-5F-EF-0A-AD-A0-EC-06-42-3D-6C-1E-2B-65-67
[Certificate] Version: 3
[Certificate] Issuer name: domain.local
[Certificate] Subject name: domain.local
[Certificate] Not Before: 11/18/2022 5:39:16 AM +00:00
[Certificate] Not After: 11/18/2023 5:39:16 AM +00:00
[Certificate] Validity period: 365.00:00:00
[Certificate] SignatureAlgo OID: 1.3.14.3.2.29
[Certificate] PublicKeyInfo OID: 1.2.840.113549.1.1.1
[Certificate] RSA Key Size: 2048 bits
[Certificate] Certificate Guid: 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] Validating Certificate format...
[+] Operation completed successfully!
⚠️ Although it is not required and does not pose a security risk to keep an older (or even compromised) one, some users may want to delete BackupKeys. Keep in mind that deleting a BackupKey is irreversible and will disable users from restoring access to their sensitive information in case they forget their domain password.
On a Domain Controller, launch dsa.msc, make sure to enable system objects view by navigating to View -> Advanced Features.
Double check the GUID of the BackupKey intended to be deleted, right click on it, delete and confirm:
At this point, when listing the existing BackupKeys, we will see added objects created later than 4/06/2022. These objects are keys created using the BackupKeyManager. Note the new modified time of the BCKUPKEY_PREFERRED object which is now pointing on BCKUPKEY_1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
PS C:\> Get-ADObject -LDAPFilter "(objectClass=secret)" -Properties Name,whenCreated,whenChanged | FT Name,whenCreated, whenChanged
Name whenCreated whenChanged
---- ----------- -----------
BCKUPKEY_fda62c34-c58a-410e-8b49-3b11941d8d56 Secret 4/6/2022 8:45:19 AM 4/6/2022 8:45:19 AM
BCKUPKEY_P Secret 4/6/2022 8:45:19 AM 4/6/2022 8:45:19 AM
BCKUPKEY_b78e84e3-9105-439c-b0e3-94e3163e3dd4 Secret 4/6/2022 8:45:20 AM 4/6/2022 8:45:20 AM
BCKUPKEY_PREFERRED Secret 4/6/2022 8:45:20 AM 11/18/2022 5:39:16 AM
BCKUPKEY_e11a5f54-1268-7521-3152-bb20845cdf08 Secret 11/18/2022 4:16:48 AM 11/18/2022 4:16:48 AM
BCKUPKEY_1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e Secret 11/18/2022 5:39:16 AM 11/18/2022 5:39:16 AM # New Preferred backup key
You can compare between the creation and modification dates of the BCKUPKEY_PREFERRED object in order to identify if there were any changes to the preferred BackupKey since the domain inception:
PS C:\> Get-ADObject -LDAPFilter "(cn=BCKUPKEY_PREFERRED Secret)" -Properties whenCreated,whenChanged | FT whenCreated,whenChanged
whenCreated whenChanged
----------- -----------
4/6/2022 8:45:20 AM 11/18/2022 5:39:16 AM
The user-key-onboarding.ps1 script is a utility to onboard existing domain users to encrypt further master keys with the latest DPAPI domain backup key. The script must be executed from each onboarded user's context, meanning that it should to be deployed via either startup scripts, GPO, Intune, etc. The script can also provide information about existing Master Keys, and help you locate Master keys which are encrypted with specific backup key. The latter may help in either identifying Master keys at risk of exposure, or making sure that the user has onboarded to the latest backup key.
- Get familiar with the status of each current user Master keys. Note the GUID of the Backup key that these Master keys are encrypted with:
PS C:\Users\dpapitest> Invoke-BkpOnboard -Mode Info
[-] Preferred Master key Guid: e7a8579d-33d7-40ef-95e7-bfe5d2344e85
[-] Preferred Master key Expiration: 02/19/2023 06:05:14 UTC
[-] Mapping User Master keys
isPreferred Modified Guid Backup_Guid
----------- -------- ---- -----------
True 11/21/2022 6:05:14 AM e7a8579d-33d7-40ef-95e7-bfe5d2344e85 b78e84e3-9105-439c-b0e3-94e3163e3dd4
False 11/21/2022 6:05:06 AM 781d2cb1-cfb8-4ceb-95fc-7cbaa28ffdbc b78e84e3-9105-439c-b0e3-94e3163e3dd4
False 11/21/2022 6:05:06 AM 5ec93b5b-cbb9-41ae-9527-77d1ccf20d93 b78e84e3-9105-439c-b0e3-94e3163e3dd4
- Filter current user's Master keys to list those encrypted with specific Backup key:
PS C:\Users\dpapitest> Invoke-BkpOnboard -Mode Check -BackupGuid "1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e"
[-] Checking for Master keys encrypted with Backup key: 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
[+] No Master keys found!
- Onboard the current user to encrypt any further Master keys with the latest Backup key:
PS C:\Users\dpapitest> Invoke-BkpOnboard -Mode Exec
[-] Checking connection to the Active Directory: DOMAIN.LOCAL
[+] Setting expiration to: 11/21/2022 06:10:22
[+] Saving Data to: C:\Users\dpapitest\AppData\Roaming\Microsoft\Protect\S-1-5-21-2909993917-1331672730-2155874541-1111\Preferred
C:\Users\dpapitest\AppData\Roaming\Microsoft\Protect\S-1-5-21-2909993917-1331672730-2155874541-1111\BK-domain
[+] Renaming old public key: BK-domain to BK-domain_638046078227108620
[-] Triggering DPAPI Master key generation...
[+] DPAPI latest public key fetched successfully
[-] Preferred Master key Guid: 4822e7d6-7d37-4258-a289-fda2738cdbf2
[-] Preferred Master key Expiration: 02/19/2023 06:10:24 UTC
[+] SUCCESS: User onboarded to Backup key: 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
- Once again, list the current user's Master keys, note the recently pushed Backup Key GUID (1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e):
PS C:\Users\dpapitest> Invoke-BkpOnboard -Mode Info
[-] Preferred Master key Guid: 4822e7d6-7d37-4258-a289-fda2738cdbf2
[-] Preferred Master key Expiration: 02/19/2023 06:10:24 UTC
[-] Mapping User Master keys
isPreferred Modified Guid Backup_Guid
----------- -------- ---- -----------
True 11/21/2022 6:10:24 AM 4822e7d6-7d37-4258-a289-fda2738cdbf2 1e2b6567-3d6c-0642-eca0-ad0aef5f1b7e
False 11/21/2022 6:05:14 AM e7a8579d-33d7-40ef-95e7-bfe5d2344e85 b78e84e3-9105-439c-b0e3-94e3163e3dd4
False 11/21/2022 6:05:06 AM 781d2cb1-cfb8-4ceb-95fc-7cbaa28ffdbc b78e84e3-9105-439c-b0e3-94e3163e3dd4
False 11/21/2022 6:05:06 AM 5ec93b5b-cbb9-41ae-9527-77d1ccf20d93 b78e84e3-9105-439c-b0e3-94e3163e3dd4
Simply clone the repository and build the solution using Visual Studio. The solution includes C# and C projects, so you should set the build configuration to Release, x64/x86 according to the running system architecture.
Coded and tested using Microsoft Visual Studio 2022 Version 17.2.5.
Following a successful build, BackupKeyManager.exe together will all required DLLs will be exported to this path: BackupKeyManager\x64\Release.
Make sure to copy the entire Release directory and execute the tool from it.
Huge credit goes to @harmj0y and @gentilkiwi for their work and contribution to the DPAPI topic as a whole. Some code and examples borrowed from their projects SharpDPAPI and basic_rpc.
Credit goes to @oleglerner and @lbinyamin for their contirbution in making this research and implementation happen!
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
