> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

使用する SDK と認証フローによっては、ほとんど、またはまったく追加設定を行わずに、ネイティブアプリケーションに [ボット検出](/ja/docs/secure/attack-protection/bot-detection) を追加できます。

<div id="auth0swift-and-auth0android">
  ## Auth0.swift と Auth0.Android
</div>

<Tooltip tip="Universal Login: アプリケーションは、ユーザーの本人確認のために、Auth0 の認可サーバーでホストされる Universal Login にリダイレクトされます。" cta="用語集を見る" href="/ja/docs/glossary?term=Universal+Login">Universal Login</Tooltip> を使用している場合、<Tooltip tip="Universal Login: アプリケーションは、ユーザーの本人確認のために、Auth0 の認可サーバーでホストされる Universal Login にリダイレクトされます。" cta="用語集を見る" href="/ja/docs/glossary?term=Bot+Detection">ボット検出</Tooltip> は、次の SDK バージョンで自動的にサポートされます。

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

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

* アプリケーションでは、`requires_verification` 例外 (高リスクのログイン試行が検出されたときにスローされます) を処理し、続いて キャプチャ 検証ステップを表示するための WebAuth フローを開始する必要があります。
* WebAuth フローを開始する際に、ユーザーが username を再入力しなくて済むよう、`login_hint` パラメーターを渡すことができます。

<div id="auth0swift-example">
  ### Auth0.swift の例
</div>

アプリケーションで [Authentication API](https://auth0.com/docs/api/authentication) を使用してデータベースのログインまたはサインアップを実行する場合は、`isVerificationRequired` エラーを処理する必要があります。このエラーは、リクエストが不審と判定され、ユーザーの認証に追加の確認手順が必要であることを示します。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  この確認手順は Web ベースで実行されるため、完了するには [Universal Login](/ja/docs/authenticate/login/auth0-universal-login) を使用する必要があります。
</Callout>

```swift lines expandable theme={null}
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): // ...
        }
    }
```

サインアップの場合は、[追加のパラメーター](/ja/docs/authenticate/login/auth0-universal-login) を指定して、ユーザーをサインアップページに直接遷移させることができます。

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

Universal Login の設定方法について詳しくは、[Auth0.swift Getting Started](https://github.com/auth0/Auth0.swift#getting-started) を参照してください。

<div id="auth0android-example">
  ### Auth0.Android の例
</div>

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

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  この検証手順は Web ベースで行われるため、完了するには [Universal Login](/ja/docs/authenticate/login/auth0-universal-login) を使用する必要があります。
</Callout>

```swift lines expandable theme={null}
final String email = "username@domain.com";
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() {
                                // AuthCallbackインスタンスがすでに定義済みの場合があります

                                @Override
                                public void onFailure(@NonNull Dialog dialog) {
                                    // エラーダイアログが利用可能
                                }

                                @Override
                                public void onFailure(AuthenticationException exception) {
                                    // エラー
                                }

                                @Override
                                public void onSuccess(@NonNull Credentials credentials) {
                                    // WebAuth成功時の処理
                                }
                            });
                }
            }

            @Override
            public void onSuccess(Credentials payload) {
                // API成功時の処理
            }
        });
```

サインアップの場合は、[追加のパラメーター](/ja/docs/authenticate/login/auth0-universal-login)を指定することで、ユーザーをサインアップページに直接遷移させることができます。

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

Universal Login の設定方法の詳細については、[Auth0.Android Authentication with Universal Login SDK documentation](https://github.com/auth0/Auth0.Android#authentication-with-universal-login)を参照してください。

<div id="lockswift-and-lockandroid">
  ## Lock.Swift と Lock.Android
</div>

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

* `Lock.Swift` バージョン 2.19.0 以降
* `Lock.Android` バージョン 2.22.0 以降

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

* アプリケーションで `requires_verification` 例外 (高リスクのログイン試行が検出されたときにスローされます) を処理し、その後、キャプチャ検証ステップを表示するための WebAuth フローを開始する必要があります。
* WebAuth フローを開始する際に `login_hint` パラメーターを渡すと、ユーザーがユーザー名を再入力せずに済みます。

<div id="authentication-api">
  ## Authentication API
</div>

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

* アプリケーションでは、`requires_verification` エラー (高リスクのログイン試行が検出された場合に Authentication API から返されます) を処理し、その後、キャプチャの検証ステップを表示するために WebAuth フローを開始する必要があります。

<div id="learn-more">
  ## 詳しく見る
</div>

* [カスタムログインページに ボット検出 を追加する](/ja/docs/secure/attack-protection/bot-detection/bot-detection-custom-login-pages)