Dotnetopenauth .NET Core（開発者向けの動作方法）

.NETオープンオース .NET Core for .NETプロジェクトへの設定

Microsoft技術にサポートされている.NETオープンオース .NET Coreをあなた for .NETプロジェクトで使用し始めるには、次の手順に従ってください:

1. Visual Studioでプロジェクトを開きます。
2. ソリューションエクスプローラに移動します。
3. プロジェクト名を右クリックします。
4. Manage NuGet Packagesを選択します。
5. NuGetパッケージ マネージャーで、DotNetOpenAuth.NetCore およびその他のNuGetパッケージを検索します。
6. Install をクリックしてプロジェクトに追加します。

これにより、.NETオープンオース .NET Coreライブラリがプロジェクトに追加され、認証機能を統合するサポートが提供されます。

DotNetOpenAuth .NET Coreを使用した基本コード例

ここに、.NETオープンオース .NET Coreを使用してアプリケーションでOAuth2認証をセットアップする方法を示すシンプルな例があります:

using DotNetOpenAuth.OAuth2;

// Initialize the OAuth2 client with the authorization server details
var client = new WebServerClient(new AuthorizationServerDescription
{
    TokenEndpoint = new Uri("https://your-auth-server.com/token"),
    AuthorizationEndpoint = new Uri("https://your-auth-server.com/authorize")
}, "your-client-id", "your-client-secret");

// Start the authentication process and get the authorization state
IAuthorizationState state = client.ProcessUserAuthorization();
if (state != null && state.IsAuthorized)
{
    // Authorized successfully, now you can access protected resources
}

using DotNetOpenAuth.OAuth2;

// Initialize the OAuth2 client with the authorization server details
var client = new WebServerClient(new AuthorizationServerDescription
{
    TokenEndpoint = new Uri("https://your-auth-server.com/token"),
    AuthorizationEndpoint = new Uri("https://your-auth-server.com/authorize")
}, "your-client-id", "your-client-secret");

// Start the authentication process and get the authorization state
IAuthorizationState state = client.ProcessUserAuthorization();
if (state != null && state.IsAuthorized)
{
    // Authorized successfully, now you can access protected resources
}

このコードスニペットは、.NETオープンオース .NET Coreを使用してOAuth2クライアントをセットアップし、認証サーバーに接続してユーザー認証を処理します。

OpenID Connectの統合

.NETオープンオース .NET Coreを使用してOpenID Connectを統合するには、次の基本的なアプローチを使用できます:

using DotNetOpenAuth.OAuth2;

// Configure the OpenID Connect client with authority details
var openIdClient = new WebServerClient(new AuthorizationServerDescription
{
    TokenEndpoint = new Uri("https://your-openid-provider.com/token"),
    AuthorizationEndpoint = new Uri("https://your-openid-provider.com/authorize")
}, "your-client-id");

// Redirect user for authentication
Uri authUri = openIdClient.GetAuthorizationRequestUri("openid email profile");
Response.Redirect(authUri.AbsoluteUri);

using DotNetOpenAuth.OAuth2;

// Configure the OpenID Connect client with authority details
var openIdClient = new WebServerClient(new AuthorizationServerDescription
{
    TokenEndpoint = new Uri("https://your-openid-provider.com/token"),
    AuthorizationEndpoint = new Uri("https://your-openid-provider.com/authorize")
}, "your-client-id");

// Redirect user for authentication
Uri authUri = openIdClient.GetAuthorizationRequestUri("openid email profile");
Response.Redirect(authUri.AbsoluteUri);

このコードはOpenID Connectクライアントを設定し、ユーザーをOpenIDプロバイダーの認証ページにリダイレクトします。

アクセストークンの処理

.NETオープンオース .NET Coreでのアクセストークンの処理方法はこちらです:

// After the user is authenticated, process the authorization response to retrieve the token
IAuthorizationState authState = openIdClient.ProcessUserAuthorization();
if (authState != null && authState.IsAuthorized)
{
    // Access token is available, and you can use it to make authenticated requests
    string accessToken = authState.AccessToken;
}

// After the user is authenticated, process the authorization response to retrieve the token
IAuthorizationState authState = openIdClient.ProcessUserAuthorization();
if (authState != null && authState.IsAuthorized)
{
    // Access token is available, and you can use it to make authenticated requests
    string accessToken = authState.AccessToken;
}

このスニペットはユーザー認証レスポンスを処理し、アクセストークンを取得して使用します。

トークンの更新

トークンが期限切れになったときに更新するには、次のコードを使用します:

// Check if the access token is expired and refresh it
if (authState.AccessTokenExpirationUtc <= DateTime.UtcNow)
{
    if (openIdClient.RefreshAuthorization(authState))
    {
        // Token refreshed successfully
    }
}

// Check if the access token is expired and refresh it
if (authState.AccessTokenExpirationUtc <= DateTime.UtcNow)
{
    if (openIdClient.RefreshAuthorization(authState))
    {
        // Token refreshed successfully
    }
}

このコードは現在のトークンが期限切れかどうかをチェックし、更新を試みます。

トークンの取り消し

トークンを取り消す必要がある場合は、以下のように実装します:

// Revoke the access token
bool success = openIdClient.RevokeAuthorization(authState);
if (success)
{
    // Token revoked successfully
}

// Revoke the access token
bool success = openIdClient.RevokeAuthorization(authState);
if (success)
{
    // Token revoked successfully
}

このスニペットは認証を取り消し、効果的にアクセストークンを無効化します。

トークンリクエストのカスタマイズ

特定のニーズに応じてトークンリクエストをカスタマイズするには、追加のパラメーターを加えることができます:

// Customize the token request with additional parameters
var additionalParams = new Dictionary<string, string>
{
    {"custom_parameter", "value"}
};
IAuthorizationState customizedState = openIdClient.ProcessUserAuthorization(additionalParams);
if (customizedState != null && customizedState.IsAuthorized)
{
    // Token request customized and processed successfully
}

// Customize the token request with additional parameters
var additionalParams = new Dictionary<string, string>
{
    {"custom_parameter", "value"}
};
IAuthorizationState customizedState = openIdClient.ProcessUserAuthorization(additionalParams);
if (customizedState != null && customizedState.IsAuthorized)
{
    // Token request customized and processed successfully
}

このコードはトークンリクエストにカスタムパラメーターを追加し、認可サーバーの特定の要件に対応するのに役立ちます。

.NETオープンオース .NET CoreとIronPDFを統合した使用例

認証されたユーザーが個別のレポートを生成してダウンロードする必要があるウェブアプリケーションで、.NETオープンオース .NET CoreとIronPDFを統合した実用的な使用例があります。 たとえば、ユーザーがアプリケーションにログインして、PDF形式の財務レポートにアクセスする状況を考えてみてください。 .NETオープンオースは、ユーザーが適切に認証されており、ドキュメントへのアクセスが許可されていることを保証し、IronPDFはこれらの個別のPDFの作成と配信を処理します。

ユースケースのコード例

これを実装する方法を示す完全なコード例を見てみましょう。 私たちは、ユーザーを認証し、その後、IronPDFを使用してPDFレポートを生成する簡単な.NET CoreウェブAPIを作成します:

using IronPdf;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Authorization;

[Route("api/[controller]")]
[ApiController]
public class ReportController : ControllerBase
{
    [Authorize]
    [HttpGet("download-pdf")]
    public IActionResult DownloadPdfReport()
    {
        // Authentication is handled by DotNetOpenAuth .NET Core
        var currentUser = HttpContext.User.Identity.Name;

        // Generate PDF content using IronPDF
        var Renderer = new ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf($"<h1>Report for {currentUser}</h1><p>This is your personalized financial report.</p>");

        // Set file name and content type for the PDF
        var outputFileName = $"Report-{currentUser}.pdf";
        Response.Headers.Add("Content-Disposition", $"attachment; filename={outputFileName}");
        Response.ContentType = "application/pdf";

        // Return the generated PDF file
        return File(PDF.Stream.ToArray(), "application/pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Authorization;

[Route("api/[controller]")]
[ApiController]
public class ReportController : ControllerBase
{
    [Authorize]
    [HttpGet("download-pdf")]
    public IActionResult DownloadPdfReport()
    {
        // Authentication is handled by DotNetOpenAuth .NET Core
        var currentUser = HttpContext.User.Identity.Name;

        // Generate PDF content using IronPDF
        var Renderer = new ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf($"<h1>Report for {currentUser}</h1><p>This is your personalized financial report.</p>");

        // Set file name and content type for the PDF
        var outputFileName = $"Report-{currentUser}.pdf";
        Response.Headers.Add("Content-Disposition", $"attachment; filename={outputFileName}");
        Response.ContentType = "application/pdf";

        // Return the generated PDF file
        return File(PDF.Stream.ToArray(), "application/pdf");
    }
}

この例では、[Authorize] 属性を使用して、認証されたユーザーのみが PDF 生成エンドポイントにアクセスできるようにします。 IronPDFの ChromePdfRenderer クラスは、HTML コンテンツから PDF を作成するために使用されます。この場合、PDF はユーザーの名前で動的にパーソナライズされます。