diff --git a/src/Microsoft.AspNetCore.Authentication.Abstractions/IClaimsTransformation.cs b/src/Microsoft.AspNetCore.Authentication.Abstractions/IClaimsTransformation.cs index 8371901506..0193d95783 100644 --- a/src/Microsoft.AspNetCore.Authentication.Abstractions/IClaimsTransformation.cs +++ b/src/Microsoft.AspNetCore.Authentication.Abstractions/IClaimsTransformation.cs @@ -12,7 +12,9 @@ namespace Microsoft.AspNetCore.Authentication public interface IClaimsTransformation { /// - /// Provides a central transformation point to change the specified principal. + /// Provides a central transformation point to change the specified principal. + /// Note: this will be run on each AuthenticateAsync call, so its safer to + /// return a new ClaimsPrincipal if your transformation is not idempotent. /// /// The to transform. /// The transformed principal.