diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/ActiveDirectoryOpenIdConnectEndpoints.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/ActiveDirectoryOpenIdConnectEndpoints.cs index 0ae5946d2f..d6efbe2499 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/ActiveDirectoryOpenIdConnectEndpoints.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/ActiveDirectoryOpenIdConnectEndpoints.cs @@ -4,7 +4,7 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Well known endpoints for AzureActiveDirectory + /// Well-known endpoints for Microsoft Entra ID. /// public static class ActiveDirectoryOpenIdConnectEndpoints { diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/Configuration/OpenIdConnectConfigurationRetriever.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/Configuration/OpenIdConnectConfigurationRetriever.cs index d8d0c9d37b..2345f57d2c 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/Configuration/OpenIdConnectConfigurationRetriever.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/Configuration/OpenIdConnectConfigurationRetriever.cs @@ -11,7 +11,7 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Retrieves a populated given an address. + /// Retrieves a populated given an address. /// public class OpenIdConnectConfigurationRetriever : IConfigurationRetriever { diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectGrantTypes.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectGrantTypes.cs index 65e46dfc27..35f3fb45d9 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectGrantTypes.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectGrantTypes.cs @@ -4,15 +4,28 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Grant types for token requests. See https://datatracker.ietf.org/doc/html/rfc6749. + /// Defines grant types for token requests. See . /// public static class OpenIdConnectGrantTypes { -#pragma warning disable 1591 + /// + /// Indicates the 'authorization_code' grant type. See . + /// public const string AuthorizationCode = "authorization_code"; + + /// + /// Indicates the 'refresh_token' grant type. See . + /// public const string RefreshToken = "refresh_token"; + + /// + /// Indicates the 'password' grant type. See . + /// public const string Password = "password"; + + /// + /// Indicates the 'client_credentials' grant type. See . + /// public const string ClientCredentials = "client_credentials"; -#pragma warning restore 1591 } } diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectMessage.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectMessage.cs index efdd4e3b3c..183f55c623 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectMessage.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectMessage.cs @@ -13,7 +13,7 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Provides access to common OpenIdConnect parameters. + /// Provides access to common OpenID Connect parameters. /// public class OpenIdConnectMessage : AuthenticationProtocolMessage { diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectParameterNames.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectParameterNames.cs index eb99feb2e7..71971bbd8f 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectParameterNames.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectParameterNames.cs @@ -6,7 +6,7 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Parameter names for OpenIdConnect Request/Response messages. + /// Parameter names for OpenID Connect Request/Response messages. /// public static class OpenIdConnectParameterNames { diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectPrompt.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectPrompt.cs index 8d57176929..6fab741dbc 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectPrompt.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectPrompt.cs @@ -4,32 +4,32 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Prompt types for OpenIdConnect. + /// Defines prompt types for OpenID Connect. /// public static class OpenIdConnectPrompt { /// - /// Indicates 'none' prompt type see: http://openid.net/specs/openid-connect-core-1_0.html#AuthRequest. + /// Indicates the 'none' prompt type. See . /// public const string None = "none"; /// - /// Indicates 'create' prompt type see: https://openid.net/specs/openid-connect-prompt-create-1_0.html. + /// Indicates the 'create' prompt type. See . /// public const string Create = "create"; /// - /// Indicates 'login' prompt type see: http://openid.net/specs/openid-connect-core-1_0.html#AuthRequest. + /// Indicates the 'login' prompt type. See . /// public const string Login = "login"; /// - /// Indicates 'consent' prompt type see: http://openid.net/specs/openid-connect-core-1_0.html#AuthRequest. + /// Indicates the 'consent' prompt type. See . /// public const string Consent = "consent"; /// - /// Indicates 'select_account' prompt type see: http://openid.net/specs/openid-connect-core-1_0.html#AuthRequest. + /// Indicates the 'select_account' prompt type. See . /// public const string SelectAccount = "select_account"; } diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectProtocolValidationContext.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectProtocolValidationContext.cs index 8ca01c2a75..ccf1a80b39 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectProtocolValidationContext.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectProtocolValidationContext.cs @@ -8,7 +8,7 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// /// A context that is used by a when validating an OpenIdConnect Response - /// to ensure it compliant with http://openid.net/specs/openid-connect-core-1_0.html. + /// to ensure it's compliant with . /// public class OpenIdConnectProtocolValidationContext { diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectRequestType.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectRequestType.cs index e212fb4909..f466233cae 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectRequestType.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectRequestType.cs @@ -4,25 +4,25 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// RequestTypes for OpenIdConnect. + /// Defines request types for OpenID Connect. /// - /// Can be used to determine the message type by consumers of an . - /// For example: sets - /// to . + /// + /// Can be used to determine the message type in an . + /// public enum OpenIdConnectRequestType { /// - /// Indicates an Authentication Request see: http://openid.net/specs/openid-connect-core-1_0.html#AuthRequest. + /// Indicates an Authentication Request. See . /// Authentication, /// - /// Indicates a Logout Request see: http://openid.net/specs/openid-connect-frontchannel-1_0.html#RPLogout. + /// Indicates a Logout Request. See . /// Logout, /// - /// Indicates a Token Request see: http://openid.net/specs/openid-connect-core-1_0.html#TokenRequest. + /// Indicates a Token Request. See . /// Token, } diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectResponseMode.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectResponseMode.cs index 77ae2333ec..6ad7aeb999 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectResponseMode.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectResponseMode.cs @@ -4,25 +4,25 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Response modes for OpenIdConnect. + /// Defines response modes for OpenID Connect. /// - /// Can be used to determine the response mode by consumers of an . - /// For example: OpenIdConnectMessageTests.Publics() sets - /// to . + /// + /// Can be used to determine the response mode in an . + /// public static class OpenIdConnectResponseMode { /// - /// Indicates a Query Response see: http://openid.net/specs/openid-connect-core-1_0.html#ImplicitAuthResponse. + /// Indicates a Query Response. See . /// public const string Query = "query"; /// - /// Indicates a Form Post Response see: http://openid.net/specs/openid-connect-core-1_0.html#ImplicitAuthResponse. + /// Indicates a Form Post Response. See . /// public const string FormPost = "form_post"; /// - /// Indicates a Fragment Response see: http://openid.net/specs/openid-connect-core-1_0.html#ImplicitAuthResponse. + /// Indicates a Fragment Response. See . /// public const string Fragment = "fragment"; } diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectResponseType.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectResponseType.cs index 28bb9c5f5e..74e310fd09 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectResponseType.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectResponseType.cs @@ -4,58 +4,58 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Response types for OpenIdConnect. + /// Defines response types for OpenID Connect. /// - /// Can be used to determine the message type by consumers of an . - /// For example: OpenIdConnectMessageTests.Publics() sets - /// to . + /// + /// Can be used to determine the message type in an . + /// public static class OpenIdConnectResponseType { /// - /// Indicates 'code' type see: http://openid.net/specs/openid-connect-core-1_0.html#CodeFlowAuth. - /// For Example: http://openid.net/specs/openid-connect-core-1_0.html#codeExample. + /// Indicates the 'code' response type. See . + /// For example: . /// public const string Code = "code"; /// - /// Indicates 'code id_token' type see: http://openid.net/specs/openid-connect-core-1_0.html#HybridAuthRequest. - /// For Example: http://openid.net/specs/openid-connect-core-1_0.html#code-id_tokenExample. + /// Indicates the 'code id_token' response type. See . + /// For example: . /// public const string CodeIdToken = "code id_token"; /// - /// Indicates 'code id_token token' type see: http://openid.net/specs/openid-connect-core-1_0.html#HybridAuthRequest. - /// For Example: http://openid.net/specs/openid-connect-core-1_0.html#code-id_token-tokenExample. + /// Indicates the 'code id_token token' response type. See . + /// For example: . /// public const string CodeIdTokenToken = "code id_token token"; /// - /// Indicates 'code token' type see: http://openid.net/specs/openid-connect-core-1_0.html#HybridAuthRequest. - /// For Example: http://openid.net/specs/openid-connect-core-1_0.html#code-tokenExample. + /// Indicates the 'code token' response type. See . + /// For example: . /// public const string CodeToken = "code token"; /// - /// Indicates 'id_token' type see: http://openid.net/specs/openid-connect-core-1_0.html#HybridAuthRequest. - /// For Example: http://openid.net/specs/openid-connect-core-1_0.html#id_tokenExample. + /// Indicates the 'id_token' response type. See . + /// For example: . /// public const string IdToken = "id_token"; /// - /// Indicates 'id_token token' type see: http://openid.net/specs/openid-connect-core-1_0.html#ImplicitFlowAuth. - /// For Example: http://openid.net/specs/openid-connect-core-1_0.html#id_token-tokenExample. + /// Indicates the 'id_token token' response type. See . + /// For example: . /// public const string IdTokenToken = "id_token token"; /// - /// Defined in OAuth v2 multiple response types 1.0 spec, included for completion. - /// See: http://openid.net/specs/oauth-v2-multiple-response-types-1_0.html#OAuthResponseTypesReg. + /// Defined in the OAuth v2 Multiple Response Types 1.0 spec for completeness. + /// See: . /// public const string None = "none"; /// - /// Defined in OAuth 2.0 spec, included for completion. - /// See: https://datatracker.ietf.org/doc/html/rfc6749#section-11.3.2. + /// Defined in the OAuth 2.0 spec for completeness. + /// See: . /// public const string Token = "token"; } diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectScope.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectScope.cs index c32880eaaf..1e10c6879a 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectScope.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectScope.cs @@ -4,50 +4,50 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Specific scope values that are interesting to OpenID Connect. See https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims + /// Defines scopes for OpenID Connect. For details, see . /// - /// Can be used to determine the scope by consumers of an . - /// For example: OpenIdConnectMessageTests.Publics() sets - /// to . + /// + /// Can be used to determine the scope in an . + /// public static class OpenIdConnectScope { /// - /// Indicates address scope see: https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims. + /// Indicates the address scope. See . /// public const string Address = "address"; /// - /// Indicates email scope see: https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims. + /// Indicates the email scope. See . /// public const string Email = "email"; /// - /// Indicates offline_access scope see: https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims. + /// Indicates the offline_access scope. See . /// public const string OfflineAccess = "offline_access"; /// - /// Indicates openid scope see: https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims. + /// Indicates the openid scope. See . /// public const string OpenId = "openid"; /// - /// Indicates openid and profile scope see: https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims. + /// Indicates both openid and profile scopes. See . /// public const string OpenIdProfile = "openid profile"; /// - /// Indicates phone scope see: https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims. + /// Indicates the phone scope. See . /// public const string Phone = "phone"; /// - /// Indicates profile scope see: https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims. + /// Indicates the profile scope. See . /// public const string Profile = "profile"; /// - /// Indicates user_impersonation scope for Azure Active Directory. + /// Indicates the user_impersonation scope for Microsoft Entra ID. /// public const string UserImpersonation = "user_impersonation"; } diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectSessionProperties.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectSessionProperties.cs index cb852eca1e..c8c183bf2b 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectSessionProperties.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdConnectSessionProperties.cs @@ -4,7 +4,7 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// Defines a set of properties names + /// Defines a set of properties names. /// public static class OpenIdConnectSessionProperties { @@ -12,7 +12,7 @@ public static class OpenIdConnectSessionProperties /// Property defined for 'check_session_iframe'. /// public const string CheckSessionIFrame = ".checkSessionIFrame"; - + /// /// Property defined for 'redirect_uri' set in the request for a 'code' /// @@ -22,6 +22,5 @@ public static class OpenIdConnectSessionProperties /// Property defined for 'session state' /// public const string SessionState = ".sessionState"; - } } diff --git a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdProviderMetadataNames.cs b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdProviderMetadataNames.cs index b5c802d3dd..c80beaa1bf 100644 --- a/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdProviderMetadataNames.cs +++ b/src/Microsoft.IdentityModel.Protocols.OpenIdConnect/OpenIdProviderMetadataNames.cs @@ -6,8 +6,8 @@ namespace Microsoft.IdentityModel.Protocols.OpenIdConnect { /// - /// OpenId Provider Metadata parameter names - /// http://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata + /// OpenID Provider Metadata parameter names + /// . /// public static class OpenIdProviderMetadataNames {