C# OAuth2（開発者向けの動作方法）

OAuth2クライアントのセットアップ

まず、OAuth2 認可サーバーにC#アプリケーションを登録する必要があります。 このプロセスはサーバーによって異なりますが、通常はクライアントIDとクライアントシークレットを受け取ります。これらはOAuth2フローにとって重要です。

ステップ 1：アプリケーションの資格情報を定義する

最初のステップとして、クライアントIDおよびクライアントシークレットのようなクライアントの資格情報をセットアップします。 以下はサンプルコードです：

// Define your client credentials
class Program
{
    private static string clientId = "your-client-id"; // Your client ID
    private static string clientSecret = "your-client-secret"; // Your client secret
    private static string redirectUri = "your-redirect-uri"; // Your redirect URI
    static void Main(string[] args)
    {
        // OAuth2 implementation will go here
    }
}

// Define your client credentials
class Program
{
    private static string clientId = "your-client-id"; // Your client ID
    private static string clientSecret = "your-client-secret"; // Your client secret
    private static string redirectUri = "your-redirect-uri"; // Your redirect URI
    static void Main(string[] args)
    {
        // OAuth2 implementation will go here
    }
}

ステップ 2： ユーザー認証のリクエスト

OAuth2 フローを開始するには、ユーザーを認可サーバーの認可エンドポイントにリダイレクトします。 認可リクエスト用URLの構築方法は以下の通りです：

static void Main(string[] args)
{
    var authorizationEndpoint = "https://authorization-server.com/auth"; // Authorization server endpoint
    var responseType = "code"; // Response type for authorization
    var scope = "email profile"; // Scopes for the authorization request
    var authorizationUrl = $"{authorizationEndpoint}?response_type={responseType}&client_id={clientId}&redirect_uri={redirectUri}&scope={scope}";
    // Redirect the user to authorizationUrl
}

static void Main(string[] args)
{
    var authorizationEndpoint = "https://authorization-server.com/auth"; // Authorization server endpoint
    var responseType = "code"; // Response type for authorization
    var scope = "email profile"; // Scopes for the authorization request
    var authorizationUrl = $"{authorizationEndpoint}?response_type={responseType}&client_id={clientId}&redirect_uri={redirectUri}&scope={scope}";
    // Redirect the user to authorizationUrl
}

ステップ 3：認可応答の処理

ユーザーが許可または拒否した後、認可サーバーは認可コードまたはエラーメッセージと一緒にユーザーをアプリケーションにリダイレクトします。 リダイレクトURIのクエリパラメータからこのコードをキャプチャする必要があります。

ステップ 4：認可コードの交換

次に、認可コードをアクセストークンに交換します。 これは認可サーバーのトークンエンドポイントへのPOSTリクエストを必要とします。

using System.IO;
using System.Net;
using System.Text;
using System.Threading.Tasks;

// Method to exchange authorization code for an access token
public static async Task<string> ExchangeAuthorizationCodeForAccessToken(string authorizationCode)
{
    var tokenEndpoint = "https://authorization-server.com/token"; // Token endpoint
    var postData = $"grant_type=authorization_code&code={authorizationCode}&redirect_uri={redirectUri}&client_id={clientId}&client_secret={clientSecret}";
    var data = Encoding.ASCII.GetBytes(postData);
    var request = WebRequest.Create(tokenEndpoint);
    request.Method = "POST"; // Use post method to request the access token
    request.ContentType = "application/x-www-form-urlencoded"; // Content type
    request.ContentLength = data.Length;
    using (var stream = request.GetRequestStream())
    {
        stream.Write(data, 0, data.Length);
    }
    var response = (HttpWebResponse)request.GetResponse();
    var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
    // Extract and return the access token from the response
    var token = ExtractAccessTokenFromResponse(responseString);
    return token;
}

using System.IO;
using System.Net;
using System.Text;
using System.Threading.Tasks;

// Method to exchange authorization code for an access token
public static async Task<string> ExchangeAuthorizationCodeForAccessToken(string authorizationCode)
{
    var tokenEndpoint = "https://authorization-server.com/token"; // Token endpoint
    var postData = $"grant_type=authorization_code&code={authorizationCode}&redirect_uri={redirectUri}&client_id={clientId}&client_secret={clientSecret}";
    var data = Encoding.ASCII.GetBytes(postData);
    var request = WebRequest.Create(tokenEndpoint);
    request.Method = "POST"; // Use post method to request the access token
    request.ContentType = "application/x-www-form-urlencoded"; // Content type
    request.ContentLength = data.Length;
    using (var stream = request.GetRequestStream())
    {
        stream.Write(data, 0, data.Length);
    }
    var response = (HttpWebResponse)request.GetResponse();
    var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
    // Extract and return the access token from the response
    var token = ExtractAccessTokenFromResponse(responseString);
    return token;
}

この関数は、必要なデータを含むPOSTリクエストをトークンエンドポイントに送信し、レスポンスから取得したアクセストークンを返します。

ステップ 5：認証されたリクエストの作成

アクセストークンを使用して、認証が必要なリソースへのリクエストを作成できます。 アクセストークンをAuthorizationヘッダーにBearerトークンとして付加します。

using System.Net.Http;
using System.Threading.Tasks;

// Method to make authorized requests
public static async Task<string> MakeAuthorizedRequest(string accessToken, string apiUrl)
{
    var httpClient = new HttpClient();
    httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", accessToken);
    // Make the request to the API
    var response = await httpClient.GetAsync(apiUrl);
    response.EnsureSuccessStatusCode();
    var responseString = await response.Content.ReadAsStringAsync();
    return responseString;
}

using System.Net.Http;
using System.Threading.Tasks;

// Method to make authorized requests
public static async Task<string> MakeAuthorizedRequest(string accessToken, string apiUrl)
{
    var httpClient = new HttpClient();
    httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", accessToken);
    // Make the request to the API
    var response = await httpClient.GetAsync(apiUrl);
    response.EnsureSuccessStatusCode();
    var responseString = await response.Content.ReadAsStringAsync();
    return responseString;
}

コード例：保護されたコンテンツからPDFを生成する

認証済みユーザーにのみアクセス可能なHTMLコンテンツを返すエンドポイントを持っていると想像してください。 このHTMLコンテンツを、OAuth2を介して取得したアクセストークンを利用してIronPDFを使用してPDFドキュメントに変換できます。

まず、アクセストークンを使用して保護されたHTMLコンテンツを取得するメソッドを定義しましょう：

using System.Net.Http;
using System.Threading.Tasks;

// Method to fetch protected content
public static async Task<string> FetchProtectedContent(string accessToken, string apiUrl)
{
    var httpClient = new HttpClient();
    httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", accessToken);
    var response = await httpClient.GetAsync(apiUrl); // Make the request to the protected API
    response.EnsureSuccessStatusCode();
    return await response.Content.ReadAsStringAsync(); // Return the HTML content
}

using System.Net.Http;
using System.Threading.Tasks;

// Method to fetch protected content
public static async Task<string> FetchProtectedContent(string accessToken, string apiUrl)
{
    var httpClient = new HttpClient();
    httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", accessToken);
    var response = await httpClient.GetAsync(apiUrl); // Make the request to the protected API
    response.EnsureSuccessStatusCode();
    return await response.Content.ReadAsStringAsync(); // Return the HTML content
}

次に、取得したHTMLコンテンツをIronPDFを使用してPDFドキュメントに変換しましょう：

using IronPdf;

// Method to convert HTML content to PDF
public static async Task ConvertHtmlToPdf(string accessToken, string apiUrl, string outputPdfPath)
{
    // Fetch protected content using the access token
    string htmlContent = await FetchProtectedContent(accessToken, apiUrl);
    // Use IronPDF to convert the HTML content to a PDF document
    var renderer = new IronPdf.HtmlToPdf();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Save the generated PDF to a file
    pdf.SaveAs(outputPdfPath);
}

using IronPdf;

// Method to convert HTML content to PDF
public static async Task ConvertHtmlToPdf(string accessToken, string apiUrl, string outputPdfPath)
{
    // Fetch protected content using the access token
    string htmlContent = await FetchProtectedContent(accessToken, apiUrl);
    // Use IronPDF to convert the HTML content to a PDF document
    var renderer = new IronPdf.HtmlToPdf();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Save the generated PDF to a file
    pdf.SaveAs(outputPdfPath);
}

上記のコードでは、FetchProtectedContentがOAuth2アクセストークンを使用して保護されたリソースからHTMLコンテンツを取得する役割を果たします。 HTMLコンテンツが取得されると、それはIronPDFのHtmlToPdfレンダラーに渡され、PDFドキュメントが生成され、指定されたパスに保存されます。