Passer au contenu principal

Premiers pas avec le SDK BlackBerry Dynamics pour iOS

Téléchargez, installez et configurez le SDK BlackBerry Dynamics pour iOS.

·

Blog

·

En savoir plus

Découvrez les composants et les avantages de la plateforme BlackBerry Dynamics Secure Mobility. Cette ressource fournit des informations sur l'utilisation du SDK BlackBerry Dynamics pour iOS, Android, Cordova et React Native. Pour plus d'informations sur l'utilisation du SDK pour toutes les plateformes disponibles, consultez la documentation du SDK BlackBerry Dynamics.

Présentation générale de l'architecture

Le SDK BlackBerry Dynamics offre un ensemble d'outils performants aux éditeurs de logiciels indépendants (ISV) et aux développeurs d'entreprise. Il permet aux développeurs de se concentrer sur la création d'applications commerciales et professionnelles plutôt que sur l'apprentissage des méthodes de sécurisation, de déploiement et de gestion de ces applications. La plateforme BlackBerry Dynamics comprend :

  • Gestion du cycle de vie

  • Politiques de sécurité et de conformité

  • Connexion sécurisée aux services d'entreprise

  • Stockage sécurisé

  • Communication sécurisée entre applications

  • Configuration des applications et règles spécifiques aux applications

La manière la plus simple de comprendre la plateforme BlackBerry Dynamics est de la considérer comme composée de trois éléments clés : le SDK BlackBerry Dynamics et les serveurs BlackBerry (BlackBerry UEM), reliés par l’infrastructure cloud BlackBerry (ou Centre d’exploitation du réseau). BlackBerry Dynamics fournit les services et l’architecture nécessaires pour développer, déployer en toute sécurité et gérer des applications. BlackBerry UEM inclut la plateforme BlackBerry Dynamics Secure Mobility et propose la solution de gestion de la mobilité d’entreprise (EMM) permettant de gérer les appareils en toute sécurité.

Avec l'acquisition de Good Technology par BlackBerry, BlackBerry a mis au point une solution unifiée dotée des meilleures fonctionnalités de sa catégorie en matière de « Bring Your Own Device » (BYOD), de gestion des appareils mobiles (EMM) et de gestion des appareils mobiles (MDM).

 Plateforme de mobilité sécurisée BlackBerry Dynamics

La plateforme BlackBerry Dynamics (BD) se compose de BD Runtime, du centre d'exploitation réseau (NOC) BD et des serveurs BD.

Le BD Runtime est intégré à toutes les applications mobiles BD. Ce runtime dispose d'une API qui permet à l'application d'accéder à des fonctionnalités telles que l'activation, l'authentification des utilisateurs, le stockage sécurisé, la communication derrière un pare-feu et bien plus encore, tout en appliquant les politiques de sécurité au nom de l'entreprise. Pour utiliser le BD Runtime, vous devez télécharger le SDK BlackBerry Dynamics correspondant à la plateforme cible (iOS, Android, Cordova, React Native).

En intégrant le SDK BlackBerry Dynamics à votre application, vous aurez accès aux politiques d'application, à la communication inter-applications, au stockage sécurisé, aux services partagés, à la délégation d'authentification, à l'authentification unique (KCD), aux informations de configuration des utilisateurs et des applications, et bien plus encore.

BlackBerry UEM

BlackBerry UEM est le composant serveur qui assure la cohésion de l'ensemble du système. Il combine les fonctionnalités BYOD de pointe de BlackBerry Dynamics avec la meilleure solution EMM (y compris MDM) du marché. Les administrateurs utilisent UEM pour gérer les utilisateurs, les groupes, les politiques, les applications, les configurations d'applications, et bien plus encore.

L'infrastructure cloud BlackBerry (ou NOC) permet une communication sécurisée entre votre application BD Runtime et le proxy BlackBerry. Le cloud BlackBerry vérifie également la validité des clés utilisateur et d'accès avant que les données n'atteignent votre entreprise, tout en prenant en charge l'infrastructure de diffusion sécurisée depuis les applications côté serveur vers les applications BD Runtime.

UEM intègre les serveurs proxy BlackBerry au sein de la solution EMM. Ceux-ci fournissent divers services aux utilisateurs, aux terminaux et aux applications.

Pour les développeurs d'applications, voici ce dont vous bénéficiez :

  • Politiques de sécurité et de conformité

  • Connexion sécurisée aux services d'entreprise

  • Configuration de l'application

  • Règles relatives aux applications

  • Stockage sécurisé sur l'appareil

  • Fonctionnalité « Effacer et verrouiller »

  • Communication sécurisée entre applications

  • Gestion du cycle de vie des applications 

BlackBerry Enterprise Mobility Server (BEMS)

La plateforme BlackBerry Dynamics offre des fonctionnalités mBaaS (Mobile Backend as a Service) destinées aux entreprises. Bon nombre de ces services mBaaS sont implémentés dans le BlackBerry Enterprise Mobility Server (BEMS). Le BEMS assure une connectivité programmatique via des API standardisées vers des systèmes d’entreprise tels que Microsoft SharePoint, Microsoft Teams, Microsoft Exchange, Cisco Jabber, Active Directory et bien d’autres encore. Le BEMS fournit des API permettant d’invoquer des services tels que les notifications push, les recherches dans les annuaires, le stockage clé-valeur, l’accès aux documents, la messagerie instantanée et la présence. Les développeurs peuvent intégrer ces services à leurs applications sans avoir besoin de connaissances approfondies sur la configuration ou la connexion à des systèmes de gestion de données back-end spécifiques.

Ces services back-end d'entreprise de haute qualité sont utilisés par BlackBerry Work, BlackBerry Connect et d'autres applications BlackBerry Secured. Les applications BlackBerry Secured développées par des éditeurs de logiciels indépendants (ISV) et les applications personnalisées peuvent également tirer parti de ces services.

Zoom sur les SDK BlackBerry Dynamics

La plateforme BlackBerry Dynamics propose toute une gamme de kits de développement logiciel (SDK) et de plug-ins, permettant aux développeurs de travailler dans des environnements familiers pour créer des applications natives, hybrides et Web. Une fois les applications développées, les développeurs peuvent endosser le rôle d'administrateur informatique afin de valider rapidement la gestion et la distribution de leurs applications via la plateforme BlackBerry Dynamics.

Le SDK BlackBerry Dynamics est disponible en version native sur les principales plateformes et technologies de développement, notamment iOS et Android.

De plus, BlackBerry prend en charge les frameworks de développement multiplateformes grâce à des SDK BlackBerry Dynamics dédiés pour Cordova et React Native.

Services de sécurité

Les services de sécurité vous permettent de répondre aux préoccupations liées à la sécurité lorsque des informations sensibles de l'entreprise sont mises à disposition sur des appareils mobiles. Vous pouvez ainsi vous assurer que le contenu stocké sur les appareils, échangé avec des ressources situées derrière le pare-feu de l'entreprise ou partagé entre des applications sécurisées par BlackBerry est toujours chiffré. La plateforme utilisant des bibliothèques de chiffrement de niveau gouvernemental indépendantes de l'appareil, le contenu est systématiquement chiffré. Le SDK BlackBerry Dynamics prend en charge les services de sécurité suivants :

  • API d'identité et d'autorisation

  • API de stockage sécurisé

  • API de communication sécurisées

  • API permettant un échange sécurisé de données entre applications

Services mobiles

Les services mobiles vous permettent de créer des applications attrayantes qui amélioreront la productivité des utilisateurs. Vous pouvez réduire le temps de développement en utilisant des services existants : plus besoin de tout créer de zéro ! Et comme la plateforme BlackBerry Dynamics sert de base à tous les services, un chiffrement de niveau gouvernemental garantit une sécurité de bout en bout. Le SDK BlackBerry Dynamics prend en charge les services mobiles suivants :

  • Service de présence

  • Service d'envoi d'e-mails

  • Service de transfert de fichiers

  • Service de notifications push

  • Service de recherche d'annuaire

  • Service de documentation

  • Service de lancement

Services de plateforme

Les services de la plateforme facilitent l'intégration des applications à l'infrastructure d'entreprise (par exemple, Active Directory, SharePoint, Exchange, Office 365, Lync). Concentrez-vous sur la création d'applications innovantes sans vous soucier de la programmation du back-end, de la maintenance des serveurs ou du déploiement d'une infrastructure complexe. Authentification unique, évolutivité horizontale, haute disponibilité/reprise après sinistre, accès à l'intranet sans VPN : tout cela est rendu possible simplement en s'appuyant sur la version actuelle de la plateforme BlackBerry Dynamics. Le SDK BlackBerry Dynamics prend en charge les services mobiles suivants :

  • Gestion des identités et des accès

  • Authentification à connexion unique

  • Déploiement fiable d'applications à grande échelle

  • Accès sécurisé aux données de l'entreprise

  • Contrôles au niveau des applications pour les services informatiques


Installation et configuration

Téléchargez, installez et configurez le SDK BlackBerry Dynamics pour iOS.
Utilisez l'une des méthodes suivantes pour intégrer le SDK BlackBerry Dynamics. Il est recommandé d'intégrer le SDK à l'aide de CocoaPods.

Configuration logicielle requise

Voir la section « Configuration requise et prise en charge des fonctionnalités spécifiques à chaque plateforme » dans le Guide de développement du SDK BlackBerry Dynamics.

Utiliser CocoaPods

  1. Si vous ne disposez pas d'un fichier Podfile, consultez https://cocoapods.org/ pour savoir comment en créer un

  2. Dans votre fichier Podfile, ajoutez la référence suivante au pod « BlackBerry Dynamics SDK » :pod « BlackBerryDynamics »

  3. Pour ajouter BlackBerry Dynamics ATSL à l'application cible en vue des tests d'interface utilisateur, ajoutez le pod suivant dans votre Podfile :pod 'BlackBerryDynamicsAutomatedTestSupportLibrary'
    Pour plus d'informations, consultez Ajoutez des tests automatisés à votre application BlackBerry Dynamics pour iOS.

  4. Si votre application utilise le fichier `default.xcconfig`, ajoutez ce qui suit à la fin de votre Podfile :
    post_install do |installer|
        # Ajouter la configuration du fichier default.xcconfig à la configuration générée par Cocoapods
        si Dir.glob("**/default.xcconfig").first()
            system("find Pods -name 'Pods-*.xcconfig' -exec sh -c 'cat 'find . -name default.xcconfig' »> $1' -- (} \ \;")
        fin
    fin

  5. Installez les pods, puis ouvrez votre fichier d'espace de travail pour afficher le projet dans Xcode :$ pod install 

Utilisez les fichiers disponibles dans le pack SDK

  1. Extract the contents of the BlackBerry_Dynamics_SDK_for_iOS_<version>_dylib.tar.gz file into a directory.

  2. À partir du répertoire «Frameworks» du package SDK extrait, copiez tous les fichiers du framework dans le répertoire de votre choix.

  3. Importez les frameworks dans le projet en les faisant glisser depuis le répertoire

  4. Dans la liste «Frameworks, bibliothèques et contenu intégré» de la cible du projet :

    • AjoutezBlackBerryDynamics.xcframework, BlackBerryCerticom.xcframework, BlackBerryCerticomSBGSE.xcframework; si nécessaire, ajoutez égalementBlackBerryDynamicsAutomatedTestSupportLibrary.xcframework

    • Définissez tous les frameworks ci-dessus sur« Embed and Sign» (Intégrer etsigner) afin que Xcode modifie le fichier de projet en ajoutant les frameworks à l'étape « Embed Frameworks » (Intégrer les frameworks) dans les « Build Phases » (Phases de compilation) et configure les « Runpath Search Paths » (Chemins de recherche du Runpath) en conséquence.


Développer

Développer une application BlackBerry Secured pour iOS

Nouvelle application

La manière la plus simple de se lancer avec le SDK BlackBerry Dynamics pour iOS consiste à utiliser les applications d'exemple BlackBerry Dynamics disponibles dans le pack SDK.

Pour utiliser les applications, procédez comme suit :

  1. Exécutez la commande «pod install» pour installer les dépendances du projet, y compris BlackBerry Dynamics.

  2. Lancez Xcode et ouvrez le projet.

  3. Remplacezl'identifiant du bundlepar le vôtre.

  4. Modifiezl'identifiant d'URLetles schémas d'URLdans le fichier Info.plist.

  5. Remplacezl'identifiant de l'application GDpar le vôtre dans le fichier Info.plist.
    Remarque : Le format général est com.votresociété.nom_de_l'application (en minuscules uniquement, sans espaces, et ne doit pas commencer par com.good ou com.blackberry). Le même identifiant peut être utilisé pour plusieurs applications sur différentes plateformes, telles qu'iOS et Android ; il est donc recommandé d'éviter d'inclure des informations spécifiques à une plateforme (exemple : com.votresociété.ios.application).

  6. Compilez, déployez et exécutez l'application.

Application existante

Ajouter et configurer le SDK BlackBerry Dynamics

Pour ajouter le SDK BlackBerry Dynamics à un projet existant, suivez les étapes décrites dans la section « Installation et configuration ».

Une fois le SDK BlackBerry Dynamics ajouté au projet, suivez les étapes ci-dessous pour le configurer.

  1. Définissez l'ID d'application BlackBerry Dynamics et la version BlackBerry Dynamics dans le fichier Info.plist de l'application.

    GDApplicationID
    Le format général est com.votre-entreprise.nom-de-l'application (uniquement en minuscules, sans espaces, et ne doit pas commencer par com.good ou com.blackberry).
    Le même identifiant peut être utilisé pour plusieurs applications sur différentes plateformes, telles qu'iOS et Android. Il est recommandé d’éviter d’inclure des informations spécifiques à la plateforme (exemple : com.votresociété.ios.application).

    GDApplicationVersion
    Un numéro de version se compose de quatre parties. Utilisez 1.0.0.0 pour la première version de l’application avec le SDK BlackBerry Dynamics
    Il n’est pas recommandé de modifier fréquemment la version, sauf si cela est nécessaire pour fournir un accès différent à des utilisateurs spécifiques ou pour différencier une nouvelle application des versions existantes en raison de l’ajout de nouveaux services.

  2. Ajoutez une référence à une variable dans les spécificateurs de schéma d'URL et d'identifiant d'URL. Ajoutez le code suivant dans le fichier info.plist.
    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleURLName</key>
            <string>Bundle_Identifier_of_your_app</string>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>Bundle_Identifier_of_your_app.sc2</string>
                <string>Bundle_Identifier_of_your_app.sc2.1.0.0.0</string>
                <string>Bundle_Identifier_of_your_app.sc3</string>
                <string>com.good.gd.discovery</string>
            </array>
        </dict>
    </array>

  3. Le SDK BlackBerry Dynamics doit utiliser l'appareil photo de l'appareil et peut être configuré pour utiliser l'authentification FaceID ; par conséquent, les clés NSFaceIDUsageDescription et NSCameraUsageDescription doivent être ajoutées au fichier InfoPlist.strings si l'application existante ne le fait pas déjà.
    "NSFaceIDUsageDescription" = "Permet l'authentification sans mot de passe.";
    "NSCameraUsageDescription" = "Autoriser l'utilisation de l'appareil photo pour scanner un code QR" ;

Intégrer le SDK BlackBerry Dynamics

Pour fonctionner en tant qu'application BlackBerry Dynamics, l'application doit utiliser le protocoleGDiOSDelegateet l'exécution du code de lancement doit être différée jusqu'à ce que l'utilisateur final ait été authentifié.

Voici les principales étapes à suivre :

  1. Implémentez le protocoleGDiOSDelegatepour recevoir des objetsGDAppEventprovenant du SDK BlackBerry Dynamics.

  2. Utilisezla fonction GDAppEventfournie dans la méthode de gestionnaire de l'interfaceGDiOSDelegatepour traiter les événements d'autorisation.

  3. Désactivez le chargement automatique du storyboard principal. À la place, chargez le storyboard principal par programmation une fois que l'utilisateur final a été authentifié.

  4. Lancez le processus d'autorisation géré par le SDK BlackBerry Dynamics dans la méthode`didFinishLaunchingWithOptions` de l'application, en appelant la méthode `GDiOS.sharedInstance().authorize()`

Modifiez l'interfaceUIApplicationDelegateafin de différer le chargement de l'interface utilisateur principale jusqu'à ce que l'utilisateur final soit authentifié par le SDK BlackBerry Dynamics.

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window : UIWindow?

    func application(_ application : UIApplication, didFinishLaunchingWithOptions launchOptions :
        [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        // Set the AppDelegate in the GDiOSDelegate
        AppGDiOSDelegate.sharedInstance.appDelegate = self

        // Trigger end-user authorization process with BlackBerry Dynamics SDK
        GDiOS.sharedInstance().authorize(AppGDiOSDelegate.sharedInstance)

        renvoie « true »
    }
}

Implémentez l'interfaceGDiOSDelegatepour gérer les événements provenant du SDK BlackBerry Dynamics et chargez l'interface utilisateur principale lorsque l'événement d'autorisation est reçu.

import BlackBerryDynamics.Runtime

class AppGDiOSDelegate : NSObject, GDiOSDelegate {

    static let sharedInstance = AppGDiOSDelegate()

    var hasAuthorized = false
    weak var appDelegate : AppDelegate?

    func handle(_ anEvent:GDAppEvent) {
        switch anEvent.type {
        case .authorized :
            self.onAuthorized(anEvent) ;
            pause
        cas .notAuthorized :
            self.onNotAuthorized(anEvent);
            pause
        cas .remoteSettingsUpdate :
            //A change to application-related configuration or policy settings.
            pause
        cas .servicesUpdate :
            //A change to services-related configuration.
            pause
        case .policyUpdate :
            //A change to one or more application-specific policy settings has been received.
            pause
        par défaut :
            print("Événement non géré : '\(anEvent.message)'")
            pause
        }
    }

    func onAuthorized(_ anEvent: GDAppEvent) {
        // Handle the BlackBerry Dynamics SDK authorized event
        switch anEvent.code {
        case .errorNone :
            if (!hasAuthorized) {
                // Prepare main storyboard and root view controller
                let mainStoryboard : UIStoryboard = UIStoryboard(name : "Main", bundle : Bundle.main)
                let rootViewController = mainStoryboard.instantiateInitialViewController()

                self.appDelegate!.window?.rootViewController = rootViewController
                hasAuthorized = true
            }
        par défaut :
            assert(false, "Démarrage autorisé avec une erreur")
            pause
        }
    }
}


Déploiement et tests

Déployez votre application BlackBerry Dynamics sur un smartphone, une tablette ou un émulateur à des fins de test.

Vous devez disposer des éléments suivants :
Une connexion Internet
Un smartphone, une tablette ou un émulateur pris en charge par BlackBerry Dynamics
Un serveur BlackBerry UEM ou le mode de simulation d'entreprise

Remarque : il est possible d'effectuer des tests automatisés du SDK BlackBerry Dynamics à l'aide des API fournies dans la bibliothèque optionnelle « BlackBerry Dynamics Automated Test Support Library » (ATSL) ; vous trouverez ci-dessous plus de détails sur la manière de l'intégrer et de l'utiliser.

Mode de simulation d'entreprise

Pour exécuter et tester une application BlackBerry Dynamics, un serveur BlackBerry UEM est nécessaire ; toutefois, bien qu'il présente des limitations importantes,le mode de simulation d'entreprisepeut être utilisé pour tester une application sans connexion à un serveur BlackBerry UEM .

En mode « Simulation d'entreprise », aucune authentification des utilisateurs n'est effectuée au niveau de l'entreprise ; il n'y aura donc aucune communication via le pare-feu de l'entreprise. Si l'application nécessite une connexion derrière le pare-feu, un serveur BlackBerry UEM est alors requis.

Important: lemode de simulation d'entreprisen'est pas destiné à un environnement de production et son exécution est limitée au simulateur iOS.

 

Bien que le mode de simulation d'entreprise ne soit pas adapté au déploiement en production d'une application, il s'avère utile pendant la phase de développement, ainsi que pour vérifier le bon fonctionnement et le comportement des applications existantes lors de leur migration vers BlackBerry Dynamics.

En mode simulation, aucune clé d'activation valide n'est requise pour ouvrir l'application, car il n'y a pas de communication directe avec les serveurs BlackBerry Dynamics. La communication avec le centre d'exploitation réseau (NOC) de BlackBerry Dynamics se poursuit toutefois.

 

Pour activer le mode de simulation d'entreprise pour une application BlackBerry Dynamics, ajoutez les éléments suivants au fichier Info.plist :

<key>GDLibraryMode</key>
<string>GDEnterpriseSimulation</string>

Pour la désactiver, remplacez la valeur par «GDEnterprise» ou supprimez purement et simplement la clé.

 

Lorsqu'une application BlackBerry Dynamics est lancée pour la première fois sur un terminal cible, elle doit être activée auprès du serveur BlackBerry Dynamics. Enmode « Simulation d'entreprise », n'importe quelle adresse e-mail et n'importe quelle clé d'accès de 15 caractères sont valides pour mener à bien le processus d'activation. Une fois l'application activée, celle-ci invitera l'utilisateur à créer un mot de passe.

Le lien « Exigences relatives aux mots de passe », situé en bas de l'écran, fournit des indications sur la complexité requise pour les mots de passe. Lorsque le système ne fonctionne pas enmode « Simulation d'entreprise», la complexité des mots de passe est contrôlée via des politiques gérées par votre administrateur informatique à partir de la console de gestion UEM .

 

Le mode de simulation d'entrepriseprésente les différences suivantes par rapport à l'exécution standard d'une entreprise :

  • La mention [Simulé]s'affichera dans l'interface utilisateur de BlackBerry Dynamics Runtime

  • Toute adresse e-mail et toute clé d'activation seront acceptées pour l'activation en mode entreprise

  • Aucune information n'est en réalité transmise aux serveurs de l'entreprise, y compris l'adresse e-mail et la clé d'activation.

  • Le processus de provisionnement et de configuration des politiques est simulé dans l'interface utilisateur

  • Un ensemble de règles de sécurité et de conformité codées en dur est en vigueur ; l'authentification n'est pas déléguée.

  • Lorsqu'elle est exécutée sur un appareil réel, et non sur un émulateur, l'application sera effacée

  • Toute tentative visant à faire passer le mode d'une application déjà installée sur un appareil de « GDEnterprise » à « GDEnterpriseSimulation » entraînera la suppression de l'application.

  • Il n'existe aucune procédure de récupération en cas de mot de passe perdu.

  • La communication inter-conteneurs (ICC) ne peut pas être utilisée, ce qui signifie que l'API BlackBerry Dynamics Services ne peut pas être utilisée

Par ailleurs, les API de stockage sécurisé, de communication sécurisée et de canal push sont toutes disponibles enmode « Simulation d'entreprise ».

Les API de communication ne pourront pas se connecter aux serveurs d'applications d'entreprise via le serveur « UEM », bien qu'il soit toujours possible d'établir des connexions directes avec ces serveurs, par exemple si le simulateur iOS s'exécute sur une machine connectée au réseau d'entreprise ou via un VPN.

Utilisation du serveur BlackBerry UEM

Une instance BlackBerry UEM ou BlackBerry UEM Cloud est nécessaire pour effectuer des tests sur un smartphone ou une tablette réel(le).

Suivez les étapes indiquées pour configurer une application BlackBerry Secured en vue de la tester dans l'UEM. Si vous ne disposez pas encore d'une instance d'UEM , vous pouvez en configurer une à l'aide d'une licence d'essai gratuite pour développeurs. Cliquez ici pour générer une licence d'essai et commencer à configurer votre serveur.

Une fois les serveurs mis en place, passez aux étapes suivantes.

1) Configurez l'application sur BlackBerry UEM ou BlackBerry UEM Cloud

La première chose à faire est de définir l'application dans le BlackBerry UEM 

  1. Connectez-vous à la console de gestion BlackBerry UEM .

  2. Cliquez sur « Applications » > « Nouvelle application » > « Droits d'accès aux applications BlackBerry Dynamics internes » > « Suivant ».

  3. Indiquez l'identifiant d'autorisation BlackBerry Dynamics et la version d'autorisation BlackBerry Dynamics définis dans le fichier Info.plist. Par exemple : com.mycompany.testApp et 1.0.0.0.

  4. Cliquez sur « Ajouter ».

Votre application sera ajoutée à la liste des applications disponibles. Si vous devez fournir des paramètres de configuration supplémentaires pour votre application, tels que l'ajout de serveurs à la liste blanche ou la configuration d'une politique d'application, sélectionnez votre application dans la liste et configurez-la comme il se doit.

Recommandation: ajoutez l'identifiant du bundle (Bundle ID) à la configuration de l'application. Cela permet d'utiliser la fonctionnalité «Easy Activation », qui évite d'avoir à saisir une clé d'accès lors du premier lancement de l'application. Cette opération est également obligatoire si votre application utilise des services BlackBerry AppKinetics.

Pour additionner ces valeurs :

  1. Cliquez sur l'application.

  2. Dans l'onglet « iOS », saisissez la valeur appropriée

  3. Cliquez sur « Enregistrer ».

2) Désactiver la détection anti-débogage

BlackBerry UEM permet d'empêcher l'exécution des versions de débogage des applications BlackBerry Dynamics. Pour permettre le développement d'applications, cette fonctionnalité doit être désactivée dans le profil de conformité attribué à l'utilisateur chargé des tests.

Pour désactiver cette règle, procédez comme suit :

  1. Connectez-vous à la console d'administration d'UEM .

  2. Dans le menu de gauche, cliquez sur « Politiques et profils » > « Conformité ».

  3. Ouvrez le profil de conformité attribué à l'utilisateur test.

  4. Dans l'onglet « iOS », si l'option « Système d'exploitation jailbreaké » est cochée, assurez-vous que l'option « Activer la protection anti-débogage pour les applications BlackBerry Dynamics »n'estpassélectionnée.

3) Accorder des droits aux utilisateurs de l'application

Une fois qu'une application est enregistrée sur un serveur BlackBerry UEM , les utilisateurs doivent disposer des droits nécessaires pour l'installer et l'utiliser. Ces droits peuvent être accordés à des utilisateurs individuels ou à des groupes d'utilisateurs. Pour un déploiement en production, il est recommandé d'utiliser des groupes d'utilisateurs. Lors du développement ou des tests, il est possible d'utiliser des utilisateurs individuels.

Pour attribuer une application à un utilisateur spécifique, procédez comme suit :

  1. Connectez-vous à la console d'administration d'UEM .

  2. Recherchez et sélectionnez un compte utilisateur.

  3. Dans la section « Applications » du profil utilisateur, cliquez sur +.

  4. Recherchez et sélectionnez votre application.

  5. Cliquez sur « Suivant ».

  6. Laissez le paramètre « Disposition » sur « facultatif » (l'installation ne sera pas imposée) et cliquez sur « Attribuer ».

  7. En fonction de la configuration de votre délégué d'authentification, vous devrez peut-être générer unmot de passe d'activationqui sera utilisé lors du premier lancement de l'application après son installation.

Pour générer un nouveaumot de passe d'activation:

  1. Dans le profil de l'utilisateur, sous l'onglet « Résumé », cliquez sur «Définir le mot de passe d'activation ».

  2. Dans la liste déroulante « Option d'activation », cliquez sur «Activation par défaut du périphérique ».

  3. Dans la liste déroulante « Mot de passe d'activation », cliquez sur «Définir le mot de passe d'activation de l'appareil ».

  4. Dans le champ « Mot de passe d'activation de l'appareil », saisissez le mot de passe qui sera utilisé lors du premier lancement de l'application après son installation.

  5. À des fins de développement, il peut être utile de prolonger la durée de validité de l'activation jusqu'à la durée maximale autorisée (30 jours)

  6. Cliquez sur « Soumettre ».

  7. L'utilisateur reçoit un e-mail contenant ses identifiants ainsi qu'un code QR qui lui permettra d'activer l'application lors de son premier lancement après l'installation.
    L'e-mail envoyé à l'utilisateur est également accessible depuis la console UEM en cliquant sur le lien « Afficher l'e-mail d'activation ».

  8. Installez l'application sur la cible souhaitée en utilisant la méthode de déploiement de votre choix (y compris via Xcode).

  9. Lorsque vous y êtes invité, sélectionnez un type d'activation parmi ceux proposés. 

    • Utilisez l'option « Saisir les identifiants » pour utiliser directement votre adresse e-mail et votre mot de passe d'activation.

    • Utilisez l'option « Scanner le code QR » si l'application est installée sur un appareil équipé d'un appareil photo et si le code QR figurant dans l'e-mail d'activation peut être scanné, même à partir d'un écran.

Tests automatisés du SDK BlackBerry Dynamics

Le SDK BlackBerry Dynamics inclut labibliothèqueATSL (Automated Test Support Library) de BlackBerry Dynamics, qui permet de prendre en charge les tests automatisés de vos applications BlackBerry Dynamics.

Cette bibliothèque comprend des fonctions d'aide permettant de tester les interactions courantes des utilisateurs dans les applications BlackBerry Dynamics, telles que l'activation et l'autorisation. La configuration et la structure de la bibliothèque sont compatibles avec les outils proposés par Apple pour tester les interfaces utilisateur.

Il utilise les composants suivants :

  • Framework XCTest

  • Identifiants d'accessibilité

Pour plus d'informations sur ces composants et sur les tests d'interface utilisateur sous iOS, consultez Archives de documentation Apple : Tests de l'interface utilisateur.

Vous pouvez utiliser la bibliothèque BlackBerry Dynamics et les composants de la bibliothèque native mentionnés ci-dessus pour automatiser la création, l'exécution et la génération de rapports de vos tests d'application.

Le BlackBerry Dynamics ATSL étant fourni sous forme de framework, vous ne pouvez pas y apporter vos propres modifications.

Intégrer le framework BlackBerryDynamicsAutomatedTestSupportLibrary

Le framework BlackBerryDynamicsAutomatedTestSupportLibrary peut être intégré à la cible de test d'un projet comme n'importe quel autre framework du SDK BlackBerry Dynamics.

Pour connaître la marche à suivre détaillée, consultez les instructions de la section « Installation et configuration ».

Utilisation du framework BlackBerryDynamicsAutomatedTestSupportLibrary

Dans le même répertoire que le code de test, créez un fichier nommé « credentials.json » dont le contenu sera similaire à celui ci-dessous :

{
    "GD_TEST_PROVISION_EMAIL" : "testUser@mydomain.com",
    « GD_TEST_PROVISION_ACCESS_KEY » : « activationPassword »,
    "GD_TEST_PROVISION_PASSWORD" : "passwordForApplication"
}

Remarque: les champs GD_TEST_PROVISION_EMAIL et GD_TEST_PROVISION_PASSWORD peuvent être codés en dur, mais si le test s'effectue sur une application non activée, la clé GD_TEST_PROVISION_ACCESS_KEY doit être régénérée avant le début des tests via les API REST de BlackBerry UEM , ou bien elle doit être définie manuellement sur le serveur BlackBerry UEM avec une durée de validité prolongée (définissez par exemple la dated’expiration de la période d’activationsur 30 jours).

Si le test ne réinstalle pas l'application et que celle-ci est provisionnée, la valeur de GD_TEST_PROVISION_ACCESS_KEY ne sera pas utilisée, car le SDK BlackBerry Dynamics peut être autorisé simplement à l'aide du mot de passe défini lors du provisionnement initial de l'application, issu du champ GD_TEST_PROVISION_PASSWORD.

 

Pour utiliser la classe BBDAutomatedTestSupport dans un test, procédez comme suit :

  1. Instancier la classe principale BBDAutomatedTestSupport
    let ats = BBDAutomatedTestSupport.sharedInstance()

  2. Chargez les informations d'identification à l'aide de
    ats.fetchCredentials()

  3. Définissez l'objet XCUIApplication à utiliser et configurez BBDAutomatedTestSupport pour qu'il l'utilise.
    let application = XCUIApplication()
    ats.setupBBDAutomatedTestSupport(with: application, for: self)

  4. Lancez le processus d'autorisation à l'aide de
    XCTAssertTrue(ats.loginOrProvisionBBDApp(), "Impossible d'autoriser l'application")

  5. Vérifiez que le processus d'autorisation s'est déroulé correctement et que l'interface utilisateur principale de l'application s'affiche avec un message du type :
    XCTAssertTrue(ats.isScreenShown("AppRootControllerIdentifier", timeout: 120), "L'autorisation via le SDK BlackBerry Dynamics a abouti, mais l'interface utilisateur principale de l'application ne s'est pas affichée")

Remarques :

  • Le fichier JSON contenant les identifiants peut porter un nom et/ou se trouver à un emplacement différents ; il peut être chargé à l'aide de différentes variantes de la fonction`fetchCredentials()`.

  • L'authentification biométrique n'est prise en charge que partiellement par la bibliothèque BlackBerryDynamicsAutomatedTestSupportLibrary car, de par sa nature même, elle ne peut être testée automatiquement que sur un simulateur.


C'est réussi ! Continuer

Félicitations pour avoir développé votre première application sécurisée BlackBerry Dynamics ! Vous pouvez continuer à explorer les API et les ressources pour développeurs disponibles. Découvrez ci-dessous quelques-unes des API les plus courantes.

Les extraits de code mentionnés dans cette section sont disponibles dans les applications d'exemple iOS sur le site GitHub de BlackBerry. Téléchargez les référentiel BlackBerry Dynamics iOS Samples et consultez les projets suivants :

  • Notions de base sur iOS et Objective-C

  • Notions de base - iOS - Swift

  • Dynamics - iOS - Objective-C

  • Dynamics - iOS – Swift

  • Dynamics-SwiftUI-Exemple

Utiliser le système de fichiers BlackBerry Dynamics

Le système de fichiers sécurisé fait partie de la fonctionnalité « BlackBerry Dynamics Secure Storage ». Pour les applications, le système de fichiers sécurisé BlackBerry Dynamics fonctionne comme le gestionnaire de fichiers par défaut, à quelques différences près :

  • Toutes les données contenues dans le système de fichiers sécurisé sont stockées sur l'appareil sous forme chiffrée.

  • Les noms des répertoires et des fichiers sont également chiffrés.

  • Il n'y a pas de répertoire de travail actuel dans le système de fichiers sécurisé. Les chemins d'accès doivent toujours être indiqués sous forme de chemins absolus, commençant par le caractère « / ».

  • L'accès au système de fichiers sécurisé n'est pas possible tant que le traitement d'autorisation BlackBerry Dynamics n'est pas terminé. Pour plus d'informations, consultez la section «authorize » dansla référence des classes GDiOS.

Le chiffrement et le déchiffrement s'effectuent de manière transparente pour le code de l'application :

  • Les interfaces d'écriture de fichiers acceptent des données brutes. Le moteur d'exécution BlackBerry Dynamics crypte les données et les stocke sur l'appareil.

  • Lorsqu'une interface de lecture de fichiers est utilisée, BlackBerry Dynamics Runtime déchiffre les données stockées et renvoie les données en clair.

  • Les interfaces d'accès aux chemins d'accès acceptent des paramètres bruts pour les noms de répertoires et de fichiers. Le moteur d'exécution BlackBerry Dynamics crypte les valeurs de ces paramètres afin de créer des chemins d'accès dans le magasin sécurisé.

  • Les noms de répertoires et de fichiers fournis en tant que valeurs de retour sont en clair. Le moteur d'exécution BlackBerry Dynamics déchiffre les chemins d'accès dans le magasin sécurisé pour générer ces valeurs de retour.

La méthode de chiffrement utilisée par BlackBerry Dynamics Runtime nécessite généralement que l'utilisateur ait saisi un mot de passe de sécurité à partir duquel une clé de chiffrement est générée.

La classe GDFileManager étant une sous-classe de la classe native NSFileManager, les modifications à apporter sont minimes. Il suffit de remplacer les références àNSFileManager pardes références àGDFileManager.

En comparant les extraits de code « avant » et « après » des deux applications d'exemple, vous constaterez les changements suivants :

Natif

import Foundation
...

func writeToNativeFile() -> Bool {
    let text = "Texte non protégé."
    let fileData = text?.data(using: .utf8)
    let filePath = documentsFolderPathForNamed(name: "NativeFileTest.txt")

    //Create a plain file using FileManager
    let fileCreated = FileManager.default()
        .createFile(atPath: filePath,
            contenu : fileData,
            attributs : nil)
    retourner fileCreated
}

Dynamique

import BlackBerryDynamics.SecureStore.File

...

func writeToGDFile() -> Bool {
    let text = "Texte à protéger par BlackBerry Dynamics."
    let fileData = text?.data(using: .utf8)
    let filePath = documentsFolderPathForNamed(name: "EncryptedFileTest.txt")

    //Create an encrypted file using GDFileManager
    let fileCreated = GDFileManager.default()
        .createFile(atPath: filePath,
                contenu : fileData,
                attributs : nil)
    retourner fileCreated
}

 

Utiliser la base de données SQLite de BlackBerry Dynamics

La base de données SQL sécurisée fait partie de la fonctionnalité « BlackBerry Dynamics Secure Storage ». Les données stockées dans la base de données SQL sécurisée sont chiffrées sur l'appareil par le moteur d'exécution BlackBerry Dynamics. La base de données SQL sécurisée de BlackBerry Dynamics repose sur la bibliothèque SQLite. Le chiffrement est ajouté de manière transparente à l'application par BlackBerry Dynamics. L'accès à une base de données SQL sécurisée n'est possible qu'une fois le processus d'autorisation de BlackBerry Dynamics terminé.

Les applications BlackBerry Dynamics accèdent à la base de données sécurisée à l'aide de classes de remplacement pour SQLite natif. Pour utiliser ces classes de remplacement à la place des classes natives, remplacez l'instruction d'importation`sqlite3.h` par`GD_C.SecureStore.SQLite` (pour les sources Swift) ou par`BlackBerryDynamics/GD_C/sqlite3enc.h` (pour les sources Objective-C).

Pour plus d'informations sur l'utilisation des bases de données SQLite, consultez l' API de base de données SQL sécurisée.

Si vous comparez les modifications à apporter au code SQLite entre les exemples natifs et l'exemple BlackBerry Dynamics, vous remarquerez que les changements sont minimes. Des mises à jour sont nécessaires au niveau des instructions d'importation, ainsi que pour l'ouverture et l'importation d'une base de données chiffrée. Le reste du code SQLite de l'application peut rester tel quel. Voici les modifications qui ont été apportées :

Natif

importer SQLite

...

func openDatabase() -> Bool {
    let fileUrl = try! FileManager.default
            .url(for: .documentDirectory,
                dans : .userDomainMask,
                appropriateFor : nil,
                create : false)
        .appendingPathComponent("plain_database.db")
    var db : OpaquePointer? = nil
    let result = sqlite3_open(fileUrl.path, &db)

    retourne result == SQLITE_OK
}

Dynamique

import GD_C.SecureStore.SQLite

...

func openDatabase() -> Bool {
    let fileUrl = try! FileManager.default
                .url(for: .documentDirectory,
                    dans : .userDomainMask,
                    appropriateFor : nil,
                    create : false)
                .appendingPathComponent("encrypted_database.db")
    var db : OpaquePointer? = nil
    let result = sqlite3enc_open(fileUrl.path, &db)

    retourne result == SQLITE_OK
}

Utilisation des connexions HTTP/HTTPS de BlackBerry Dynamics

GDURLLoadingSystem

Les applications BlackBerry Dynamics peuvent utiliser le système natif de chargement d'URL. Les classes natives de ce système permettent de communiquer avec des serveurs d'applications situés derrière un pare-feu d'entreprise ou sur Internet. Une fois qu'un profil de connectivité a été configuré dans BlackBerry UEM pour assurer une communication sécurisée, les classes nativesNSURLSession ouNSURLConnection devraientfonctionner telles quelles.

Consultez le référence API du SDK BlackBerry Dynamics et consultez laclasse GDURLLoadingSystemainsi quela prise en charge de NSURLSession.

L'API GDHttpRequest comme approche alternative

Outre le GDURLLoadingSystem, vous pouvez utiliser l'API GD HTTP Request pour envoyer des requêtes HTTP, telles que GET et POST, depuis l'appareil vers un serveur d'applications. Ce dernier peut se trouver sur Internet ou derrière le pare-feu de l'entreprise. L'API GD HTTP Request repose sur la norme XML Http Request (XHR).

Les communications sécurisées de BlackBerry Dynamics prennent en charge le protocole HTTPS, en utilisant une connexion Secure Socket Layer (SSL) ou SSL/TLS pour envoyer la requête HTTP et recevoir la réponse. Les requêtes HTTP et HTTPS peuvent être relayées par un proxy HTTP ou HTTPS situé sur Internet ou derrière le pare-feu de l'entreprise. L'authentification auprès du proxy est prise en charge.

Lors de l'envoi de requêtes HTTPS via un proxy HTTP, la vérification des certificats SSL/TLS doit être désactivée. La vérification des certificats lors de l'utilisation d'un proxy HTTP n'est pas prise en charge. Les communications de données HTTP de BlackBerry Dynamics ne transitent pas par le proxy spécifié dans les paramètres natifs de l'appareil, le cas échéant.

Le BlackBerry Dynamics Runtime prend en charge les protocoles Basic Access, Digest Access, NTLM et Kerberos pour l'authentification auprès des serveurs HTTP. À l'exception de Kerberos, tous ces mécanismes sont également pris en charge pour l'authentification auprès des proxys HTTP. Le BlackBerry Dynamics Runtime prend en charge l'authentification Kerberos version 5.

Par défaut, les cookies HTTP reçus via la communication sécurisée BlackBerry Dynamics sont gérés automatiquement.

Pour plus d'informations, consultez la documentation de la classe GDHTTPRequest. Les modifications requises pour la classe GD HttpRequest sont répertoriées ci-dessous :

// Open a requested URL using URLSession
func requestData(url : String) {
    let nsUrl = URL(string: url)
    let urlRequest = URLRequest(url: nsUrl!)
    let session = URLSession.init(configuration: URLSessionConfiguration.default, delegate: self,
                delegateQueue : OperationQueue.init())


    let task = session.dataTask(with: urlRequest,
                completionHandler: { (data, response, error) in
                    DispatchQueue.main.async {
                        print(response ?? "res")
                    }
                })
    task.resume()
}

Établir des connexions via le socket BlackBerry Dynamics

Le API GDSocket est asynchrone et basée sur les états. L'application associe ses propres fonctions de rappel de gestion d'événements à l'objet GD Socket. Ces fonctions de rappel sont appelées lorsque des événements liés au socket se produisent ou lorsque le socket change d'état. Les fonctions de l'API pouvant être appelées par l'application dépendent de l'état du socket.

Envoi de données via un GDSocket se déroule en deux étapes. La première étape consiste à ajouter les données au tampon de sortie du socket. Le tampon de sortie du socket est représenté par la propriété `writeStream` et est accessible via la méthode API GDDirectByteBuffer . La deuxième étape consiste à envoyer le contenu du tampon via la connexion du socket. Pour envoyer le tampon, appelez la fonction `write`.

Lecture de données à partir d'un GDSocket est asynchrone. Lorsque des données sont reçues sur l’appareil, elles sont stockées dans le tampon d’entrée du socket. L’application est alors informée que des données sont disponibles pour la lecture, via l’appel de la fonction de rappel onRead. Dans cette fonction de rappel, l’application récupère les données reçues à partir du tampon d’entrée. Le tampon d’entrée est représenté par la propriété readStream et est accessible via l’objet API GDDirectByteBuffer .

L'API GDSocket prend en charge l'utilisation de SSL/TLS pour l'envoi et la réception de données. Par défaut, le moteur d'exécution BlackBerry Dynamics ne propose pas les protocoles TLSv1.1 ni TLSv1.2 pour les connexions SSL/TLS avec un serveur d'applications.

Ces protocoles peuvent être activés comme suit :

  1. Ajoutez une nouvelle ligne au fichier Info.plist de l'application :

    • Clé : GDControlTLSVersions

    • Type : Chaîne (par défaut)

  2. Définissez la valeur comme suit :

    • GDEnableTLS1.1 pour activer le protocole TLSv1.1.

    • GDEnableTLS1.2 pour activer à la fois les protocoles TLSv1.1 et TLSv1.2.

    Sinon, la valeur peut également être un tableau contenant l'une ou les deux chaînes ci-dessus en tant qu'éléments distincts.

Les connexions GDSocket et les requêtes HTTP peuvent être utilisées pour se connecter à des serveurs situés derrière le pare-feu de l'entreprise. L'adresse du serveur d'applications de destination doit être enregistrée dans la console de gestion BlackBerry UEM .

  • Cette adresse peut être enregistrée en tant que serveur de l'application ou en tant que serveur supplémentaire.

  • La configuration du serveur d'applications dans le serveur « UEM » peut être récupérée dans le code de l'application à l'aide de lafonction getApplicationConfig(GDiOS).

La connexion au serveur d'applications s'effectuera via l'infrastructure proxy BlackBerry Dynamics. Vérifiez l'état de la connexion de l'application mobile à l'infrastructure proxy avant d'essayer d'ouvrir le socket ou d'envoyer la requête HTTP.

Les modifications à apporter à la classe GDSocket sont répertoriées ci-dessous :

Natif

import CoreFoundation


...


class SocketHelper: StreamDelegate {

    func connectToServer() {
        var readStream: Unmanaged<CFReadStream>?
        var writeStream: Unmanaged<CFWriteStream>?

        var inputStream : InputStream
        var outputStream : OutputStream

        let port = UInt32(80)
        let host = "developer.blackberry.com" as CFString
                    CFStreamCreatePairWithSocketToHost(nil, host, port, &readStream, &writeStream)

        inputStream = readStream!.takeRetainedValue()
        outputStream = writeStream!.takeRetainedValue()

        inputStream.delegate = self
        outputStream.delegate = self

        inputStream.schedule(in: RunLoop.current, forMode: RunLoop.Mode.default)
        outputStream.schedule(in: RunLoop.current, forMode: RunLoop.Mode.default)

        inputStream.open()
        outputStream.open()

    }

    func stream(_ aStream: Stream, handle eventCode: Stream.Event) {
        ....
    }

}

Dynamique

import BlackBerryDynamics.SecureCommunication

...

class GDSocketHelper: GDSocketDelegate {

    func connectToServer() {
        let port = Int32(80)
        let host = NSString(string: "developer.blackberry.com")
        let gdSocket = GDSocket(host.utf8String!, onPort: port, andUseSSL: false)

        gdSocket.delegate = self
        gdSocket.connect()
    }

    func onOpen(_ socket: Any) {
        let gdSocket = socket as! GDSocket;
        let httpString = NSString(string:
                "GET http://developer.blackberry.com/ HTTP/1.1\r\n" +
                "Host:developer.blackberry.com:80\r\n" +
                "Connexion : fermée\r\n" +
                "\r\n")

        gdSocket.writeStream?.write(httpString.utf8String!)
        gdSocket.write()
    }

    func onRead(_ socket: Any) {
        let gdSocket = socket as! GDSocket;
        let str = gdSocket.readStream?.unreadDataAsString()
        DispatchQueue.main.async {
            print(String(describing: str))
        }
        gdSocket.disconnect()
    }

    func onClose(_ socket: Any) {
        let gdSocket = socket as! GDSocket;
            // do something if necessary
    }
}

Opérations sécurisées de copier-coller et de remplissage automatique

Copier-coller

Le moteur d'exécution BlackBerry Dynamics peut sécuriser ou bloquer le texte en transit vers ou depuis le presse-papiers, en fonction des règles de prévention des fuites de données (DLP) configurées dans BlackBerry UEM. Le moteur d'exécution sécurise le texte en le chiffrant lorsqu'il est coupé ou copié dans le presse-papiers de l'appareil, puis en le déchiffrant lorsqu'il est collé à partir du presse-papiers. Sous iOS, ces opérations sont gérées automatiquement par le moteur d'exécution BlackBerry Dynamics.  Aucune modification du code n’est nécessaire pour prendre en charge cette fonctionnalité sur iOS.

Désactiver la saisie automatique

Pour désactiver la fonction de remplissage automatique des mots de passe, faites en sorte que le champ TextField soit une implémentation de BBDAutoFillBlockerField. Le classe BBDAutoFillBlockerField est open source et son fonctionnement est illustré dans l’exemple AutoFillBlockingSample.