Ajouter Bot Detection aux applications natives

Découvrez comment ajouter la protection et la détection des bots à vos applications natives qui utilisent Auth0.Swift, Auth0.Android, Lock.Swift et Lock.Android.

Vous pouvez ajouter Bot Detection à vos applications natives avec peu ou pas de configuration supplémentaire, selon le SDK et le flux d’authentification utilisés.

​

Auth0.swift et Auth0.Android

Si vous utilisez Universal Login, Bot Detection est pris en charge automatiquement par les versions de SDK suivantes :

• Auth0.swift version 1.28.0+
• Auth0.Android version 1.25.0+

Si vous n’utilisez pas Universal Login, Bot Detection est pris en charge, mais vous devez configurer votre application en conséquence :

• Votre application doit gérer l’exception requires_verification (qui est levée lorsqu’une tentative de connexion à risque élevé est détectée), puis déclencher un flux WebAuth pour afficher une étape de vérification CAPTCHA.
• Lorsque vous déclenchez le flux WebAuth, vous pouvez transmettre le paramètre login_hint pour éviter que l’utilisateur doive saisir de nouveau son nom d’utilisateur.

​

Exemple avec Auth0.swift

Si votre application effectue une connexion ou une inscription par base de données au moyen de l’Authentication API, vous devez gérer l’erreur isVerificationRequired. Cette erreur indique que la requête a été signalée comme suspecte et qu’une étape de vérification supplémentaire est nécessaire pour authentifier l’utilisateur.

Cette étape de vérification se fait sur le Web; vous devez donc utiliser Universal Login pour la terminer.

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()
                    // ☝🏼 Otherwise a session cookie will remain
                    .parameters(["login_hint": email])
                    // ☝🏼 Pour que l'utilisateur n'ait pas à le retaper
                    .start { result in
                        // ...
                    }
            }
        case .failure(let error): // ...
        }
    }

Pour l’inscription, vous pouvez ajouter un paramètre supplémentaire pour que l’utilisateur soit redirigé directement vers la page d’inscription :

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

Consultez Auth0.swift Getting Started pour savoir comment configurer Universal Login.

​

Exemple d’Auth0.Android

Si votre application effectue une connexion/inscription avec Database par l’entremise de l’Authentication API, vous devez gérer l’erreur AuthenticationException#isVerificationRequired(). Cette erreur indique que la requête a été signalée comme suspecte et qu’une étape de vérification supplémentaire est nécessaire pour permettre à l’utilisateur de se connecter.

Cette étape de vérification se fait sur le Web; vous devez donc utiliser Universal Login pour la terminer.

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); // L'utilisateur n'a pas à le saisir de nouveau
                    WebAuthProvider.login(account)
                            .withConnection(realm)
                            .withParameters(params)
                            .start(LoginActivity.this, new AuthCallback() {
                                // Vous avez peut-être déjà une instance AuthCallback définie

                                @Override
                                public void onFailure(@NonNull Dialog dialog) {
                                    // Boîte de dialogue d'erreur disponible
                                }

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

                                @Override
                                public void onSuccess(@NonNull Credentials credentials) {
                                    // Gérer la réussite de WebAuth
                                }
                            });
                }
            }

            @Override
            public void onSuccess(Credentials payload) {
                // Gérer la réussite de l'API
            }
        });

Pour l’inscription, vous pouvez ajouter un paramètre supplémentaire pour que l’utilisateur arrive directement sur la page d’inscription :

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

Consultez la documentation du SDK Auth0.Android Authentication with Universal Login pour savoir comment configurer Universal Login.

​

Lock.Swift et Lock.Android

Si vous utilisez Universal Login, Bot Detection est automatiquement pris en charge par les versions de SDK suivantes :

• Lock.Swift version 2.19.0+
• Lock.Android version 2.22.0+

Si vous n’utilisez pas Universal Login, Bot Detection est pris en charge, mais vous devez configurer votre application en conséquence :

• Votre application doit gérer l’exception requires_verification (levée lorsqu’une tentative de connexion à risque élevé est détectée), puis déclencher un flux WebAuth pour afficher une étape de vérification CAPTCHA.
• Lorsque vous déclenchez le flux WebAuth, vous pouvez transmettre le paramètre login_hint pour éviter que l’utilisateur doive saisir de nouveau son nom d’utilisateur.

​

Authentication API

Si vous utilisez directement l’Authentication API, Bot Detection est pris en charge, mais vous devez configurer votre application en conséquence :

• Votre application doit gérer l’erreur requires_verification (renvoyée par l’Authentication API lorsqu’une tentative de connexion à risque élevé est détectée), puis déclencher un flux WebAuth pour afficher une étape de vérification CAPTCHA.

​

En savoir plus

• Ajouter Bot Detection aux pages de connexion personnalisées