ネイティブアプリケーションにボット検出を追加

Auth0.Swift、Auth0.Android、Lock.Swift、Lock.Android を使用するネイティブアプリケーションに、ボット対策と検出を追加する方法を説明します。

使用している SDK と認証フローによっては、ほとんど、あるいはまったく追加設定なしで、ネイティブアプリケーションに ボット検出 を追加できます。

​

Auth0.swift と Auth0.Android

Universal Login を使用している場合、ボット検出 は以下の SDK バージョンで自動的にサポートされます。

• Auth0.swift バージョン 1.28.0+
• Auth0.Android バージョン 1.25.0+

Universal Login を使用していない場合でも、ボット検出はサポートされていますが、それに応じてアプリケーションを設定する必要があります。

• アプリケーションでは、requires_verification 例外 (高リスクのログイン試行が検出されたときにスローされます) を処理し、その後、CAPTCHA 検証ステップをレンダリングするために WebAuth フローをトリガーする必要があります。
• WebAuth フローをトリガーするときは、ユーザーが再度ユーザー名を入力しなくて済むように、login_hint パラメータを渡すことができます。

​

Auth0.swift の例

アプリケーションが Authentication API を使用してデータベース接続でのログイン/サインアップを行う場合は、isVerificationRequired エラーを処理する必要があります。このエラーは、リクエストが不審と判定され、ユーザーを認証するために追加の確認ステップが必要であることを示します。

この確認ステップはWebベースのため、完了するには Universal Login を使用する必要があります。

Auth0
    .authentication()
    .login(usernameOrEmail: email, 
           password: password, 
           realmOrConnection: connection, 
           scope: scope)
    .start { result in
        switch result {
        case .success(let credentials): // ...
        case .failure(let error) where error.isVerificationRequired:
            DispatchQueue.main.async {
                Auth0
                    .webAuth()
                    .connection(connection)
                    .scope(scope)
                    .useEphemeralSession()
                    // ☝🏼 そうしないとセッションCookieが残ります
                    .parameters(["login_hint": email])
                    // ☝🏼 ユーザーが再入力しなくて済むようにするため
                    .start { result in
                        // ...
                    }
            }
        case .failure(let error): // ...
        }
    }

サインアップの場合、ユーザーが直接サインアップページに移動するように、追加のパラメータを追加できます。

.parameters(["login_hint": email, "screen_hint": "signup"])

Universal Login の設定方法について詳しくは、Auth0.swift Getting Startedをお読みください。

​

Auth0.Android の例

アプリケーションが Authentication API を使用してデータベースのログイン/サインアップを行う場合は、AuthenticationException#isVerificationRequired() エラーを処理する必要があります。このエラーは、リクエストが不審であると判定され、ユーザーをログインさせるには追加の認証ステップが必要であることを示します。

この認証ステップは Web ベースのため、完了するには Universal Login を使用する必要があります。

final String email = "[e-mail]";
final String password = "a secret password";
final String realm = "my-database-connection";

AuthenticationAPIClient authentication = new AuthenticationAPIClient(account);
authentication.login(email, password, realm)
        .start(new BaseCallback<Credentials, AuthenticationException>() {

            @Override
            public void onFailure(AuthenticationException error) {
                if (error.isVerificationRequired()){
                    Map<String, Object> params = new HashMap<>();
                    params.put("login_hint", email); // ユーザーが再度入力しなくて済むように
                    WebAuthProvider.login(account)
                            .withConnection(realm)
                            .withParameters(params)
                            .start(LoginActivity.this, new AuthCallback() {
                                // You might already have an AuthCallback instance defined

                                @Override
                                public void onFailure(@NonNull Dialog dialog) {
                                    // Error dialog available
                                }

                                @Override
                                public void onFailure(AuthenticationException exception) {
                                    // Error
                                }

                                @Override
                                public void onSuccess(@NonNull Credentials credentials) {
                                    // Handle WebAuth success
                                }
                            });
                }
            }

            @Override
            public void onSuccess(Credentials payload) {
                // Handle API success
            }
        });

サインアップの場合は、ユーザーが直接サインアップページに移動するように、追加のパラメータを指定できます。

params.put("screen_hint", "signup");

Universal Login の設定方法について詳しくは、Auth0.Android Authentication with Universal Login SDK documentationをご覧ください。

​

Lock.Swift と Lock.Android

Universal Login を使用している場合、ボット検出は次の SDK バージョンで自動的にサポートされます。

• Lock.Swift バージョン 2.19.0+
• Lock.Android バージョン 2.22.0+

Universal Login を使用していない場合でも、ボット検出はサポートされますが、それに合わせてアプリケーションを設定する必要があります。

• アプリケーションでは、requires_verification 例外 (高リスクのログイン試行が検出されたときにスローされる) を処理し、その後、WebAuth フローをトリガーして CAPTCHA 検証ステップをレンダリングする必要があります。
• WebAuth フローをトリガーするときに login_hint パラメータを渡すと、ユーザーはユーザー名をもう一度入力せずに済みます。

​

Authentication API

Authentication API を直接使用している場合、ボット検出はサポート対象ですが、そのためにはアプリケーションを適切に設定する必要があります。

• アプリケーションは requires_verification エラー (高リスクのログイン試行が検出された場合に Authentication API から返されます) を処理し、その後、CAPTCHA 検証ステップをレンダリングするために WebAuth フローをトリガーする必要があります。

​

さらに詳しく

• カスタムログインページにボット検出を追加する