Auth0のサービスを利用するには、Auth0 Dashboadに設定済みのアプリケーションが必要です。Auth0アプリケーションは、開発中のアプリに対してどのように認証が動作して欲しいかを構成する場所です。

Auth0アプリケーションを構成する

対話型のセレクターを使ってAuth0アプリケーションを新規作成するか、既存のネイティブのAuth0アプリケーションを選択します。Auth0のすべてのアプリケーションには英数字からなる一意のクライアントIDが割り当てられており、アプリがSDKを通じてAuth0 APIを呼び出す際に使用されます。

このクイックスタートを使って構成されたすべての設定は、DashboardのAuth0アプリケーションを自動更新します。今後、アプリケーションの管理もDashboardで行えます。

完了済みの構成を見てみたい場合は、サンプルアプリをご覧ください。

Callback URLとログアウトURLを構成する

Auth0はリダイレクトでユーザーをアプリに戻すため、Callback URLとログアウトURLを呼び出します。Auth0は、ユーザーを認証した後にCallback URLを呼び出し、セッションのクッキーを削除した後にログアウトURLを呼び出します。Callback URLとログインURLを設定しないと、ユーザーはアプリにログインやログアウトが行えなくなり、アプリにエラーが発生します。

アプリのプラットフォームに応じて、以下のCallback URLとログアウトURLを追加してください。カスタムドメインがある場合は、Auth0テナントのドメインに代わってそちらを使用します。

iOS

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

macOS

https://{yourDomain}/macos/YOUR_BUNDLE_IDENTIFIER/callback,
YOUR_BUNDLE_IDENTIFIER://{yourDomain}/macos/YOUR_BUNDLE_IDENTIFIER/callback

たとえば、iOSのバンドル識別子がcom.example.MyAppでAuth0ドメインがexample.us.auth0.comの場合には、次の値になります：

https://example.us.auth0.com/ios/com.example.MyApp/callback,
com.example.MyApp://example.us.auth0.com/ios/com.example.MyApp/callback

関連ドメインを構成する

チームIDとバンドル識別子を構成する

Auth0アプリケーションの設定ページに移動して最後までスクロールし、 ［Advanced Settings（詳細設定）］>［Device Settings（デバイス設定）］を開きます。［iOS］セクションで［Team ID（チームID）］にApple Team IDを、［App ID（アプリID）］にアプリのバンドルIDを設定します。

これで、アプリがAuth0テナントのapple-app-site-associationファイルに追加されます。

関連ドメインの機能を追加する

Xcodeで、アプリのターゲット設定の［Signing & Capabilities（署名と機能）］タブに移動し、［+ Capability（＋機能）］ボタンを押します。それから［Associated Domains（関連ドメイン）］を選択します。

次に、以下の エントリーを［Associated Domains（関連ドメイン）］の下に追加します：

webcredentials:labs-fundtraining.us.auth0.com

カスタムドメインがある場合は、Auth0テナントのドメインではなくそちらを使用してください。

Swift Package Managerを使用する

Xcodeで以下のメニュー項目を開きます：

［File（ファイル）］ > ［Add Package Dependencies...（パッケージの依存関係を追加する...）］

［Search or Enter Package URL（パッケージURLを検索または入力）］検索ボックスに次のURLを入力します：

https://github.com/auth0/Auth0.swift

それから依存ルールを選択して［Add Package（パッケージを追加）］を押します。

CocoaPodsを使用する

以下のラインをPodfileに追加します：

pod 'Auth0', '~> 2.0'

それからpod installを実行します。

Carthageを使用する

以下のラインをCartfileに追加します：

github "auth0/Auth0.swift" ~> 2.0

それからcarthage bootstrap --use-xcframeworksを実行します。

Auth0.swiftのSDKにはAuth0domainとClient IDが必要です。これらの値はAuth0アプリケーションの設定ページで確認できます

• domain：Auth0テナントのドメインです。カスタムドメインがある場合は、Auth0テナントのドメインではなくそちらを使用してください。

• クライアントID：このクイックスタートで前にセットアップした、Auth0アプリケーションの英数字からなる一意のIDです。

Auth0ドメインとクライアントIDの値を含むアプリバンドルにAuth0.plistという名前のplistファイルを作成します。

ログインページを提示したいファイルにAuth0モジュールをインポートします。それからログインボタンのアクションでユニバーサルログインページを提示します。

アプリにログインできるようになったら、ログアウトする方法が必要です。ログアウトボタンのアクションでclearSession()メソッドを呼び出し、ユニバーサルログインセッションのクッキーを消去します。

ログイン後に得るCredentialsインスタンスにはIDトークンが含まれます。IDトークンは、ログインしたユーザーに関連するプロファイル情報（メールアドレスやプロフィール写真など）を含みます。これらの詳細情報はアプリのユーザーインターフェイスをパーソナライズするために使用できます。

Auth0.swiftのSDKには、IDトークンのようなJWTをデコードするためのユーティリティが含まれています。ユーザープロファイル情報にアクセスしたいファイルへJWTDecodeモジュールをインポートすることで開始します。それから、decode(jwt:)メソッドを使ってIDトークンをデコードし、そこに含まれるクレームにアクセスします。