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 にパラメーターを渡すこともできます。使用可能なパラメーターの一覧は、その接続の Auth0 Dashboard の設定、または認証プロバイダーのドキュメントで確認できます。ここでリクエストしたスコープは、Auth0 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” を使用していない場合や、Redirect URI に別のスキームを使用したい場合は、withScheme を使用します。選択したスキームに合わせて、app/build.gradle ファイル内の auth0Scheme Manifest Placeholder と、Auth0 Dashboard のアプリケーション設定にある AllowList Allowed Callback URLs を更新してください。

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

スキームは小文字にし、アンダースコア (_) は使用できません。

withAudience

audience を指定するには、withAudience を使用します。

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