Update the documentation pages

guide/getting-started.html

@@ -103,9 +103,9 @@ Here's an example for the client credentials grant, used in machine-to-machi
         .AddCore(options =>
         {
             // Configure OpenIddict to use the Entity Framework Core stores and models.
-            // Note: call ReplaceDefaultEntities() to replace the default OpenIddict entities.
+            // Note: call ReplaceDefaultEntities() to replace the default entities.
             options.UseEntityFrameworkCore()
-                  .UseDbContext<ApplicationDbContext>();
+                   .UseDbContext<ApplicationDbContext>();
         })
 
         // Register the OpenIddict server components.
@@ -121,7 +121,7 @@ Here's an example for the client credentials grant, used in machine-to-machi
             options.AddDevelopmentEncryptionCertificate()
                   .AddDevelopmentSigningCertificate();
 
-            // Register the ASP.NET Core host and configure the ASP.NET Core-specific options.
+            // Register the ASP.NET Core host and configure the ASP.NET Core options.
             options.UseAspNetCore()
                   .EnableTokenEndpointPassthrough();
         })
@@ -173,7 +173,7 @@ Here's an example for the client credentials grant, used in machine-to-machi
 });
 </code></pre></li>
 </ul>
-<p>-&gt; [!NOTE]</p>
+<p>-&gt; [!WARNING]</p>
 <blockquote><p>Important: if you change the default entity primary key (e.g. to <code>int</code> or <code>Guid</code> instead of <code>string</code>), make sure you use the <code>options.ReplaceDefaultEntities&lt;TKey&gt;()</code>
 core extension accepting a <code>TKey</code> generic argument and use the generic <code>options.UseOpenIddict&lt;TKey&gt;()</code> overload to configure Entity Framework Core to use the specified key type:</p>
 <pre><code class="lang-csharp">services.AddOpenIddict()
@@ -199,43 +199,43 @@ Implementing a custom authorization controller is required to allow OpenIddict t
 Here&#39;s an example for the client credentials grant:</p>
 <pre><code class="lang-csharp">public class AuthorizationController : Controller
 {
-    private readonly OpenIddictApplicationManager&lt;OpenIddictEntityFrameworkCoreApplication&gt; _applicationManager;
+    private readonly IOpenIddictApplicationManager_applicationManager;
 
-    public AuthorizationController(OpenIddictApplicationManager&lt;OpenIddictEntityFrameworkCoreApplication&gt; applicationManager)
+    public AuthorizationController(IOpenIddictApplicationManager applicationManager)
         =&gt; _applicationManager = applicationManager;
 
     [HttpPost(&quot;~/connect/token&quot;), Produces(&quot;application/json&quot;)]
     public async Task&lt;IActionResult&gt; Exchange()
     {
         var request = HttpContext.GetOpenIddictServerRequest();
-        if (request.IsClientCredentialsGrantType())
+        if (!request.IsClientCredentialsGrantType())
         {
-            // Note: the client credentials are automatically validated by OpenIddict:
+            throw new NotImplementedException(&quot;The specified grant type is not implemented.&quot;);
-            // if client_id or client_secret are invalid, this action won&#39;t be invoked.
-
-            var application = await _applicationManager.FindByClientIdAsync(request.ClientId);
-            if (application == null)
-            {
-                throw new InvalidOperationException(&quot;The application details cannot be found in the database.&quot;);
-            }
-
-            // Create a new ClaimsIdentity containing the claims that
-            // will be used to create an id_token, a token or a code.
-            var identity = new ClaimsIdentity(
-                TokenValidationParameters.DefaultAuthenticationType,
-                Claims.Name, Claims.Role);
-
-            // Use the client_id as the subject identifier.
-            identity.AddClaim(Claims.Subject, await _applicationManager.GetClientIdAsync(application),
-                Destinations.AccessToken, Destinations.IdentityToken);
-
-            identity.AddClaim(Claims.Name, await _applicationManager.GetDisplayNameAsync(application),
-                Destinations.AccessToken, Destinations.IdentityToken);
-
-            return SignIn(new ClaimsPrincipal(identity), OpenIddictServerAspNetCoreDefaults.AuthenticationScheme);
         }
 
-        throw new NotImplementedException(&quot;The specified grant type is not implemented.&quot;);
+        // Note: the client credentials are automatically validated by OpenIddict:
+        // if client_id or client_secret are invalid, this action won&#39;t be invoked.
+
+        var application = await _applicationManager.FindByClientIdAsync(request.ClientId);
+        if (application == null)
+        {
+            throw new InvalidOperationException(&quot;The application details cannot be found in the database.&quot;);
+        }
+
+        // Create a new ClaimsIdentity containing the claims that
+        // will be used to create an id_token, a token or a code.
+        var identity = new ClaimsIdentity(
+            TokenValidationParameters.DefaultAuthenticationType,
+            Claims.Name, Claims.Role);
+
+        // Use the client_id as the subject identifier.
+        identity.AddClaim(Claims.Subject, await _applicationManager.GetClientIdAsync(application),
+            Destinations.AccessToken, Destinations.IdentityToken);
+
+        identity.AddClaim(Claims.Name, await _applicationManager.GetDisplayNameAsync(application),
+            Destinations.AccessToken, Destinations.IdentityToken);
+
+        return SignIn(new ClaimsPrincipal(identity), OpenIddictServerAspNetCoreDefaults.AuthenticationScheme);
     }
 }
 </code></pre></li>
@@ -254,7 +254,7 @@ Here&#39;s an example for the client credentials grant:</p>
         var context = scope.ServiceProvider.GetRequiredService&lt;ApplicationDbContext&gt;();
         await context.Database.EnsureCreatedAsync();
 
-        var manager = scope.ServiceProvider.GetRequiredService&lt;OpenIddictApplicationManager&lt;OpenIddictEntityFrameworkCoreApplication&gt;&gt;();
+        var manager = scope.ServiceProvider.GetRequiredService&lt;IOpenIddictApplicationManager&gt;();
 
         if (await manager.FindByClientIdAsync(&quot;console&quot;) is null)
         {

manifest.json

@@ -45,7 +45,7 @@
       "output": {
         ".html": {
           "relative_path": "guide/getting-started.html",
-          "hash": "B+LUpBca5+kh6NFTvwCenQ=="
+          "hash": "EubGbQd6qMqQ/UD3oj2WIw=="
         }
       },
       "is_incremental": false,