diff --git a/src/Security/Authorization/Core/src/AuthorizationServiceExtensions.cs b/src/Security/Authorization/Core/src/AuthorizationServiceExtensions.cs index 324d613cf8f5..47d381136f25 100644 --- a/src/Security/Authorization/Core/src/AuthorizationServiceExtensions.cs +++ b/src/Security/Authorization/Core/src/AuthorizationServiceExtensions.cs @@ -21,8 +21,8 @@ public static class AuthorizationServiceExtensions /// The resource to evaluate the policy against. /// The requirement to evaluate the policy against. /// - /// A flag indicating whether requirement evaluation has succeeded or failed. - /// This value is true when the user fulfills the policy, otherwise false. + /// A that contains an indicating whether requirement evaluation has succeeded or failed. + /// The result's property is true when the user fulfills the policy; otherwise false. /// public static Task AuthorizeAsync(this IAuthorizationService service, ClaimsPrincipal user, object? resource, IAuthorizationRequirement requirement) { @@ -40,8 +40,8 @@ public static Task AuthorizeAsync(this IAuthorizationServic /// The resource to evaluate the policy against. /// The policy to evaluate. /// - /// A flag indicating whether policy evaluation has succeeded or failed. - /// This value is true when the user fulfills the policy, otherwise false. + /// A that contains an indicating whether policy evaluation has succeeded or failed. + /// The result's property is true when the user fulfills the policy; otherwise false. /// public static Task AuthorizeAsync(this IAuthorizationService service, ClaimsPrincipal user, object? resource, AuthorizationPolicy policy) { @@ -58,8 +58,8 @@ public static Task AuthorizeAsync(this IAuthorizationServic /// The user to evaluate the policy against. /// The policy to evaluate. /// - /// A flag indicating whether policy evaluation has succeeded or failed. - /// This value is true when the user fulfills the policy, otherwise false. + /// A that contains an indicating whether policy evaluation has succeeded or failed. + /// The result's property is true when the user fulfills the policy; otherwise false. /// public static Task AuthorizeAsync(this IAuthorizationService service, ClaimsPrincipal user, AuthorizationPolicy policy) { @@ -76,8 +76,8 @@ public static Task AuthorizeAsync(this IAuthorizationServic /// The user to evaluate the policy against. /// The name of the policy to evaluate. /// - /// A flag indicating whether policy evaluation has succeeded or failed. - /// This value is true when the user fulfills the policy, otherwise false. + /// A that contains an indicating whether policy evaluation has succeeded or failed. + /// The result's property is true when the user fulfills the policy; otherwise false. /// public static Task AuthorizeAsync(this IAuthorizationService service, ClaimsPrincipal user, string policyName) { diff --git a/src/Security/Authorization/Core/src/DefaultAuthorizationService.cs b/src/Security/Authorization/Core/src/DefaultAuthorizationService.cs index 1a9474634485..0a1b4c37b382 100644 --- a/src/Security/Authorization/Core/src/DefaultAuthorizationService.cs +++ b/src/Security/Authorization/Core/src/DefaultAuthorizationService.cs @@ -56,8 +56,8 @@ public DefaultAuthorizationService(IAuthorizationPolicyProvider policyProvider, /// The resource to evaluate the requirements against. /// The requirements to evaluate. /// - /// A flag indicating whether authorization has succeeded. - /// This value is true when the user fulfills the policy, otherwise false. + /// A that contains an indicating whether authorization has succeeded. + /// The result's property is true when the user fulfills the policy; otherwise false. /// public virtual async Task AuthorizeAsync(ClaimsPrincipal user, object? resource, IEnumerable requirements) { @@ -93,8 +93,8 @@ public virtual async Task AuthorizeAsync(ClaimsPrincipal us /// The resource the policy should be checked with. /// The name of the policy to check against a specific context. /// - /// A flag indicating whether authorization has succeeded. - /// This value is true when the user fulfills the policy otherwise false. + /// A that contains an indicating whether authorization has succeeded. + /// The result's property is true when the user fulfills the policy; otherwise false. /// public virtual async Task AuthorizeAsync(ClaimsPrincipal user, object? resource, string policyName) { diff --git a/src/Security/Authorization/Core/src/IAuthorizationService.cs b/src/Security/Authorization/Core/src/IAuthorizationService.cs index 64ac3b5cd514..5c612869d4de 100644 --- a/src/Security/Authorization/Core/src/IAuthorizationService.cs +++ b/src/Security/Authorization/Core/src/IAuthorizationService.cs @@ -22,8 +22,8 @@ public interface IAuthorizationService /// /// The requirements to evaluate. /// - /// A flag indicating whether authorization has succeeded. - /// This value is true when the user fulfills the policy; otherwise false. + /// A that contains an indicating whether authorization has succeeded. + /// The result's property is true when the user fulfills the policy; otherwise false. /// /// /// Resource is an optional parameter and may be null. Please ensure that you check it is not @@ -41,9 +41,8 @@ public interface IAuthorizationService /// /// The name of the policy to check against a specific context. /// - /// A flag indicating whether authorization has succeeded. - /// Returns a flag indicating whether the user, and optional resource has fulfilled the policy. - /// true when the policy has been fulfilled; otherwise false. + /// A that contains an indicating whether authorization has succeeded. + /// The result's property is true when the policy has been fulfilled; otherwise false. /// /// /// Resource is an optional parameter and may be null. Please ensure that you check it is not