lsm/openiddict-documentation
1
0
Fork 0
mirror of https://gitee.com/dcren/openiddict-documentation.git synced 2025-07-15 14:04:34 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update the documentation pages

Browse Source
This commit is contained in:
OpenIddict Bot 2021-01-13 04:53:51 +00:00
parent c24ded39ce
commit 8263d95312
2 changed files with 33 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
guide/getting-started.html
View File

@ -103,7 +103,7 @@ Here's an example for the client credentials grant, used in machine-to-machi
.AddCore(options => .AddCore(options =>
{ {
// Configure OpenIddict to use the Entity Framework Core stores and models. // 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() options.UseEntityFrameworkCore()
.UseDbContext<ApplicationDbContext>(); .UseDbContext<ApplicationDbContext>();
}) })
@ -121,7 +121,7 @@ Here's an example for the client credentials grant, used in machine-to-machi
options.AddDevelopmentEncryptionCertificate() options.AddDevelopmentEncryptionCertificate()
.AddDevelopmentSigningCertificate(); .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() options.UseAspNetCore()
.EnableTokenEndpointPassthrough(); .EnableTokenEndpointPassthrough();
}) })
@ -173,7 +173,7 @@ Here's an example for the client credentials grant, used in machine-to-machi
}); });
</code></pre></li> </code></pre></li>
</ul> </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> <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> 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() <pre><code class="lang-csharp">services.AddOpenIddict()
@ -199,17 +199,20 @@ Implementing a custom authorization controller is required to allow OpenIddict t
Here&#39;s an example for the client credentials grant:</p> Here&#39;s an example for the client credentials grant:</p>
<pre><code class="lang-csharp">public class AuthorizationController : Controller <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; =&gt; _applicationManager = applicationManager;
[HttpPost(&quot;~/connect/token&quot;), Produces(&quot;application/json&quot;)] [HttpPost(&quot;~/connect/token&quot;), Produces(&quot;application/json&quot;)]
public async Task&lt;IActionResult&gt; Exchange() public async Task&lt;IActionResult&gt; Exchange()
{ {
var request = HttpContext.GetOpenIddictServerRequest(); var request = HttpContext.GetOpenIddictServerRequest();
if (request.IsClientCredentialsGrantType()) if (!request.IsClientCredentialsGrantType())
{ {
throw new NotImplementedException(&quot;The specified grant type is not implemented.&quot;);
}
// Note: the client credentials are automatically validated by OpenIddict: // Note: the client credentials are automatically validated by OpenIddict:
// if client_id or client_secret are invalid, this action won&#39;t be invoked. // if client_id or client_secret are invalid, this action won&#39;t be invoked.
@ -234,9 +237,6 @@ Here&#39;s an example for the client credentials grant:</p>
return SignIn(new ClaimsPrincipal(identity), OpenIddictServerAspNetCoreDefaults.AuthenticationScheme); return SignIn(new ClaimsPrincipal(identity), OpenIddictServerAspNetCoreDefaults.AuthenticationScheme);
} }
throw new NotImplementedException(&quot;The specified grant type is not implemented.&quot;);
}
} }
</code></pre></li> </code></pre></li>
<li><p><strong>Register your client application</strong> (e.g from an <code>IHostedService</code> implementation):</p> <li><p><strong>Register your client application</strong> (e.g from an <code>IHostedService</code> implementation):</p>
@ -254,7 +254,7 @@ Here&#39;s an example for the client credentials grant:</p>
var context = scope.ServiceProvider.GetRequiredService&lt;ApplicationDbContext&gt;(); var context = scope.ServiceProvider.GetRequiredService&lt;ApplicationDbContext&gt;();
await context.Database.EnsureCreatedAsync(); 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) if (await manager.FindByClientIdAsync(&quot;console&quot;) is null)
{ {

2
manifest.json
View File

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