WPF または WinForms アプリケーションにログインを追加する

.NET 向け Auth0 OIDC Client を使用して、WPF または WinForms アプリケーションに Auth0 のログイン、ログアウト、ユーザープロファイルを追加します

AI を使って Auth0 を統合する

Claude Code、Cursor、GitHub Copilot などの AI コーディングアシスタントを使用している場合は、agent skills を使って数分で Auth0 の認証を自動的に追加できます。

インストール:

npx skills add auth0/agent-skills --skill auth0

次に、AI アシスタントに次のように依頼します。

Add Auth0 authentication to my WPF or WinForms app

AI アシスタントは、Auth0 アプリケーションの作成、資格情報の取得、Auth0 OidcClient SDK のインストール、コールバックURL の設定、ログイン/ログアウト フローの実装を自動的に行います。agent skills の完全なドキュメント →

前提条件: 開始する前に、次のものを用意してください。

• .NET 8.0 SDK 以降 (レガシープロジェクトの場合は .NET Framework 4.6.2)
• Visual Studio 2022 または C# Dev Kit を備えた VS Code

.NET バージョンの互換性: この Quickstart は .NET 8.0、.NET 9.0、および .NET Framework 4.6.2 に対応しています。

​

はじめに

このクイックスタートでは、WPF または WinForms のデスクトップアプリケーションに Auth0 の authentication を追加する方法を紹介します。Auth0 を設定し、SDK をインストールして、WPF および WinForms 用の Auth0 OIDC Client を使用し、ログイン、ログアウト、ユーザープロファイルの表示を追加します。

1. アプリケーションを作成する

   すでに WPF または WinForms のプロジェクトがある場合は、次のステップに進んでください。

   .NET CLI

   新しいプロジェクトを作成し、そのディレクトリを開きます。

   WPF

   dotnet new wpf -n MyApp
   cd MyApp
   

   WinForms

   dotnet new winforms -n MyApp
   cd MyApp
   

   Visual Studio

   1. Visual Studio 2022 を開き、Create a new project をクリックします
   2. WPF Application または Windows Forms App を検索します
   3. C# テンプレートを選択し、Next をクリックします
   4. プロジェクト名を入力し、保存場所を選択して Next をクリックします
   5. ターゲット フレームワークとして .NET 8.0 (またはそれ以降) を選択し、Create をクリックします
2. Auth0 を設定する

   Auth0 のサービスを利用するには、Auth0 Dashboard でアプリケーションを設定しておく必要があります。Auth0 アプリケーションでは、プロジェクトで認証をどのように行うかを設定します。

   ​

   アプリケーションを設定する

   Auth0 Dashboard → Applications → Applications に移動し、新しいアプリケーションを作成します。

   1. Create Application をクリックします
   2. アプリケーションの名前を入力します
   3. アプリケーションの種類として Native を選択します
   4. Create をクリックします

   Settings タブで、Domain と Client ID を控えておきます。SDK を初期化する際に必要になります。

   ​

   Callback URL を設定する

   callback URL は、ユーザーの認証後に Auth0 がリダイレクトする、アプリケーション内の URL です。これが設定されていないと、ユーザーはログイン後にアプリケーションへ戻れません。

   Application Settings で、次の内容を Allowed Callback URLs に追加します。

   https://{yourDomain}/mobile
   

   ​

   ログアウト URL を設定する

   ログアウト URL とは、ユーザーのログアウト後に Auth0 がリダイレクトするアプリケーション内の URL のことです。これが設定されていないと、ユーザーはアプリケーションからログアウトできず、エラーが表示されます。

   Application Settings で、Allowed Logout URLs に次を追加します。

   https://{yourDomain}/mobile
   
3. Auth0 SDK をインストールする

   Auth0 では、WPF 用と WinForms 用にそれぞれ別の NuGet パッケージを提供しています。プロジェクトの種類に合ったものをインストールしてください。

   NuGet パッケージ マネージャー

   Package Manager Console (Tools → NuGet Package Manager → Package Manager Console) を開き、次を実行します。

   # WPF
   Install-Package Auth0.OidcClient.WPF
   
   # WinForms
   Install-Package Auth0.OidcClient.WinForms
   

   .NET CLI

   # WPF
   dotnet add package Auth0.OidcClient.WPF
   
   # WinForms
   dotnet add package Auth0.OidcClient.WinForms
   
4. Auth0Client を作成する

   Auth0 をアプリケーションに統合するには、Auth0 の Domain と Client ID を指定して Auth0Client をインスタンス化します。プライベート フィールドを追加し、メイン ウィンドウまたはフォームの既存のコンストラクター内で初期化します。

   WPF

   MainWindow.xaml.cs を開き、次のように更新します。

   MainWindow.xaml.cs

   using Auth0.OidcClient;
   
   // アプリケーションに別の名前を付けた場合は、
   // それに合わせて名前空間も更新してください。
   namespace MyApp; 
   
   public partial class MainWindow : Window
   {
       private Auth0Client _client;
   
       public MainWindow()
       {
           InitializeComponent();
   
           _client = new Auth0Client(new Auth0ClientOptions
           {
               Domain = "{yourDomain}",
               ClientId = "{yourClientId}"
           });
       }
   }
   

   WinForms

   Form1.cs (またはメイン フォームのファイル) を開き、次のように更新します。

   Form1.cs

   using Auth0.OidcClient;
   
   // アプリケーションに別の名前を付けた場合は、
   // それに合わせて名前空間も更新してください。
   namespace MyApp;
   
   public partial class Form1 : Form
   {
       private Auth0Client _client;
   
       public Form1()
       {
           InitializeComponent();
   
           _client = new Auth0Client(new Auth0ClientOptions
           {
               Domain = "{yourDomain}",
               ClientId = "{yourClientId}"
           });
       }
   }
   
5. アプリケーションにログイン機能を追加する

   ユーザーをログインさせるには、SDK の LoginAsync() メソッドを使用します。このメソッドを呼び出すと、Auth0 Universal Login ページを表示するポップアップウィンドウが開きます。認証に成功すると、Auth0 はコールバック URL にリダイレクトし、SDK は LoginResult を返します。

   まず、UI にログインボタンを追加します。

   WPF

   MainWindow.xaml を開き、<Grid> 内に Button を追加します。

   MainWindow.xaml

   <Grid>
       <Button x:Name="LoginButton"
               Content="Log In"
               Width="120" Height="40"
               HorizontalAlignment="Center" VerticalAlignment="Center"
               Click="LoginButton_Click" />
   </Grid>
   

   次に、MainWindow.xaml.cs にクリック ハンドラーを追加します。

   MainWindow.xaml.cs

   private async void LoginButton_Click(object sender, RoutedEventArgs e)
   {
       var loginResult = await _client.LoginAsync();
   
       if (loginResult.IsError == false)
       {
           var user = loginResult.User;
           var name = user.FindFirst(c => c.Type == "name")?.Value;
           var email = user.FindFirst(c => c.Type == "email")?.Value;
           var picture = user.FindFirst(c => c.Type == "picture")?.Value;
       }
   }
   

   WinForms

   Form1.cs を開き、コンストラクター内でプログラムからログインボタンを追加し、その後クリック ハンドラーを追加します。

   Form1.cs

   using Auth0.OidcClient;
   
   namespace MyApp;
   
   public partial class Form1 : Form
   {
       private Auth0Client _client;
       private Button loginButton;
   
       public Form1()
       {
           InitializeComponent();
   
           _client = new Auth0Client(new Auth0ClientOptions
           {
               Domain = "{yourDomain}",
               ClientId = "{yourClientId}"
           });
   
           loginButton = new Button
           {
               Text = "Log In",
               Width = 120,
               Height = 40,
               Left = (ClientSize.Width - 120) / 2,
               Top = (ClientSize.Height - 40) / 2
           };
           loginButton.Click += loginButton_Click;
           Controls.Add(loginButton);
       }
   
       private async void loginButton_Click(object sender, EventArgs e)
       {
           var loginResult = await _client.LoginAsync();
   
           if (loginResult.IsError == false)
           {
               var user = loginResult.User;
               var name = user.FindFirst(c => c.Type == "name")?.Value;
               var email = user.FindFirst(c => c.Type == "email")?.Value;
               var picture = user.FindFirst(c => c.Type == "picture")?.Value;
           }
       }
   }
   

   エラーがなければ、結果の LoginResult.User、LoginResult.IdentityToken、LoginResult.AccessToken、LoginResult.RefreshToken にアクセスできます。

6. アプリケーションにlogoutを追加する

   ユーザーをログアウトするには、SDK の LogoutAsync() メソッドを使用します。これによりポップアップウィンドウが開き、セッションをクリアするために Auth0 の logout エンドポイントへリダイレクトされた後、設定したログアウト URL に戻ります。

   まず、UI にログアウトボタンを追加します。

   WPF

   MainWindow.xaml を開き、ログインボタンの横にログアウト用の Button を追加します。

   MainWindow.xaml

       <Grid>
   
           <StackPanel HorizontalAlignment="Center" VerticalAlignment="Center">
               <Button x:Name="LoginButton" Content="Login" Width="200" Height="40" 
                       Margin="10" Click="LoginButton_Click" FontSize="16"/>
               <Button x:Name="LogoutButton" Content="Logout" Width="200" Height="40" 
                       Margin="10" Click="LogoutButton_Click" FontSize="16"/>
           </StackPanel>
       </Grid>
   

   次に、MainWindow.xaml.cs にクリック ハンドラーを追加します。

   MainWindow.xaml.cs

   private async void LogoutButton_Click(object sender, RoutedEventArgs e)
   {
       await _client.LogoutAsync();
   }
   

   WinForms

   Form1.cs を開き、コンストラクターにログアウトボタンを追加して、そのクリック ハンドラーも追加します。

   Form1.cs

   private Button logoutButton;
   
   public Form1()
   {
       // ... 既存のコンストラクターコード ...
   
       logoutButton = new Button
       {
           Text = "Log Out",
           Width = 120,
           Height = 40,
           Left = (ClientSize.Width - 120) / 2,
           Top = (ClientSize.Height - 40) / 2 + 50
       };
       logoutButton.Click += logoutButton_Click;
       Controls.Add(logoutButton);
   }
   
   private async void logoutButton_Click(object sender, EventArgs e)
   {
       await _client.LogoutAsync();
   }
   
7. ユーザープロファイル情報を表示する

   LoginResult.User プロパティは、認証されたユーザーのプロファイルを含む ClaimsPrincipal です。claim を参照して、アプリケーションにユーザー情報を表示します。

   if (loginResult.IsError == false)
   {
       Debug.WriteLine($"name: {loginResult.User.FindFirst(c => c.Type == "name")?.Value}");
       Debug.WriteLine($"email: {loginResult.User.FindFirst(c => c.Type == "email")?.Value}");
   }
   

   ID トークンに含まれるすべてのクレームを確認するには:

   if (loginResult.IsError == false)
   {
       foreach (var claim in loginResult.User.Claims)
       {
           Debug.WriteLine($"{claim.Type} = {claim.Value}");
       }
   }
   

チェックポイント

これで、Auth0 を統合した WPF または WinForms アプリケーションが正しく動作するはずです。アプリケーションを実行し、次の点を確認してください。

• ログインボタンをクリックすると、Auth0 Universal Login ページがポップアップウィンドウで開くこと。
• ログインまたはサインアップできること。
• 認証後に、LoginResult.User からユーザー情報にアクセスできること。
• ログアウトボタンをクリックすると、セッションがクリアされ、ログアウト URL にリダイレクトされること。

---

​

高度な使い方

ログインエラーの処理

トークンやユーザーのプロパティにアクセスする前に、LoginResult.IsError を確認してください。認証に失敗した場合は、Error プロパティと ErrorDescription プロパティに詳細が含まれます。

var loginResult = await _client.LoginAsync();

if (loginResult.IsError)
{
    Debug.WriteLine($"An error occurred during login: {loginResult.Error}");
    // loginResult.ErrorDescription には完全なエラーメッセージが含まれます
    return;
}

// ここでは安全にトークンとユーザーにアクセスできます
Debug.WriteLine($"id_token: {loginResult.IdentityToken}");
Debug.WriteLine($"access_token: {loginResult.AccessToken}");

ユーザーが認証を完了せずにログイン用のポップアップを閉じた場合、LoginAsync() は BrowserResultType.UserCancel を含む結果を返します。これは想定された動作であり、エラーとして扱わないでください。

リフレッシュトークン

ユーザーに再度ログインしてもらうことなく新しいアクセストークンを取得するには、最初の LoginResult で取得したリフレッシュトークンを使って RefreshTokenAsync() を呼び出します。

// リフレッシュトークンを受け取るには offline_access スコープを要求します
_client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Scope = "openid profile email offline_access"
});

// 最初のログインで取得したリフレッシュトークンを保存します
var refreshToken = loginResult.RefreshToken;

// 後で新しいトークンと交換します
var refreshResult = await _client.RefreshTokenAsync(refreshToken);

if (refreshResult.IsError == false)
{
    var newAccessToken = refreshResult.AccessToken;
}

リフレッシュトークンを使用するには offline_access スコープが必要です。また、Auth0 の Application Settings で Refresh Token Rotation を有効にしておく必要があります。

---

​

追加リソース

SDK リポジトリ

Auth0 OIDC Client for .NET のソースコード、リリースノート、Issue トラッカー

ユーザープロファイル

ユーザープロファイルのクレームと /userinfo エンドポイントについて確認できます

コミュニティフォーラム

Auth0 コミュニティでサポートを受ける

---

​

よくある問題

ログイン用ポップアップは開くが、認証が完了しない

問題: WebView2 のポップアップウィンドウが開いてログインページは表示されますが、credentials を入力しても何も起こりません。

解決策: Microsoft Edge WebView2 Runtime がマシンにインストールされていません。Microsoft WebView2 download page からインストールしてください。WebView2 は Windows 11 と新しい Windows 10 ビルドには同梱されていますが、古いシステムでは別途インストールが必要です。

コールバック URL の不一致エラー

問題: ログイン後、Auth0 から callback URL mismatch エラーが返されます。

解決策: SDK が使用する Redirect URI が、Auth0 Dashboard の Allowed Callback URLs に設定されているどの値とも一致していません。Application Settings の Allowed Callback URLs に https://{yourDomain}/mobile を追加してください。SDK はデフォルトでこの URL を使用します。

ログアウト URL の不一致エラー

問題: ログアウト後、Auth0 から認識されない ログアウト URL に関するエラーが返されます。

解決策: Application Settings の Allowed Logout URLs に https://{yourDomain}/mobile を追加してください。

ログイン後に LoginResult.IsError が true になる

問題: LoginResult.IsError が true になっていますが、原因がはっきり分かりません。

解決策: 詳細は LoginResult.Error と LoginResult.ErrorDescription を確認してください。

if (loginResult.IsError)
{
    Debug.WriteLine($"Error: {loginResult.Error}");
    Debug.WriteLine($"Description: {loginResult.ErrorDescription}");
}

よくある原因:

• Auth0 Dashboard でアプリケーション種別が Native に設定されていない
• Advanced Settings → OAuth で OIDC Conformant が有効になっていない
• JSON Web Token Signature Algorithm が RS256 に設定されていない

ログイン後に RefreshToken が null になる

問題: LoginResult.RefreshToken が null です。

解決策: リフレッシュトークンを受け取るには offline_access スコープ が必要です。これを Scope オプションに追加してください。

_client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Scope = "openid profile email offline_access"
});

また、Auth0 Dashboard の Application Settings で Refresh Token Rotation が有効になっていることも確認してください。