Merge branch 'main' into eric/new-hello-bar-cs-239

Author: maartenba

.idea/copilot.data.migration.agent.xml

@@ -16,11 +16,6 @@ The `Duende.AccessTokenManagement` library provides automatic access token manag
 - Automatic access token lifetime management using a refresh token for API calls on behalf of the currently logged-in user (using the `Duende.AccessTokenManagement.OpenIdConnect` package)
 - Revocation of access tokens
 
-:::note[Duende.AccessTokenManagement version 4 preview]
-Duende.AccessTokenManagement version 4 (preview) brings significant improvements, but also several breaking
-changes. Please see the [migration guide](/accesstokenmanagement/upgrading/atm-v3-to-v4.md) and [release notes](https://github.com/DuendeSoftware/foss/releases/tag/atm-4.0.0-Preview.2).
-:::
-
 ## Machine-To-Machine Token Management
 
 To get started, install the NuGet Package:

.idea/copilot.data.migration.edit.xml

@@ -10,7 +10,7 @@ redirect_from:
 
 The client library for the [OAuth 2.0 device
 flow](https://tools.ietf.org/html/rfc7662) device authorization is
-provided as an extension method for *HttpClient*.
+provided as an extension method for `HttpClient`.
 
 The following code sends a device authorization request:
 
@@ -24,12 +24,12 @@ var response = await client.RequestDeviceAuthorizationAsync(new DeviceAuthorizat
 });
 ```
 
-The response is of type *DeviceAuthorizationResponse* and has properties
+The response is of type `DeviceAuthorizationResponse` and has properties
 for the standard response parameters. You also have access to the
-raw response and to a parsed JSON document (via the *Raw* and
-*Json* properties).
+raw response and to a parsed JSON document (via the `Raw` and
+`Json` properties).
 
-Before using the response, you should always check the *IsError*
+Before using the response, you should always check the `IsError`
 property to make sure the request was successful:
 
 ```csharp

src/content/docs/accesstokenmanagement/index.mdx

@@ -29,18 +29,18 @@ var response = await client.RegisterClientAsync(new DynamicClientRegistrationReq
 ```
 
 :::note
-The *DynamicClientRegistrationDocument* class has strongly typed
+The `DynamicClientRegistrationDocument` class has strongly typed
 properties for all standard registration parameters as defines by the
 specification. If you want to add custom parameters, it is recommended
 to derive from this class and add your own properties.
 :::
 
-The response is of type *RegistrationResponse* and has properties for
+The response is of type `RegistrationResponse` and has properties for
 the standard response parameters. You also have access to the raw
-response and to a parsed JSON document (via the *Raw* and *Json*
+response and to a parsed JSON document (via the `Raw` and `Json`
 properties).
 
-Before using the response, you should always check the *IsError*
+Before using the response, you should always check the `IsError`
 property to make sure the request was successful:
 
 ```csharp

src/content/docs/identitymodel/endpoints/device-authorize.md

@@ -10,7 +10,7 @@ redirect_from:
 
 The client library for [OAuth 2.0 token
 revocation](https://tools.ietf.org/html/rfc7009) is provided as an
-extension method for *HttpClient*.
+extension method for `HttpClient`.
 
 The following code revokes an access token at a revocation
 endpoint:
@@ -28,11 +28,11 @@ var result = await client.RevokeTokenAsync(new TokenRevocationRequest
 });
 ```
 
-The response is of type *TokenRevocationResponse* gives you access to
-the raw response and to a parsed JSON document (via the *Raw*
-and *Json* properties).
+The response is of type `TokenRevocationResponse` gives you access to
+the raw response and to a parsed JSON document (via the `Raw`
+and `Json` properties).
 
-Before using the response, you should always check the *IsError*
+Before using the response, you should always check the `IsError`
 property to make sure the request was successful:
 
 ```csharp

src/content/docs/identitymodel/endpoints/dynamic-registration.md

@@ -11,15 +11,15 @@ redirect_from:
 The client library for the token endpoint ([OAuth
 2.0](https://tools.ietf.org/html/rfc6749#section-3.2) and [OpenID
 Connect](https://openid.net/specs/openid-connect-core-1_0.html#tokenendpoint))
-is provided as a set of extension methods for *HttpClient*. This allows
-creating and managing the lifetime of the *HttpClient* the way you
-prefer - e.g. statically or via a factory like the Microsoft
-*HttpClientFactory*.
+is provided as a set of extension methods for `HttpClient`. This allows
+creating and managing the lifetime of the `HttpClient` the way you
+prefer: statically or via a factory like the Microsoft
+`HttpClientFactory`.
 
 Requesting a token
 ------------------
 
-The main extension method is called *RequestTokenAsync* - it has direct
+The main extension method is called `RequestTokenAsync`. It has direct
 support for standard parameters like client ID/secret (or assertion) and
 grant type, but it also allows setting arbitrary other parameters via a
 dictionary. All other extensions methods ultimately call this method
@@ -44,12 +44,12 @@ var response = await client.RequestTokenAsync(new TokenRequest
 });
 ```
 
-The response is of type *TokenResponse* and has properties for the
-standard token response parameters like *access_token*, *expires_in*
+The response is of type `TokenResponse` and has properties for the
+standard token response parameters like `access_token`, `expires_in`
 etc. You also have access to the raw response and to a parsed
-JSON document (via the *Raw* and *Json* properties).
+JSON document (via the `Raw` and `Json` properties).
 
-Before using the response, you should always check the *IsError*
+Before using the response, you should always check the `IsError`
 property to make sure the request was successful:
 
 ```csharp
@@ -59,11 +59,11 @@ var token = response.AccessToken;
 var custom = response.Json.TryGetString("custom_parameter");
 ```
 
-Requesting a token using the *client_credentials* Grant Type
+Requesting a token using the `client_credentials` Grant Type
 ------------------------------------------------------------
 
-The *RequestClientCredentialsToken* extension method has convenience
-properties for the *client_credentials* grant type:
+The `RequestClientCredentialsToken` extension method has convenience
+properties for the `client_credentials` grant type:
 
 ```csharp
 var response = await client.RequestClientCredentialsTokenAsync(new ClientCredentialsTokenRequest
@@ -76,11 +76,11 @@ var response = await client.RequestClientCredentialsTokenAsync(new ClientCredent
 });
 ```
 
-Requesting a token using the *password* Grant Type
+Requesting a token using the `password` Grant Type
 --------------------------------------------------
 
-The *RequestPasswordToken* extension method has convenience properties
-for the *password* grant type:
+The `RequestPasswordToken` extension method has convenience properties
+for the `password` grant type:
 
 ```csharp
 var response = await client.RequestPasswordTokenAsync(new PasswordTokenRequest
@@ -96,11 +96,11 @@ var response = await client.RequestPasswordTokenAsync(new PasswordTokenRequest
 });
 ```
 
-Requesting a token using the *authorization_code* Grant Type
+Requesting a token using the `authorization_code` Grant Type
 ------------------------------------------------------------
 
-The *RequestAuthorizationCodeToken* extension method has convenience
-properties for the *authorization_code* grant type and PKCE:
+The `RequestAuthorizationCodeToken` extension method has convenience
+properties for the `authorization_code` grant type and PKCE:
 
 ```csharp
 var response = await client.RequestAuthorizationCodeTokenAsync(new AuthorizationCodeTokenRequest
@@ -118,11 +118,11 @@ var response = await client.RequestAuthorizationCodeTokenAsync(new Authorization
 });
 ```
 
-Requesting a token using the *refresh_token* Grant Type
+Requesting a token using the `refresh_token` Grant Type
 -------------------------------------------------------
 
-The *RequestRefreshToken* extension method has convenience properties
-for the *refresh_token* grant type:
+The `RequestRefreshToken` extension method has convenience properties
+for the `refresh_token` grant type:
 
 ```csharp
 var response = await _client.RequestRefreshTokenAsync(new RefreshTokenRequest
@@ -139,8 +139,8 @@ var response = await _client.RequestRefreshTokenAsync(new RefreshTokenRequest
 Requesting a Device Token
 -------------------------
 
-The *RequestDeviceToken* extension method has convenience properties for
-the *urn:ietf:params:oauth:grant-type:device_code* grant type:
+The `RequestDeviceToken` extension method has convenience properties for
+the `urn:ietf:params:oauth:grant-type:device_code` grant type:
 
 ```csharp
 var response = await client.RequestDeviceTokenAsync(new DeviceTokenRequest

src/content/docs/identitymodel/endpoints/revocation.md

@@ -9,7 +9,7 @@ redirect_from:
 
 The client library for the [OpenID Connect
 UserInfo](https://openid.net/specs/openid-connect-core-1_0.html#userinfo)
-endpoint is provided as an extension method for *HttpClient*.
+endpoint is provided as an extension method for `HttpClient`.
 
 The following code sends an access token to the UserInfo endpoint:
 
@@ -23,12 +23,12 @@ var response = await client.GetUserInfoAsync(new UserInfoRequest
 });
 ```
 
-The response is of type *UserInfoResponse* and has properties for the
+The response is of type `UserInfoResponse` and has properties for the
 standard response parameters. You also have access to the raw
-response and to a parsed JSON document (via the *Raw* and *Json*
+response and to a parsed JSON document (via the `Raw` and `Json`
 properties).
 
-Before using the response, you should always check the *IsError*
+Before using the response, you should always check the `IsError`
 property to make sure the request was successful:
 
 ```csharp

src/content/docs/identitymodel/endpoints/token.md

@@ -77,7 +77,7 @@ builder.Services.Configure<ForwardedHeadersOptions>(options =>
                                 ForwardedHeaders.XForwardedProto;
 
     // exact Addresses of known proxies to accept forwarded headers from.
-    options.KnownProxies.Add(IPAddress.Parse("203.0.113.42"); // <-- change this value to the IP Address of the proxy
+    options.KnownProxies.Add(IPAddress.Parse("203.0.113.42")); // <-- change this value to the IP Address of the proxy
 
     // if the proxies could use any address from a block, that can be configured too:
     // var network = new IPNetwork(IPAddress.Parse("198.51.100.0"), 24);