Premiers pas avec le SDK BlackBerry Dynamics pour iOS
Téléchargez, installez et configurez le SDK BlackBerry Dynamics pour iOS.
Blog
·:quality(90):no_upscale())
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
:quality(90):no_upscale())
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
Si vous ne disposez pas d'un fichier Podfile, consultez https://cocoapods.org/ pour savoir comment en créer un
Dans votre fichier Podfile, ajoutez la référence suivante au pod « BlackBerry Dynamics SDK » :
pod « BlackBerryDynamics »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.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 Cocoapodssi Dir.glob("**/default.xcconfig").first()system("find Pods -name 'Pods-*.xcconfig' -exec sh -c 'cat 'find . -name default.xcconfig' »> $1' -- (} \ \;")finfinInstallez 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
Extract the contents of the BlackBerry_Dynamics_SDK_for_iOS_<version>_dylib.tar.gz file into a directory.
À partir du répertoire «Frameworks» du package SDK extrait, copiez tous les fichiers du framework dans le répertoire de votre choix.
Importez les frameworks dans le projet en les faisant glisser depuis le répertoire
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 :
Exécutez la commande «pod install» pour installer les dépendances du projet, y compris BlackBerry Dynamics.
Lancez Xcode et ouvrez le projet.
Remplacezl'identifiant du bundlepar le vôtre.
Modifiezl'identifiant d'URLetles schémas d'URLdans le fichier Info.plist.
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).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.
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.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>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 :
Implémentez le protocoleGDiOSDelegatepour recevoir des objetsGDAppEventprovenant du SDK BlackBerry Dynamics.
Utilisezla fonction GDAppEventfournie dans la méthode de gestionnaire de l'interfaceGDiOSDelegatepour traiter les événements d'autorisation.
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é.
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.
@UIApplicationMainclass 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.Runtimeclass 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
Connectez-vous à la console de gestion BlackBerry UEM .
Cliquez sur « Applications » > « Nouvelle application » > « Droits d'accès aux applications BlackBerry Dynamics internes » > « Suivant ».
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.
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 :
Cliquez sur l'application.
Dans l'onglet « iOS », saisissez la valeur appropriée
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 :
Connectez-vous à la console d'administration d'UEM .
Dans le menu de gauche, cliquez sur « Politiques et profils » > « Conformité ».
Ouvrez le profil de conformité attribué à l'utilisateur test.
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 :
Connectez-vous à la console d'administration d'UEM .
Recherchez et sélectionnez un compte utilisateur.
Dans la section « Applications » du profil utilisateur, cliquez sur +.
Recherchez et sélectionnez votre application.
Cliquez sur « Suivant ».
Laissez le paramètre « Disposition » sur « facultatif » (l'installation ne sera pas imposée) et cliquez sur « Attribuer ».
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:
Dans le profil de l'utilisateur, sous l'onglet « Résumé », cliquez sur «Définir le mot de passe d'activation ».
Dans la liste déroulante « Option d'activation », cliquez sur «Activation par défaut du périphérique ».
Dans la liste déroulante « Mot de passe d'activation », cliquez sur «Définir le mot de passe d'activation de l'appareil ».
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.
À 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)
Cliquez sur « Soumettre ».
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 ».Installez l'application sur la cible souhaitée en utilisant la méthode de déploiement de votre choix (y compris via Xcode).
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 :
Instancier la classe principale BBDAutomatedTestSupport
let ats = BBDAutomatedTestSupport.sharedInstance()Chargez les informations d'identification à l'aide de
ats.fetchCredentials()Définissez l'objet XCUIApplication à utiliser et configurez BBDAutomatedTestSupport pour qu'il l'utilise.
let application = XCUIApplication()ats.setupBBDAutomatedTestSupport(with: application, for: self)Lancez le processus d'autorisation à l'aide de
XCTAssertTrue(ats.loginOrProvisionBBDApp(), "Impossible d'autoriser l'application")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 URLSessionfunc 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 :
Ajoutez une nouvelle ligne au fichier Info.plist de l'application :
Clé : GDControlTLSVersions
Type : Chaîne (par défaut)
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.
:quality(90):no_upscale())