メインコンテンツへスキップ

AI を使って Auth0 を統合する

Claude Code、Cursor、GitHub Copilot などの AI コーディングアシスタントを使えば、agent skills を利用して数分で Auth0 認証を自動追加できます。インストール:
npx skills add auth0/agent-skills --skill auth0-quickstart --skill auth0-swift
次に、AI アシスタントに次のように依頼します。
Add Auth0 authentication to my iOS app
AI アシスタントが Auth0 アプリケーションを自動的に作成し、認証情報を取得して、Auth0.swift SDK 依存関係の追加、Auth0.plist の設定、コールバック URL の設定、ログイン/ログアウトフローの実装まで行います。agent skills の完全なドキュメント →

​
はじめに

1

新しいプロジェクトを作成

このクイックスタート用に、新しい iOS または macOS のプロジェクトを作成します。Xcode で:
  1. File → New → Project (または ⌘+Shift+N)
  2. 次のいずれかを選択します。
    • iOS タブ → App テンプレート
    • macOS タブ → App テンプレート
  3. プロジェクトを設定します。
    • Product Name: Auth0-Sample
    • Interface: SwiftUI
    • Language: Swift
    • Use Core Data: チェックなし
    • Include Tests: チェックあり (推奨)
  4. 保存場所を選択して Create をクリックします
これにより、SwiftUI と Swift Package Manager をサポートする標準的なアプリが作成され、Auth0 との統合に最適です。
2

Auth0 SDK を追加

お好みのパッケージマネージャーを使用して、Auth0 SDK をプロジェクトに追加します。
Xcode で:
  1. File → Add Package Dependencies… (または ⌘+Shift+K)
  2. Auth0 SDK の URL を入力します。 
    https://github.com/auth0/Auth0.swift
  3. Add Package → アプリのターゲットを選択 → Add Package
3

Auth0 を設定する

新しい Auth0 アプリケーションを作成し、コールバックURLを設定します。
  1. Auth0 Dashboard に移動します
  2. Applications > Create Application > 名前を入力し、Native を選択して Create をクリックします
  3. Settings タブで、クライアントID と ドメイン を控えます
  4. 次のURLを Allowed Callback URLs に追加します:
https://{yourDomain}/ios/YOUR_BUNDLE_IDENTIFIER/callback,
YOUR_BUNDLE_IDENTIFIER://{yourDomain}/ios/YOUR_BUNDLE_IDENTIFIER/callback
  1. 次のURLを Allowed Logout URLs に追加します:
https://{yourDomain}/ios/YOUR_BUNDLE_IDENTIFIER/callback,
YOUR_BUNDLE_IDENTIFIER://{yourDomain}/ios/YOUR_BUNDLE_IDENTIFIER/callback
  1. Save Changes をクリックします
4

アプリケーションの認証情報を設定

プロジェクトディレクトリにAuth0.plistを作成します:
Auth0.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>ClientId</key>
    <string>YOUR_AUTH0_CLIENT_ID</string>
    <key>Domain</key>
    <string>{yourDomain}</string>
</dict>
</plist>
Auth0.plist を Xcode にドラッグし、“Add to target” がチェックされていることを確認します。
5

認証サービスを作成する

AuthenticationService.swift を作成します。
  1. プロジェクトを右クリック → New File… → Swift File
  2. 名前を AuthenticationService にします
  3. 内容を次のように置き換えます。
AuthenticationService.swift
import Foundation
import Auth0
import Combine

@MainActor
class AuthenticationService: ObservableObject {
    @Published var isAuthenticated = false
    @Published var user: User?
    @Published var isLoading = false
    @Published var errorMessage: String?
    
    private let credentialsManager = CredentialsManager(authentication: Auth0.authentication())
    
    init() {
        Task {
            await checkAuthenticationStatus()
        }
    }
    
    private func checkAuthenticationStatus() async {
        isLoading = true
        defer { isLoading = false }
        
        guard let credentials = try? await credentialsManager.credentials() else {
            isAuthenticated = false
            return
        }
        
        isAuthenticated = true
        // IDトークンからユーザー情報を取得する
        user = credentials.user
    }
    
    func login() async {
        isLoading = true
        errorMessage = nil
        defer { isLoading = false }
        
        do {
            let credentials = try await Auth0
                .webAuth()
                .scope("openid profile email offline_access")
                .start()
            
            _ = credentialsManager.store(credentials: credentials)
            isAuthenticated = true
            // Get user info from the ID token
            user = credentials.user
        } catch {
            errorMessage = "Login failed: \(error.localizedDescription)"
        }
    }
    
    func logout() async {
        isLoading = true
        defer { isLoading = false }
        
        do {
            try await Auth0
              .webAuth()
              .clearSession()
            _ = credentialsManager.clear()
            isAuthenticated = false
            user = nil
        } catch {
            errorMessage = "Logout failed: \(error.localizedDescription)"
        }
    }
}
6

認証フローを設定する（任意）

ユーザーエクスペリエンスを向上させるために、次の方法でシステムアラートを最小限に抑えられます。
  1. Universal Links を使用する: リダイレクト中に表示される「“AppName”で開きますか？」というプロンプトが表示されなくなります。注: ASWebAuthenticationSession の権限アラートは引き続き表示されます。
  2. Ephemeral Sessions を使用する: すべての権限アラートが表示されなくなります。注: これによりシングルサインオン (SSO) と共有 Cookie は無効になります。
この手順はスキップして、権限アラートが表示されるデフォルトの動作を使用できます。これは後で設定できます。
8

アプリを実行する

Xcode で ⌘+R を押します。
  1. 「Log In」をタップ → 権限アラート (デフォルト設定を使用している場合) → 「続行」をタップ
  2. ブラウザーでログインを完了します
  3. プロファイルが表示されます
チェックポイントこれで、iOS または macOS アプリで Auth0 ログインが完全に動作するようになりました！

​
トラブルシューティングと詳細設定

​
ビルドエラー: ‘Auth0’ モジュールが見つからない

解決策:
  1. Swift Package Manager: Package Dependencies を確認し、Auth0.swift が一覧に表示されていることを確認します
  2. CocoaPods: .xcodeproj ではなく .xcworkspace ファイルを開いていることを確認します
  3. Carthage: Auth0.xcframework が Frameworks, Libraries, and Embedded Content に追加されていることを確認します
  4. クリーンして再ビルドします: ⌘+Shift+K の後に ⌘+R
  5. 必要に応じて Xcode を再起動します

​
アプリがクラッシュする: ‘Auth0.plist not found’

修正方法:
  1. Auth0.plist が Xcode のプロジェクトナビゲーター内にあることを確認します
  2. ファイルを選択 → Inspector → アプリのターゲットにチェックが入っていることを確認します
  3. ClientId キーと Domain キーに自分の値が設定されていることを確認します
  4. 別の方法: コードによる設定を使用します (下の詳細な統合セクションを参照)

​
ブラウザーは開くがアプリに戻らない

修正方法:
  1. Auth0 Dashboard のコールバック URL が、bundle identifier とプラットフォームに完全に一致していることを確認します
  2. iOS の場合: URL に /ios/ を含めます。macOS の場合: /macos/ を含めます
  3. Xcode の bundle identifier が Auth0 の設定と一致していることを確認します
  4. URL にタイプミスがないことを確認します (よくある例: コロンの抜け、誤ったドメイン形式)
  5. カスタムドメインを使用している場合: Auth0 ドメインではなく、カスタムドメインを使用していることを確認します

​
毎回権限アラートが表示される

これは、カスタム URL スキームを使用する際の iOS/macOS の標準的なセキュリティ動作です。Universal Links または Ephemeral Sessions を使用してこのアラートを回避する方法については、ステップ 6 を参照してください。

​
App Store 公開の準備

  • 権限アラートを回避するために Universal Links を設定します
  • 複数のプラットフォームバージョンとデバイスサイズでテストします
  • ネットワーク障害に対する適切なエラーハンドリングを実装します
  • 生体認証とともに Keychain を使用する場合は Privacy Usage の説明を追加します
  • 認証フローについては App Store Review Guidelines に従います

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

  • 本番環境では機密性の高い認証データを決してログに出力しないでください
  • App Transport Security (ATS) に準拠するよう実装します
  • すべてのネットワークリクエストに HTTPS を使用します
  • Auth0 API 証明書のピン留めはしないでください - Auth0 はこの方法を推奨していません

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

  • すべての非同期処理で、UI 更新に @MainActor が適切に使用されています
  • @Published プロパティでは適切なメモリ管理が行われています
  • 認証情報はオフラインアクセス用に Keychain に安全にキャッシュされます
  • ユーザープロファイルは IDトークン から取得されます (追加のネットワークリクエストは不要)

​
プログラムによる設定

Auth0.plist を使用する代わりに、認証情報をコード内で直接渡すこともできます。これは、認証情報を動的にしたい場合や環境ごとに変えたい場合 (例: 開発/ステージング/本番で異なる Auth0 テナントを使う場合) に便利です。Auth0.webAuth() の呼び出しを Auth0.webAuth(clientId:domain:) に置き換えます。
// AuthenticationService.swift 内 - ログイン関数
func login() async {
    isLoading = true
    errorMessage = nil
    defer { isLoading = false }
    
    do {
        let credentials = try await Auth0
            .webAuth(clientId: "{yourClientId}", domain: "{yourDomain}")
            .scope("openid profile email offline_access")
            .start()
        
        _ = credentialsManager.store(credentials: credentials)
        isAuthenticated = true
        user = credentials.user
    } catch {
        errorMessage = "Login failed: \(error.localizedDescription)"
    }
}

// AuthenticationService.swift 内 - ログアウト関数
func logout() async {
    isLoading = true
    defer { isLoading = false }
    
    do {
        try await Auth0.webAuth(clientId: "{yourClientId}", domain: "{yourDomain}").clearSession()
        _ = credentialsManager.clear()
        isAuthenticated = false
        user = nil
    } catch {
        errorMessage = "Logout failed: \(error.localizedDescription)"
    }
}

​
生体認証による Keychain セキュリティの強化

保存された認証情報にアクセスする際に、Face ID または Touch ID を必須にします。
private let credentialsManager: CredentialsManager = {
    let manager = CredentialsManager(authentication: Auth0.authentication())
    manager.enableBiometrics(
        withTitle: "Unlock with Face ID", 
        cancelTitle: "Cancel", 
        fallbackTitle: "Use Passcode"
    )
    return manager
}()
有効にすると、SDK が保存済みの認証情報を取得する前に、ユーザーは生体認証を行う必要があります。

​
自動トークン更新

CredentialsManager は、有効期限が切れたアクセストークンを自動的に更新します。
// 認証情報を取得 - 期限切れの場合は自動的に更新
func getAccessToken() async throws -> String {
    let credentials = try await credentialsManager.credentials()
    return credentials.accessToken
}
アクセストークンが必要な API 呼び出しでは、このパターンを使用してください。

​
App Extension 間での認証情報の共有

アクセストークンを必要とするウィジェット、App Extension、またはバックグラウンドタスク向けです。
// App Group を使って共有認証情報マネージャーを作成
let credentialsManager = CredentialsManager(
    authentication: Auth0.authentication(),
    storeKey: "credentials",
    storage: .shared(withIdentifier: "group.com.example.myapp")
)
要件:
  1. すべてのターゲットで Xcode の App Groups 機能を有効にする
  2. ターゲット間で同じ App Group 識別子を使用する
  3. 各ターゲットで共有 CredentialsManager を設定する

​
認証フローオプションの比較

機能Universal LinksEphemeral Sessionデフォルト (アラート)
権限アラート軽減される (リダイレクト確認なし)なしすべてのアラートを表示
SSO サポートはいいいえはい
Apple Developer Account必須不要不要
ユーザー体験最良良好許容範囲
セットアップの複雑さ中程度簡単簡単
プライベートブラウジング対応はいはいいいえ
推奨事項:
  • SSO を使用する本番アプリ: Universal Links (より優れた UX、SSO をサポート、Apple Developer Account が必要)
  • SSO を使用しない本番アプリ: Ephemeral Sessions (アラートなし、セットアップが簡単)
  • テスト/開発: Ephemeral Sessions (セットアップが迅速で、最もすっきりした UX)
  • クイックスタート/プロトタイピング: アラート付きのデフォルト設定 (セットアップ不要、後で移行可能)