SDK adaptatif pour Android

Introduction

Ce guide explique comment utiliser l'accès adaptatif dans une application Android native à l'aide du SDK IBM Security Verify Adaptive pour Android. Le SDK adaptatif pour Android fournit des classes qui gèrent les transactions d'authentification dépendant de politiques qui incluent des déterminations de risque d'accès adaptatif.

Pour une compréhension plus approfondie des différentes entités impliquées dans l'accès adaptatif, voir l'accès adaptatif.

Prérequis

Abonnement à Adaptive Access

Assurez-vous que votre locataire IBM Security Verify a activé l'abonnement Adaptive Access. Vous pouvez vérifier vos abonnements actifs sous Configuration > Abonnements dans la console d'administration de votre locataire.

Android Studio

Vous devez avoir installé Android Studio sur la machine où vous allez créer et exécuter l'exemple d'application décrit dans ce guide. Téléchargez Android Studio ici.

SDK adaptatif pour Android

Vous devez disposer du SDK adaptatif pour Android dans votre environnement de développement. Il peut être téléchargé à partir de l'IBM Security App Exchange.

Définition d'une application personnalisée

Créez une définition d'application personnalisée et procédez à l'intégration adaptative (Adaptive Sign-On on-boarding). Dans le cadre du processus d'intégration, veillez à sélectionner mobile. Cela créera un lien qui vous permettra de télécharger le SDK Trusteer. Pour plus d'informations, voir Embarquez votre application.

Trusteer SDK

Utilisez le lien qui s'affiche après l'inscription à l'Adaptive Sign-On pour télécharger le SDK Trusteer.

Mise en place de l'environnement

Vous allez maintenant configurer votre environnement de développement Android Studio en créant une nouvelle application mobile et en installant les dépendances nécessaires.

Créer un nouveau projet Android Studio

  1. Ouvrez Android Studio, et cliquez sur + Créer un nouveau projet.
  2. Sélectionnez Activité vide dans l'onglet Téléphone et tablette, puis cliquez sur Suivant.
  3. Donnez un nom à votre exemple d'application et cliquez sur Terminer.

Ajouter le Android SDK adaptatif et le SDK Trusteer au projet

  1. Allez dans Fichier > Nouveau > Nouveau Module....

  2. Sélectionnez Importer un paquet . JAR/.AAR, puis cliquez sur Suivant.

  3. Sous Nom du fichier, sélectionnez l'emplacement du fichier tas-release.aar téléchargé à partir du SDK Trusteer (voir SDK Trusteer ).

  4. Cliquez sur Finish.

  5. Répétez les étapes 2 à 4 pour le fichier IBMAdaptiveSdk.aar téléchargé depuis IBM Security Verify Adaptive SDK for Android.

  6. Ajoutez les lignes suivantes au corps de dependencies du fichier build.gradle de votre application :

    implementation project(':tas-release')
    implementation project(':IBMAdaptiveSdk')
    implementation 'androidx.lifecycle:lifecycle-extensions:2.2.0'
    

Référencement des fichiers de support du SDK

  1. À partir du SDK Trusteer téléchargé, déplacez le fichier SDK-S/TrusteerServiceCollection.kt vers votre projet Android Studio.

    • Il se peut que vous deviez mettre à jour le nom package en haut de ce fichier.
  2. À partir du SDK Trusteer téléchargé, déplacez les fichiers default_conf.rpkg et manifest.rpkg dans le dossier assets de votre projet Android Studio à <Votre_projet>/app/src/main/assets.

    • Il se peut que vous deviez créer manuellement ce dossier d' actifs s'il n'existe pas.
    • Vous devrez générer le fichier manifest.rpkg Pour ce faire, reportez-vous à l'étape 4C de la documentation sur la procédure de configuration manuelle.
  3. Vous pouvez utiliser les SDK dans le code en important les modules :

    import com.ibm.security.adaptivesdk.*
    import com.trusteer.tas.*
    

Utiliser le SDK

Le Android SDK adaptatif doit être utilisé conjointement avec le SDK Proxy adaptatif.

Pour plus de documentation sur les fonctions de l'Adaptive Android SDK, consultez le fichier README.md dans le document téléchargé IBM Security Verify SDK adaptatif pour Android.

Pour une vue d'ensemble de l'accès adaptatif, voir Accès adaptatif.

Code exemple

Pour un exemple d'application Android utilisant le Android SDK adaptatif, voir l 'exemple d'application GitHub.