Android アプリケーションに Facebook ネイティブLoginを追加する

開始する前に

このクイックスタートに進む前に、以下の前提条件を満たしてください。

Facebook Login SDK をセットアップする - Facebook Login SDK for Android をインストールして設定します。developers.facebook.com で Facebook アプリを作成してください。完了したら、アプリで Facebook Login が動作する状態になっている必要があります。
Facebook Native 用に Auth0 を設定する - Facebook Native Sign In を使用するように Auth0 アプリケーションを設定します。詳細は、ネイティブアプリに Facebook Login を追加するを参照してください。

はじめに

Facebook Loginの権限を設定する

Activity 内の Facebook ログインボタンを更新して、必要な権限を正しくリクエストします。アプリはすでに Facebook Login をサポートしていますが、より充実したユーザープロファイルを取得するには、public_profile と email の権限をリクエストする必要があります。また、Auth0 の認証フローを開始するコールバックも追加します。

MainActivity.kt

private lateinit var fbCallbackManager: CallbackManager

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_login)

    fbCallbackManager = CallbackManager.Factory.create()
    val loginButton = findViewById<LoginButton>(R.id.login_button)

    // メールアドレスとpublic_profileの権限をリクエスト
    loginButton.setPermissions("email", "public_profile")

    loginButton.registerCallback(fbCallbackManager,
        object : FacebookCallback<LoginResult> {
            override fun onSuccess(result: LoginResult) {
                val accessToken = result.accessToken
                performLogin(accessToken)
            }
            override fun onCancel() {
                // ユーザーがダイアログを閉じました。無視して問題ありません
            }
            override fun onError(error: FacebookException) {
                // Facebook認証エラーを処理する
            }
        })
}

private fun performLogin(accessToken: AccessToken) {
    // ステップ2〜4で実装します
}

email 権限は任意であり、共有にはユーザーの同意が必要です。Facebook から返されるメールアドレスは、Auth0 のユーザープロファイルで未検証として扱われます。

Auth0 SDKをインストールして設定する

Auth0 Android SDK をプロジェクトに追加し、アプリケーションの認証情報を設定します。app/build.gradle.kts に依存関係を追加します。

app/build.gradle.kts

dependencies {
    implementation("com.auth0.android:auth0:3.+")
}

依存関係を追加したら、Gradle を同期します。Auth0 の認証情報を strings.xml に追加します。Auth0 Dashboard の Applications に移動し、Facebook Native Sign In を有効にしたアプリケーションを選択します。ドメイン と クライアントID の値をコピーします。

app/src/main/res/values/strings.xml

<resources>
    <string name="com_auth0_domain">{yourDomain}</string>
    <string name="com_auth0_client_id">{yourClientId}</string>
</resources>

Activity で Auth0 SDK を初期化します。

MainActivity.kt

private val account: Auth0 by lazy {
    Auth0.getInstance(
        getString(R.string.com_auth0_client_id),
        getString(R.string.com_auth0_domain)
    )
}

private val authenticationApiClient: AuthenticationAPIClient by lazy {
    AuthenticationAPIClient(account)
}

アプリで Auth0 Web Authentication を使用しない場合は、Manifest Placeholder エラーを避けるため、AndroidManifest.xml から不要な activity を削除してください。

app/src/main/AndroidManifest.xml

<application>
    <activity
        android:name="com.auth0.android.provider.AuthenticationActivity"
        tools:node="remove" />
</application>

Web Authentication をサポートする予定がある場合は、Universal Login による認証を参照してください。

Facebook セッションアクセストークンを取得する

Facebook Login に成功したら、Facebook API からセッションアクセストークンを取得します。Auth0 では、このトークンを使用してバックエンドでユーザーの本人確認を行います。GraphRequest クラスを使用して、Facebook の /oauth/access_token エンドポイントに GET リクエストを送信します。

MainActivity.kt

private interface SimpleCallback<T> {
    fun onResult(result: T)
    fun onError(cause: Throwable)
}

private fun fetchSessionToken(accessToken: AccessToken, callback: SimpleCallback<String>) {
    val request = GraphRequest()
    request.graphPath = "oauth/access_token"
    val bundle = Bundle()
    bundle.putString("grant_type", "fb_attenuate_token")
    bundle.putString("client_id", getString(R.string.facebook_app_id))
    bundle.putString("fb_exchange_token", accessToken.token)
    request.parameters = bundle
    request.callback = GraphRequest.Callback { response ->
        if (response.error != null) {
            response.error?.exception?.let { callback.onError(it) }
        } else {
            response.jsonObject?.let { callback.onResult(it.getString("access_token")) }
        }
    }
    request.executeAsync()
}

必須のクエリパラメーターは次のとおりです。

grant_type: fb_attenuate_token
fb_exchange_token: Facebook Login のアクセストークン
client_id: Facebook アプリの App ID (Facebook SDK の設定時に、すでにアプリに含まれています)

Facebookユーザープロフィールを取得

Facebook からユーザーのプロフィールを取得します。Auth0 はこのデータを使用して、ユーザーの Auth0 プロフィールを作成または更新します。

MainActivity.kt

private fun fetchUserProfile(
    accessToken: AccessToken,
    callback: SimpleCallback<String>
) {
    val request = GraphRequest.newMeRequest(accessToken) { _, response ->
        val error = response?.error
        if (error != null) {
            error.exception?.let { callback.onError(it) }
        } else {
            callback.onResult(response?.rawResponse.toString())
        }
    }
    val bundle = Bundle()
    bundle.putString("fields", "first_name,last_name,email")
    request.parameters = bundle
    request.executeAsync()
}

fields パラメーターは、リクエストした Facebook の権限にそのまま対応します。Auth0 が完全なユーザープロファイルを作成するには、first_name、last_name、email をリクエストすれば十分です。

トークンをAuth0の認証情報に交換する

前の手順で取得したセッショントークンとユーザープロフィールを使用して Auth0 で認証し、Auth0 トークンを取得します。Facebook のサブジェクトトークンタイプを指定してセッショントークンを渡し、AuthenticationAPIClient で loginWithNativeSocialToken を呼び出します。

MainActivity.kt

private fun exchangeTokens(
    sessionToken: String,
    userProfile: String,
    callback: SimpleCallback<Credentials>
) {
    authenticationApiClient
        .loginWithNativeSocialToken(
            sessionToken,
            "http://auth0.com/oauth/token-type/facebook-info-session-access-token"
        )
        .setScope("openid profile email offline_access")
        .addParameter(name = "user_profile", value = userProfile)
        .start(object : Callback<Credentials, AuthenticationException> {
            override fun onSuccess(result: Credentials) {
                callback.onResult(result)
            }
            override fun onFailure(error: AuthenticationException) {
                callback.onError(error)
            }
        })
}

サブジェクトトークンタイプ http://auth0.com/oauth/token-type/facebook-info-session-access-token は、認証に Facebook のネイティブ接続を使用するよう Auth0 に指示します。

すべてをまとめる

performLogin メソッドを完成させて、3 つの手順すべてをつなげます: セッショントークンの取得 → ユーザープロファイルの取得 → Auth0 トークンへの交換。

MainActivity.kt

private fun performLogin(accessToken: AccessToken) {
    fetchSessionToken(accessToken, object : SimpleCallback<String> {
        override fun onResult(sessionToken: String) {
            fetchUserProfile(accessToken, object : SimpleCallback<String> {
                override fun onResult(userProfile: String) {
                    exchangeTokens(sessionToken, userProfile, object : SimpleCallback<Credentials> {
                        override fun onResult(result: Credentials) {
                            // 認証済み！result.accessToken または result.idToken を使用してください
                        }
                        override fun onError(cause: Throwable) {
                            // トークン交換エラーを処理する
                        }
                    })
                }
                override fun onError(cause: Throwable) {
                    // プロファイルリクエストエラーを処理する
                }
            })
        }
        override fun onError(cause: Throwable) {
            // セッショントークンリクエストエラーを処理する
        }
    })
}

コード内にマジック文字列が散在するのを避けるため、定数 (subject token type、Facebook permissions、Auth0スコープ) はクラスの先頭にまとめて配置してください。

チェックポイントこれで、Facebook を使ったネイティブ認証ができるようになっているはずです。デバイスに Facebook アプリがインストールされている場合は、そのアプリ経由で直接認証されるため、ブラウザーは不要です。

トラブルシューティングと高度なトピック

よくある問題と解決策

本番環境での考慮事項

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

本番環境ではログ出力を無効にする: DefaultClient の enableLogging = true を削除するか条件付きにしてください — ネットワークトラフィックが記録されます
トークンを安全に保存する: SecureCredentialsManager を使用して Auth0 のトークンを Android Keystore に保存します
リフレッシュトークン: offline_access スコープをリクエストし、セッションを維持するためにトークンのリフレッシュを実装します

Facebook アプリの設定

リリース前に Facebook アプリを Development Mode から Live に切り替えます
アプリの SHA-1 キーフィンガープリントを Facebook Developer Console に追加します
Login SDK を使用するアプリに適用される Facebook の Data Policy 要件を確認します

Google Play ストア

サードパーティ認証を使用するアプリに関する Google Play のポリシーに従います
アプリのプライバシーポリシーに Facebook Login を含めます

次のステップ

他のIDプロバイダーを設定

Google、Apple などのソーシャルログインプロバイダーを追加

Attack Protection

ブルートフォース攻撃やボット攻撃を防止

Actions

サーバーレスコードで認証フローをカスタマイズ

Android SDK リファレンス

Auth0 Android SDK のドキュメント全体を参照

​開始する前に

​はじめに

​トラブルシューティングと高度なトピック

​認証エラーによりトークン交換が失敗する

​セッショントークンのリクエストでエラーが返される

​AuthenticationException: “Connection not found”

​ユーザープロフィールのフィールドが不足している

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

​Facebook アプリの設定

​Google Play ストア

​次のステップ

他のIDプロバイダーを設定

Attack Protection

Actions

Android SDK リファレンス

開始する前に

はじめに

トラブルシューティングと高度なトピック

認証エラーによりトークン交換が失敗する

セッショントークンのリクエストでエラーが返される

`AuthenticationException`: “Connection not found”

ユーザープロフィールのフィールドが不足している

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

Facebook アプリの設定

Google Play ストア

次のステップ