Passer au contenu principal
Contexte du héros

DÉVELOPPEURS BLACKBERRY

Premiers pas avec le SDK d'BlackBerry Workspaces

BlackBerry Workspaces Le SDK permet aux utilisateurs de stocker, de partager et de synchroniser des documents en toute sécurité sur l'ensemble des plateformes et appareils de l'entreprise.

En savoir plus

Grâce à Workspaces, les utilisateurs peuvent partager des fichiers en toute sécurité avec d'autres personnes. Les propriétaires de fichiers conservent un contrôle total sur chaque fichier qu'ils partagent, y compris les autorisations de consultation, d'impression, de copie et de téléchargement. Par exemple, ils peuvent modifier les autorisations d'accès, définir une date d'expiration ou révoquer l'accès à un fichier à tout moment, même après que celui-ci a été partagé avec des appareils échappant au contrôle de votre organisation.

Les développeurs peuvent créer des applications intégrant l'accès aux Workspaces à l'aide de l'API REST « BlackBerry Workspaces », qui comprend deux services principaux :

  • Espaces de travail : les fichiers peuvent être téléchargés dans les espaces de travail afin d'être partagés en toute sécurité avec d'autres personnes

  • Envoyer : méthode permettant de partager des fichiers en toute sécurité avec d'autres personnes

Pour accélérer le développement, un SDK Java est également fourni.


Qu'est-ce que « BlackBerry Workspaces » ?

Serveur Access Workspaces

Pour utiliser l'API REST BlackBerry ou le SDK Java, vous devez disposer d'un accès à un serveur Workspaces sur site ou dans le cloud.

Les clients ayant acheté Workspaces sont autorisés à déployer des serveurs de développement et de test conformément aux conditions de leur contrat de licence. Les clients du cloud sont autorisés à effectuer des tests sur leur instance cloud de production. Contactez votre administrateur Workspaces pour obtenir l'accès à l'API Workspaces.

Si vous n'avez pas encore accès à BlackBerry Workspaces, deux options s'offrent à vous pour continuer :

  1. Achetez un compte cloud « BlackBerry Workspaces ».

    Il s'agit de la démarche recommandée pour bénéficier d'un accès complet aux espaces de travail et à l'assistance primée de BlackBerry. Moyennant un abonnement annuel modique, vous pouvez disposer d'un environnement dédié au développement et aux tests, déployé dans votre infrastructure locale ou hébergé dans le cloud BlackBerry.  

    Outre l'assistance téléphonique, les clients BlackBerry ont accès à un système de demande d'assistance en ligne ainsi qu'à toutes les ressources nécessaires pour déployer, gérer, assurer le support et favoriser l'adoption de Workspaces via le portail BlackBerry Admins.

  2. Commencez un essai gratuit pour bénéficier d'un environnement Workspaces dédié au développement et aux tests à court terme.

Développer

BlackBerry Workspaces fournit une API REST ainsi que des SDK Java et . BlackBerry Workspaces , permettant un développement plus rapide dans les environnements Java.

Utilisation de l'API REST

  • Guide du développeur -- Consultez le guide du développeur de l'API REST pour obtenir une vue d'ensemble, découvrir comment authentifier les requêtes et trouver des exemples d'utilisation des différentes fonctionnalités du serveur Workspaces. 

  • Référence de l'API -- La référence API décrit les interfaces, les classes, les méthodes et les types de données de l'API REST d'BlackBerry Workspaces . 

  • Exemples -- Consultez des exemples de code utilisant des espaces de travail, des utilisateurs et des fichiers.  

Utilisation du SDK Java

  • Bibliothèque Java — Téléchargez et installez les bibliothèques de code du SDK Java de Workspaces. Il existe un fichier JAR compact contenant uniquement les classes du SDK et un fichier JAR « shaded » contenant les classes du SDK ainsi que toutes leurs dépendances. 

  • Guide du développeur -- Consultez le guide du développeur Java pour obtenir une présentation générale du SDK, découvrir comment authentifier les requêtes auprès des API et trouver des exemples d'utilisation des différentes fonctionnalités du serveur Workspaces. 

  • Référence API -- La référence API décrit les interfaces, les classes, les méthodes et les énumérations du SDK Java d'BlackBerry Workspaces . 

  • Exemples -- Consultez des exemples de code utilisant des espaces de travail, des utilisateurs et des fichiers.  

Utilisation du SDK .NET

  • Bibliothèque SDK

  • Guide du développeur -- Consultez le guide du développeur .NET pour obtenir une présentation générale du SDK, découvrir comment authentifier les requêtes auprès des API et trouver des exemples d'utilisation des différentes fonctionnalités du serveur Workspaces. 

  • Référence API -- La référence API décrit les interfaces, les classes, les méthodes et les énumérations du SDK .NET d'BlackBerry Workspaces . 

  • Exemples -- Consultez des exemples de code utilisant des espaces de travail, des utilisateurs et des fichiers.  

Utilisation du SDK Android

  • Bibliothèque SDK

  • Guide du développeur -- Consultez le guide du développeur Android pour obtenir une présentation générale du SDK, découvrir comment authentifier les requêtes auprès des API et trouver des exemples d'utilisation des différentes fonctionnalités du serveur Workspaces. 

  • Référence API -- La référence API décrit les interfaces, les classes, les méthodes et les énumérations du SDK Android « BlackBerry Workspaces ».

  • Exemples -- Consultez des exemples de code utilisant des espaces de travail, des utilisateurs et des fichiers. 

Déploiement et tests

Déployer et tester une application sécurisée BlackBerry Dynamics. Déployez votre application BlackBerry Dynamics sur un smartphone, une tablette ou un émulateur à des fins de test. Vous devez disposer : d’une connexion Internet ; d’un smartphone, d’une tablette ou d’un émulateur pris en charge par BlackBerry Dynamics ; d’un serveur BlackBerry UEM ou du mode de simulation d’entreprise.

Mode de simulation d'entreprise

Pour exécuter et tester une application BlackBerry Dynamics, un serveur BlackBerry UEM est nécessaire, mais avec des limitations importantes, le mode de simulation d’entreprise permet de 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 lignes suivantes au fichierconfig.xmlracine, puis recompilez le projet :
 

<preference name=“GDEnterpriseSimulationMode” value=“true” />

Pour la désactiver, définissez la valeur sur «false» ou supprimez purement et simplement cette option.

 

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.

C'est réussi ! Continuer

Félicitations pour avoir développé votre première application Cordova sécurisée avec BlackBerry Dynamics !

Vous pouvez continuer à découvrir les plugins disponibles qui proposent différentes API et consulter les ressources destinées aux développeurs. Découvrez ci-dessous quelques-uns des plugins les plus courants.

Vous souhaiterez peut-être en savoir plus sur les plugins BlackBerry Dynamics Cordova et sur leur fonctionnement dans le cadre de votre projet. Si vous avez déjà développé des projets à l'aide de plugins Cordova, l'utilisation des plugins BlackBerry Dynamics vous semblera familière.

Certaines fonctionnalités seront automatiquement disponibles dans votre projet après l'ajout du plugin« cordova-plugin-bbd-base », telles que XMLHttpRequest, fetch, etc.

Pour consulter tous les détails concernant les API BlackBerry Dynamics pour Cordova, reportez-vous au  Référence des API du SDK BlackBerry Dynamics pour Cordova.

Le pack SDK comprend des exemples d'applications qui illustrent les bonnes pratiques à adopter lors de l'utilisation des plugins Cordova de BlackBerry Dynamics.

En règle générale, il est recommandé d'utiliser le plugin« cordova-plugin-bbd-all »pour permettre l'accès à toutes les API BlackBerry Dynamics. Si vous avez besoin d'un contrôle plus précis, vous pouvez également n'installer que le strict minimum de plugins nécessaires à votre application.

Système de fichiers

Le plugin « cordova-plugin-bbd-file »vous permet de gérer le système de fichiers (FileSystem) situé dans le conteneur sécurisé BlackBerry Dynamics à l'aide d'une API JavaScript similaire à celle du plugin « File » d'origine.

Le plugin « cordova-plugin-bbd-file-transfer» vous permet de télécharger et de transférer des fichiers en toute sécurité au sein du conteneur sécurisé BlackBerry Dynamics, à l'aide d'une API JavaScript similaire à celle du plugin FileTransfer d'origine.

Le plugin « cordova-plugin-bbd-media-capture» vous permet de capturer des fichiers audio, vidéo et des images à l'aide du microphone ou de l'appareil photo de l'appareil, puis de les stocker dans le conteneur sécurisé BlackBerry Dynamics grâce à une API JavaScript similaire à celle du plugin MediaCapture d'origine.

Le plugin « cordova-plugin-bbd-storage» est une interface qui permet d'utiliser un localStorage sécurisé.

Réseautage

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 BD Runtime prend en charge l'authentification Kerberos version 5.

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

Réseau par défaut

Ce plugin remplace les API par défautXMLHttpRequestetfetch() afin de récupérer automatiquement les objets nécessaires dès l'installation du plugincordova-plugin-bbd-base. Les appels effectués viaXHRoufetchseront automatiquement acheminés via le proxy BlackBerry Dynamics.
 

HttpRequest

Le plugin « cordova-plugin-bbd-httprequest »sert à envoyer des requêtes HTTP sur Internet. Il encapsule également la réponse HTTP renvoyée par la fonction « send » d'une instance HttpRequest.
 

WebSocket

Le plugin « cordova-plugin-bbd-websocket» implémente les API WebSocket sécurisées conformément à la spécification standard WebSocket (voir https://developer.mozilla.org/en-US/docs/Web/API/WebSocket).
 

InAppBrowser

Le plugin « cordova-plugin-bbd-inappbrowser» vous permet de charger en toute sécurité des articles utiles, des vidéos et des ressources Web au sein même de votre application, sans avoir à la quitter. Il s'agit d'un fork du plugin « cordova-plugin-inappbrowser ».
 

TokenHelper

Le plugin « cordova-plugin-bbd-tokenhelper» sert à demander un jeton au serveur et à traiter la fonction de rappel en fonction de la réponse.
 

Prise

Le plugin « cordova-plugin-bbd-socket» permet d'accéder à l'API de communication Secure Socket.

SQLite

Le plugin « cordova-plugin-bbd-sqlite-storage »vous permet de créer et de gérer en toute sécurité une base de données SQLite au sein du conteneur sécurisé BlackBerry Dynamics, à l'aide d'une API JavaScript SQLite similaire à celle du plugin d'origine.

CPI

Le plugin « cordova-plugin-bbd-appkinetics» offre les fonctionnalités d'AppKinetics, à savoir la possibilité d'établir une communication sécurisée entre les applications Dynamics.

Le plugin « cordova-plugin-bbd-interappcommunication» sert à renvoyer des informations concernant une ou plusieurs applications prestataires de services dans le cadre de services basés sur des applications.

Le plugin « cordova-plugin-bbd-mailto» offre des fonctionnalités permettant de rédiger en toute sécurité des e-mails avec des pièces jointes.

Lanceur

Le plugin « cordova-plugin-bbd-launcher» sert à afficher le BlackBerry Dynamics Launcher dans votre application.

Autres plugins

Le plugin « cordova-plugin-bbd-application» permet d'accéder à des informations disponibles globalement pour toute application BlackBerry Dynamics.

Le plugin « cordova-plugin-bbd-push» encapsule la réponse renvoyée par la classe GDPush.

Le plugin « cordova-plugin-bbd-specificpolicies» sert à lire les politiques spécifiques à l'application à partir de la console UEM et à les renvoyer au format JSON.

Le plugin « cordova-plugin-bbd-serversideservices» permet d'utiliser les services côté serveur BBD. Il renvoie toutes les informations nécessaires concernant le service au format JSON.

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

Le moteur d'exécution BlackBerry Dynamics peut sécuriser ou bloquer le texte transféré 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.

Ces opérations sont gérées automatiquement par BlackBerry Dynamics Runtime. Aucune modification du code n'est nécessaire pour prendre en charge cette fonctionnalité.