Auth0.Android の設定オプション

アプリケーションの要件に合わせて Auth0.Android を設定する方法

Auth0.Android は、以下のさまざまなオプションで設定できます。

以下のオプションは、以前の V1 リリースから変更されています。詳細については、移行ガイドを参照してください。

withConnection

withConnection オプションを使用すると、認証に使用する接続を指定できます。

WebAuthProvider.login(account)
                .withConnection("twitter")
                .start(this, callback)

withScope

スコープを使用すると、リクエスト内の特定のフィールドに対応する特定のクレームを返すことができます。withScope にパラメーターを追加すると、さらにスコープを追加できます。詳しくは Scopes を参照してください。

WebAuthProvider.login(account)
                .withScope("openid profile email")
                .start(this, callback)

デフォルトのスコープは openid profile email です。

withConnectionScope

特定の認証プロバイダーから、特定の接続スコープや権限を指定して認証する必要がある場合があります。外部 IdP のスコープを追加するを参照してください。ただし、アプリ内の特定の状況で特定のアクセス権が必要な場合は、withConnectionScope にパラメーターを渡すこともできます。利用可能なパラメーターの一覧は、Dashboard の該当する接続の設定、または認証プロバイダーのドキュメントで確認できます。ここで要求するスコープは、Dashboard のその接続の設定で指定されているスコープに追加されます。

WebAuthProvider.login(account)
                .withConnectionScope("email", "profile", "calendar:read")
                .start(this, callback)

withParameters

認証時に追加のパラメーターを送信するには、withParameters. を使用します。

val parameters = mapOf("param1" to "value1")

WebAuthProvider.login(account)
                .withParameters(parameters)
                .start(this, callback)

withHeaders

認可エンドポイントにカスタムヘッダーを送信するには、withHeaders. を使用します。

val headers = mapOf("header1" to "value1")

WebAuthProvider.login(account)
                .withHeaders(headers)
                .start(this, callback)

withScheme

Android の “App Links” を使用していない場合、またはリダイレクト URI に別のスキームを使用する場合は、withScheme を使用します。選択したスキームに合わせて、app/build.gradle ファイル内の auth0Scheme Manifest Placeholder と、アプリケーション設定の Dashboard にある AllowList Allowed Callback URLs を更新します。

WebAuthProvider.login(account)
                .withScheme("myapp")
                .start(this, callback)

スキームは小文字にする必要があり、アンダースコア文字は使用できません。

withAudience

オーディエンスを指定するには、withAudience を使用します。

WebAuthProvider.login(account)
                .withAudience("https://YOUR_DOMAIN/userinfo")
                .start(this, callback)