From 7e54773a6e54db72b42ca33783727e824a4b3dfb Mon Sep 17 00:00:00 2001
From: Bernd Schoolmann <mail@quexten.com>
Date: Tue, 4 Nov 2025 12:42:07 +0100
Subject: [PATCH] Add summary comments for MasterKeyWrappedUserKey in response
 models (#6531)

---
 .../Models/Api/Response/MasterPasswordUnlockResponseModel.cs  | 4 ++++
 .../Models/Data/MasterPasswordUnlockAndAuthenticationData.cs  | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/src/Core/KeyManagement/Models/Api/Response/MasterPasswordUnlockResponseModel.cs b/src/Core/KeyManagement/Models/Api/Response/MasterPasswordUnlockResponseModel.cs
index f54e88c596..eebed83485 100644
--- a/src/Core/KeyManagement/Models/Api/Response/MasterPasswordUnlockResponseModel.cs
+++ b/src/Core/KeyManagement/Models/Api/Response/MasterPasswordUnlockResponseModel.cs
@@ -7,6 +7,10 @@ namespace Bit.Core.KeyManagement.Models.Api.Response;
 public class MasterPasswordUnlockResponseModel
 {
     public required MasterPasswordUnlockKdfResponseModel Kdf { get; init; }
+    /// <summary>
+    /// The user's symmetric key encrypted with their master key.
+    /// Also known as "MasterKeyWrappedUserKey"
+    /// </summary>
     [EncryptedString] public required string MasterKeyEncryptedUserKey { get; init; }
     [StringLength(256)] public required string Salt { get; init; }
 }
diff --git a/src/Core/KeyManagement/Models/Data/MasterPasswordUnlockAndAuthenticationData.cs b/src/Core/KeyManagement/Models/Data/MasterPasswordUnlockAndAuthenticationData.cs
index e305d92fec..ad3a0b692b 100644
--- a/src/Core/KeyManagement/Models/Data/MasterPasswordUnlockAndAuthenticationData.cs
+++ b/src/Core/KeyManagement/Models/Data/MasterPasswordUnlockAndAuthenticationData.cs
@@ -13,6 +13,10 @@ public class MasterPasswordUnlockAndAuthenticationData
 
     public required string Email { get; set; }
     public required string MasterKeyAuthenticationHash { get; set; }
+    /// <summary>
+    /// The user's symmetric key encrypted with their master key.
+    /// Also known as "MasterKeyWrappedUserKey"
+    /// </summary>
     public required string MasterKeyEncryptedUserKey { get; set; }
     public string? MasterPasswordHint { get; set; }