.NET Android & iOS アプリケーションにログインを追加する

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 .NET Android & iOS app

AI アシスタントが、Auth0 アプリケーションの作成、資格情報の取得、Auth0 OidcClient SDK のインストール、プラットフォーム固有の設定、ログイン／ログアウトフローの実装を自動で行います。Agent Skills の完全なドキュメント →

はじめに

.NET の新しいプロジェクトを作成する

この Quickstart 用に、新しい .NET MAUI または .NET Android/iOS プロジェクトを作成します。

.NET MAUI
.NET Android
.NET iOS

Visual Studio 2022 以降の場合:

ファイル → 新規 → プロジェクト
.NET MAUI App テンプレートを選択します
プロジェクトを設定します。
- プロジェクト名: Auth0MauiSample
- 場所: 任意の場所を選択します
- フレームワーク: .NET 8.0 以降
Create をクリックします

Visual Studio 2022 以降の場合:

ファイル → 新規 → プロジェクト
Android App (.NET) テンプレートを選択します
プロジェクトを設定します。
- プロジェクト名: Auth0AndroidSample
- フレームワーク: .NET 8.0 以降
Create をクリックします

Visual Studio 2022 (Mac) または Visual Studio for Mac の場合:

ファイル → 新規 → プロジェクト
iOS App (.NET) テンプレートを選択します
プロジェクトを設定します。
- プロジェクト名: Auth0iOSSample
- フレームワーク: .NET 8.0 以降
Create をクリックします

この Quickstart では、Xamarin.Android と Xamarin.iOS の次世代である .NET Android と .NET iOS を対象としています。現在も Xamarin を使用している場合でも、連携方法は同じで SDK にも互換性があるため、このガイドに沿って進めることができます。

Auth0 SDK をインストールする

Auth0 OIDC Client SDK をプロジェクトに追加します。

Package Manager Console
Visual Studio for Mac
.NET CLI

Package Manager Console (View → Other Windows → Package Manager Console) を開き、適切なパッケージをインストールします。.NET Android の場合:

Package Manager Console

Install-Package Auth0.OidcClient.AndroidX

.NET iOS の場合:

Package Manager Console

Install-Package Auth0.OidcClient.iOS

.NET MAUI (両方のプラットフォーム) の場合:

Package Manager Console

Install-Package Auth0.OidcClient.MAUI

Solution Pad で Packages フォルダーを Ctrl+クリック (または右クリック) します
Add Packages… を選択します
以下を検索します。
- Android の場合: Auth0.OidcClient.AndroidX
- iOS の場合: Auth0.OidcClient.iOS
- MAUI プロジェクトの場合: Auth0.OidcClient.MAUI
パッケージを選択し、Add Package をクリックします

プロジェクトのディレクトリで、次のコマンドを実行します。.NET Android の場合:

Terminal

dotnet add package Auth0.OidcClient.AndroidX

.NET iOS の場合:

Terminal

dotnet add package Auth0.OidcClient.iOS

.NET MAUI の場合:

Terminal

dotnet add package Auth0.OidcClient.MAUI

Auth0 OIDC Client SDK は、OAuth 2.0 と OIDC のプロトコルに関する複雑な処理をすべて担い、authentication のためのシンプルな API を提供します。

Auth0 App を設定する

Auth0 テナントに新しいアプリケーションを作成し、モバイル向けに設定します。

Auth0 Dashboard に移動します
Applications → Applications → Create Application をクリックします
アプリの名前を入力し、アプリケーションタイプとして Native を選択して、Create をクリックします
アプリケーションの詳細ページで設定タブに切り替えます
Domain と Client ID を控えます。次の手順で使用します

コールバック URL を設定する:設定タブで、次の URL を追加します。Allowed Callback URLs:

Android
iOS

YOUR_ANDROID_PACKAGE_NAME://{yourDomain}/android/YOUR_ANDROID_PACKAGE_NAME/callback

置き換える箇所:

YOUR_ANDROID_PACKAGE_NAME はアプリのパッケージ名に置き換えます (例: com.mycompany.myapp)
{yourDomain} は Auth0 のドメインに置き換えます (例: dev-abc123.us.auth0.com)

例: com.mycompany.myapp://dev-abc123.us.auth0.com/android/com.mycompany.myapp/callback

YOUR_BUNDLE_IDENTIFIER://{yourDomain}/ios/YOUR_BUNDLE_IDENTIFIER/callback

置き換える箇所:

YOUR_BUNDLE_IDENTIFIER はアプリのバンドル ID に置き換えます (例: com.mycompany.myapp)
{yourDomain} は Auth0 のドメインに置き換えます (例: dev-abc123.us.auth0.com)

例: com.mycompany.myapp://dev-abc123.us.auth0.com/ios/com.mycompany.myapp/callback

Allowed Logout URLs:コールバック URL と同じ URL を使用します。

コールバック URL とログアウト URL は 小文字 で指定してください。一致しない URL を使用すると、認証は失敗します。

Allowed Callback URLs はセキュリティ上重要です。これにより、認証後にユーザーを安全にアプリケーションへ戻せます。一致する URL がない場合、ログインプロセスは失敗します。Allowed Logout URLs を設定すると、ユーザーのサインアウト時に Auth0 のページに残すことなく、アプリへリダイレクトできます。

Auth0 クライアントを初期化する

Auth0 と通信するために、Auth0Client インスタンスを作成します。

Android - MainActivity
iOS - AppDelegate

MainActivity.cs

using Auth0.OidcClient;
using Android.App;
using Android.Content;

[Activity(Label = "Auth0Sample", MainLauncher = true, Icon = "@drawable/icon",
    LaunchMode = LaunchMode.SingleTask)]
[IntentFilter(
    new[] { Intent.ActionView },
    Categories = new[] { Intent.CategoryDefault, Intent.CategoryBrowsable },
    DataScheme = "YOUR_ANDROID_PACKAGE_NAME",
    DataHost = "{yourDomain}",
    DataPathPrefix = "/android/YOUR_ANDROID_PACKAGE_NAME/callback")]
public class MainActivity : Activity
{
    private Auth0Client auth0Client;

    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);

        // Auth0 クライアントを初期化
        auth0Client = new Auth0Client(new Auth0ClientOptions
        {
            Domain = "{yourDomain}",
            ClientId = "{yourClientId}"
        }, this);
    }

    protected override async void OnNewIntent(Intent intent)
    {
        base.OnNewIntent(intent);
        Auth0.OidcClient.ActivityMediator.Instance.Send(intent.DataString);
    }
}

YOUR_ANDROID_PACKAGE_NAME、{yourDomain}、{yourClientId} は実際の値に置き換えてください。DataScheme、DataHost、DataPathPrefix 内のテキストはすべて小文字にしてください。

IntentFilter は、アプリがコールバック URL を処理できるよう登録するためのものです。LaunchMode.SingleTask を指定することで、コールバック時に Android が新しい activity インスタンスを作成しないようにします。

まず、Info.plist に URL スキームを登録します。

Info.plist

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>None</string>
        <key>CFBundleURLName</key>
        <string>Auth0</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>YOUR_BUNDLE_IDENTIFIER</string>
        </array>
    </dict>
</array>

次に、AppDelegate.cs を設定します。

AppDelegate.cs

using Auth0.OidcClient;
using Foundation;
using UIKit;

[Register("AppDelegate")]
public class AppDelegate : UIApplicationDelegate
{
    private Auth0Client auth0Client;

    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
    {
        // Auth0 クライアントを初期化
        auth0Client = new Auth0Client(new Auth0ClientOptions
        {
            Domain = "{yourDomain}",
            ClientId = "{yourClientId}"
        });

        return true;
    }

    public override bool OpenUrl(UIApplication application, NSUrl url,
        string sourceApplication, NSObject annotation)
    {
        ActivityMediator.Instance.Send(url.AbsoluteString);
        return true;
    }
}

YOUR_BUNDLE_IDENTIFIER、{yourDomain}、{yourClientId} は実際の値に置き換えてください。

保守性を高めるため、Auth0 domain と client ID はハードコードせず、設定ファイルまたはアプリの設定に保存してください。

Implement Login と Logout

ユーザー認証を行うためのメソッドを追加します。Implement Login:

Authentication.cs

public async Task LoginAsync()
{
    var loginResult = await auth0Client.LoginAsync();

    if (!loginResult.IsError)
    {
        // 認証成功
        var accessToken = loginResult.AccessToken;
        var idToken = loginResult.IdentityToken;
        var user = loginResult.User;

        // 資格情報を保存してUIを更新
        Console.WriteLine($"Logged in as: {user.FindFirst("name")?.Value}");
    }
    else
    {
        // 認証エラーを処理
        Console.WriteLine($"Login error: {loginResult.Error}");
    }
}

Implementのログアウト:

Authentication.cs

public async Task LogoutAsync()
{
    var logoutResult = await auth0Client.LogoutAsync();

    if (logoutResult == BrowserResultType.Success)
    {
        // 保存された資格情報をクリア
        // UIをログアウト状態に更新
        Console.WriteLine("Logged out successfully");
    }
}

LoginAsync() メソッドは、Auth0 の Universal Login ページを表示するために、システムブラウザー (Android では Chrome Custom Tabs) を起動します。authentication の完了後、ユーザーは callback URL を介してアプリにリダイレクトされます。

これらのメソッドを MainActivity (Android) または ViewController (iOS) に追加し、ユーザーが Login/Logout ボタンをタップしたときに呼び出します。

アプリを実行

アプリケーションをビルドして実行します。

Visual Studio (Windows)
Visual Studio for Mac
.NET CLI

Android の場合:

デバイスのドロップダウンから Android エミュレーターまたは接続済みのデバイスを選択します
F5 キーを押すか、Run ボタンをクリックします
アプリがビルド、デプロイされ、起動します

iOS の場合 (Mac ビルドホストが必要) :

Mac ビルドホストに接続します
デバイスのドロップダウンから iOS シミュレーターまたはデバイスを選択します
F5 キーを押すか、Run ボタンをクリックします

Android の場合:

Terminal

dotnet build -f net8.0-android
dotnet run -f net8.0-android

iOS の場合:

Terminal

dotnet build -f net8.0-ios
dotnet run -f net8.0-ios

想定されるフロー:

Login ボタンが表示された状態でアプリが起動します
Log In をタップ → ブラウザーまたは Chrome Custom Tab が開く → 認証を完了します
自動的にアプリにリダイレクトされます
ユーザーの認証が正常に完了します

初回実行時には、認証のためにブラウザーを開いてよいか iOS から確認を求められることがあります。これは正常で、想定された動作です。

チェックポイントこれで、.NET Android または iOS のアプリケーションで、Auth0 login を問題なく利用できるようになりました。アプリケーションは安全な認証のためにシステムブラウザーを使用し、コールバックフローも自動的に処理します。

ユーザー情報にアクセスする

認証に成功すると、ログイン結果からユーザー情報にアクセスできます。

認証結果

LoginAsync() メソッドは、以下を含む LoginResult オブジェクトを返します。

UserInfo.cs

var loginResult = await auth0Client.LoginAsync();

if (!loginResult.IsError)
{
    // アクセストークン
    var accessToken = loginResult.AccessToken;
    var idToken = loginResult.IdentityToken;
    var refreshToken = loginResult.RefreshToken;

    // ユーザーのクレームを取得する
    var user = loginResult.User;
    var name = user.FindFirst("name")?.Value;
    var email = user.FindFirst("email")?.Value;
    var picture = user.FindFirst("picture")?.Value;

    Console.WriteLine($"Name: {name}");
    Console.WriteLine($"Email: {email}");
}

すべてのクレームを確認する

利用可能なすべてのユーザー情報を確認するには:

UserClaims.cs

if (!loginResult.IsError)
{
    foreach (var claim in loginResult.User.Claims)
    {
        Console.WriteLine($"{claim.Type}: {claim.Value}");
    }
}

返されるクレームの内容は、リクエストしたスコープによって異なります。詳しくは、Auth0 OIDC Client のドキュメントのスコープの使用を参照してください。

カスタムスコープをリクエストする

追加のユーザー情報を取得するには、Auth0Clientの作成時にスコープを指定します:

CustomScopes.cs

var auth0Client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Scope = "openid profile email offline_access read:posts"
});

トラブルシューティングと Advanced

よくある問題と解決策

ブラウザーからアプリにリダイレクトされない

解決策:

Auth0 Dashboard のコールバック URL が、アプリのパッケージ名またはバンドル識別子と完全に一致していることを確認します
コールバック URL が 小文字 になっていることを確認します
DataScheme、DataHost、DataPathPrefix (Android) または URL スキーム (iOS) が設定内容と一致していることを確認します
プロジェクトをクリーンし、再ビルドします

”Invalid Callback URL” エラーで認証に失敗する

修正方法:

Auth0 Dashboard のコールバック URL が次の形式と一致していることを再確認します:
- Android: packagename://yourdomain/android/packagename/callback
- iOS: bundleidentifier://yourdomain/ios/bundleidentifier/callback
URL が小文字になっていることを確認します
コード内の Domain が Auth0 Dashboard の Domain と一致していることを確認します

LoginAsync() が応答しない、または完了しない

解決策:

Intent filter (Android) または URL スキーム (iOS) が正しく設定されていることを確認します
OnNewIntent() (Android) または OpenUrl() (iOS) から ActivityMediator が呼び出されていることを確認します
アプリからシステムブラウザーを開けることを確認します
ネットワーク接続を確認します

エラー: “Default App must use Token Endpoint Authentication Method ‘None’”

修正方法:

Auth0 Dashboard の Auth0 アプリケーションの設定に移動します
Application Properties までスクロールします
Application Type を Native に設定します
Token Endpoint Authentication Method を None に設定します
変更を保存 をクリックします

iOS: ブラウザーが開かない

解決策:

Info.plist に正しい URL スキーム設定が含まれていることを確認します
OpenUrl() が AppDelegate に実装されていることを確認します
iOS のデプロイ対象が使用中の Auth0 SDK のバージョンと互換性があることを確認します

本番環境での考慮事項

セキュリティのベストプラクティス

安全なトークン保存: トークンの保存には、プラットフォーム固有の安全なストレージ (Android Keystore、iOS Keychain) を使用します
トークンの更新: ユーザーセッションを維持するため、リフレッシュトークンの処理を実装します
証明書ピンニング: API セキュリティをさらに強化するために、証明書ピンニングを検討します
ProGuard/コード難読化: Android でコード難読化を使用する場合は、適切なルールを追加します

App Store の要件

プライバシーポリシー: Auth0 の利用について説明したプライバシーポリシーがアプリにあることを確認します
ユーザーデータの取り扱い: ユーザーの認証データの取り扱いについて、プラットフォームのガイドラインに従います
ディープリンク: さまざまなシナリオでコールバック URL の処理を十分にテストします
ネットワーク要件: オフライン時にも適切に対応できるようにします

パフォーマンスの最適化

Auth0Client をキャッシュする: インスタンスを 1 つだけ作成し、アプリ全体で再利用します
遅延読み込み: 必要になったときにのみ Auth0Client を初期化します
バックグラウンド更新: 長時間のセッションに備えて、バックグラウンドでのトークン更新を実装します

高度な設定

カスタムスコープと audience

特定のスコープをリクエストし、API の audience を設定します。

AdvancedAuth.cs

var auth0Client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Scope = "openid profile email offline_access read:posts write:posts",
    Audience = "https://myapi.example.com"
});

var loginResult = await auth0Client.LoginAsync();

追加パラメータ

認可リクエストに追加のパラメータを渡します。

ExtraParams.cs

var extraParameters = new Dictionary<string, string>
{
    { "prompt", "login" },
    { "ui_locales", "es" },
    { "custom_param", "value" }
};

var loginResult = await auth0Client.LoginAsync(extraParameters);

リフレッシュトークン

リフレッシュトークンを使用すると、ユーザーの操作なしで新しいアクセストークンを取得できます。

RefreshToken.cs

var refreshResult = await auth0Client.RefreshTokenAsync(loginResult.RefreshToken);

if (!refreshResult.IsError)
{
    var newAccessToken = refreshResult.AccessToken;
    var newIdToken = refreshResult.IdentityToken;
    // 新しいトークンを保存
}

リフレッシュトークンを受け取るには、認証リクエストに offline_access スコープを含めてください。

プラットフォーム固有のブラウザ設定

Android - カスタムカラーで Chrome Custom Tabs を使用する:

AndroidBrowser.cs

var auth0Client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Browser = new AndroidBrowser
    {
        ToolbarColor = Android.Graphics.Color.ParseColor("#FF6B35")
    }
}, this);

iOS - カスタム表示で SFSafariViewController を使用する:

iOSBrowser.cs

var auth0Client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "{yourDomain}",
    ClientId = "{yourClientId}",
    Browser = new ASWebAuthenticationSessionBrowser
    {
        PrefersEphemeralWebBrowserSession = false
    }
});

次のステップ

IDプロバイダーを設定する

Google、Facebook、GitHub などのソーシャルログイン用プロバイダーを追加する

多要素認証を有効にする

MFA でセキュリティをさらに強化する

攻撃対策

ブルートフォース攻撃やボット攻撃から保護する方法を学ぶ

ログインエクスペリエンスをカスタマイズする

ブランドに合わせて Universal Login ページをカスタマイズする

Quickstarts

Auth0 の概要

Auth0 を設定する

アプリケーション

.NET Android & iOS アプリケーションにログインを追加する

はじめに

ユーザー情報にアクセスする

認証結果

すべてのクレームを確認する

カスタムスコープをリクエストする

トラブルシューティングと Advanced

ブラウザーからアプリにリダイレクトされない

”Invalid Callback URL” エラーで認証に失敗する

LoginAsync() が応答しない、または完了しない

エラー: “Default App must use Token Endpoint Authentication Method ‘None’”

iOS: ブラウザーが開かない

セキュリティのベストプラクティス

App Store の要件

パフォーマンスの最適化

カスタムスコープと audience

追加パラメータ

リフレッシュトークン

プラットフォーム固有のブラウザ設定

次のステップ

IDプロバイダーを設定する

多要素認証を有効にする

攻撃対策

ログインエクスペリエンスをカスタマイズする

​はじめに

​ユーザー情報にアクセスする

​認証結果

​すべてのクレームを確認する

​カスタムスコープをリクエストする

​トラブルシューティングと Advanced

​ブラウザーからアプリにリダイレクトされない

​”Invalid Callback URL” エラーで認証に失敗する

​LoginAsync() が応答しない、または完了しない

​エラー: “Default App must use Token Endpoint Authentication Method ‘None’”

​iOS: ブラウザーが開かない

​セキュリティのベストプラクティス

​App Store の要件

​パフォーマンスの最適化

​カスタムスコープと audience

​追加パラメータ

​リフレッシュトークン

​プラットフォーム固有のブラウザ設定

​次のステップ

IDプロバイダーを設定する

多要素認証を有効にする

攻撃対策

ログインエクスペリエンスをカスタマイズする

はじめに

ユーザー情報にアクセスする

認証結果

すべてのクレームを確認する

カスタムスコープをリクエストする

トラブルシューティングと Advanced

ブラウザーからアプリにリダイレクトされない

”Invalid Callback URL” エラーで認証に失敗する

LoginAsync() が応答しない、または完了しない

エラー: “Default App must use Token Endpoint Authentication Method ‘None’”

iOS: ブラウザーが開かない

セキュリティのベストプラクティス

App Store の要件

パフォーマンスの最適化

カスタムスコープと audience

追加パラメータ

リフレッシュトークン

プラットフォーム固有のブラウザ設定

次のステップ