Rename ciba custom properties on response and add more xml doc

src/IdentityServer/Endpoints/Results/BackchannelAuthenticationResult.cs

@@ -71,7 +71,7 @@ await context.Response.WriteJsonAsync(new SuccessResultDto
                 expires_in = result.Response.ExpiresIn,
                 interval = result.Response.Interval,
 
-                Properties = result.Response.Properties
+                Properties = result.Response.Custom
             });
         }
     }

src/IdentityServer/Models/BackchannelUserLoginRequest.cs

@@ -62,8 +62,9 @@ public class BackchannelUserLoginRequest
     public ResourceValidationResult ValidatedResources { get; set; } = default!;
 
     /// <summary> 
-    /// Gets or sets a dictionary of custom properties that can pass additional
-    /// state to the notification process.
+    /// Gets or sets a dictionary of custom properties associated with this
+    /// request. These properties by default are copied from the validated
+    /// custom request parameters.
     /// </summary>
     public Dictionary<string, object> Properties { get; set; } = new();
 }

src/IdentityServer/ResponseHandling/Models/BackchannelAuthenticationResponse.cs

@@ -61,8 +61,10 @@ public BackchannelAuthenticationResponse(string error, string errorDescription =
     public int Interval { get; set; }
 
     /// <summary> 
-    /// Gets or sets a dictionary of custom properties that can pass additional
-    /// state in the response to the client application.
+    /// Gets or sets a dictionary of custom properties that will be included in
+    /// the response to the client. This dictionary is intended to be used to
+    /// implement extensions to CIBA that defines additional response
+    /// parameters.
     /// </summary>
-    public Dictionary<string, object> Properties { get; set; } = new();
+    public Dictionary<string, object> Custom { get; set; } = new();
 }

src/IdentityServer/Validation/Models/ValidatedBackchannelAuthenticationRequest.cs

@@ -85,8 +85,11 @@ public class ValidatedBackchannelAuthenticationRequest : ValidatedRequest
     public string? RequestObject { get; set; }
 
     /// <summary>
-    /// Gets or sets a dictionary of custom properties that can pass
-    /// additional state to the back channel authentication process.
+    /// Gets or sets a dictionary of validated custom request parameters. Custom
+    /// request parameters should be validated and added to this collection in
+    /// an <see cref="ICustomBackchannelAuthenticationValidator"/>. These
+    /// properties are persisted to the store and made available in the
+    /// backchannel authentication UI and notification services.
     /// </summary>
     public Dictionary<string, object> Properties { get; set; } = new();
 }

src/Storage/Models/BackChannelAuthenticationRequest.cs

@@ -92,7 +92,9 @@ public class BackChannelAuthenticationRequest
     public string? Description { get; set; }
 
     /// <summary>
-    /// Gets or sets a dictionary of custom properties associated with this instance.
+    /// Gets or sets a dictionary of custom properties associated with this
+    /// request. These properties by default are copied from the validated
+    /// custom request parameters.
     /// </summary>
     public Dictionary<string, object> Properties { get; set; } = new();
 }