Dernière version disponible de l’application : 7.10.0
Introduction
Cet article couvre les étapes pour configurer une application mobile personnalisée sur la page Éditeur d’application mobile personnalisée de la plateforme. Les paramètres de cette page vous permettent de personnaliser l’apparence, les fonctionnalités et les capacités de vos applications personnalisées Android et iOS.
- Vous pouvez enregistrer les paramètres au fur et à mesure, et revenir les terminer plus tard.
- Lorsque vous êtes prêt, sur cette même page, vous pouvez ensuite générer les versions de vos applications mobiles personnalisées.
Vous pouvez créer plus d'une application personnalisée. Pour ceux qui utilisent Extended enterprise, Docebo recommande de créer une application personnalisée spécifique pour chaque sous-domaine.
Prérequis : App ID, Link stores et Firebase
Avant de commencer à configurer une application sur la page Éditeur d’application mobile personnalisée, vous devez avoir terminé les étapes suivantes :
-
Sélectionnez un ID pour votre application mobile personnalisée. Il est recommandé d'utiliser la notation
de domaine inversé (par exemple,
com.docebo.mobile). Cela correspondra au Nom paquet pour Android, et à l'ID du paquet pour iOS. Votre ID doit être unique et ne doit pas être déjà présent dans ces boutiques. De préférence, il devrait être identique pour les deux boutiques (bien que cela ne soit pas obligatoire)
Le nom paquet ne peut pas contenir les mots clés de la liste des mots clés Java (s'ouvre dans un nouvel onglet). - Sélectionnez le nom public de votre application mobile. Celui-ci sera le même pour les versions Android et iOS de l'application. Assurez-vous que le nom que vous choisissez n'existe pas déjà sur le Google Play store ou l'Apple App store.
-
Pour chaque boutique, dans la Google Play Console / App Store Connect suivez la procédure pour créer l'application (vous n'avez pas encore besoin de téléverser une version). Au cours de ce processus, vous devrez fournir l'ID choisi, et la création de l'application générera un Link store tel que le suivant :
https://play.google.com/store/apps/details?id=com.docebo.mobileou
https://apps.apple.com/us/app/go-learn/id1362542319Astuce : ignorez cette étape si vous ne prévoyez pas de distribuer votre application personnalisée via ces boutiques.
En créant d'abord les applications de cette manière, vous pouvez vous assurer que l'App ID choisi est unique.
À noter : si vous prévoyez de distribuer votre application personnalisée via la gestion des appareils mobiles (MDM) ou par une autre méthode en dehors du Google Play Store ou de l'Apple App Store, vous pouvez toujours créer le Nom paquet dans la Google Play Console et l' ID du paquet dans Apple Store Connect. Dans ce cas, vous n'avez pas besoin de créer la liste de l'application et vous n'avez pas besoin d'un Link store.
Astuce : notez votre App ID et les Link stores, vous devrez les insérer dans les configurations ultérieures.
De plus, si vous souhaitez que votre application mobile dispose des notifications push, de la connexion via Google ou de Google Analytics, vous devez d'abord terminer les étapes décrites dans l'article Configuring Firebase for branded mobile app.
Jetons
La création d'une nouvelle application mobile personnalisée nécessite un jeton, que vous pouvez acheter auprès de votre Account Manager. Les jetons que vous achetez restent associés à votre plateforme, et vous pouvez ensuite les utiliser pour créer vos applications personnalisées.
- Vous avez besoin d'un jeton pour chaque application personnalisée : un seul jeton couvre à la fois les versions iOS et Android de l'application.
- Le jeton n'est requis que lorsque vous créez une nouvelle application personnalisée. Vous n'avez pas besoin d'un jeton pour mettre à jour votre application.
- Lorsque vous appuyez sur le bouton + pour créer une nouvelle application mobile la boîte de dialogue Nouvelle application mobile personnalisée vous informera du nombre de jetons dont vous disposez.
- Vous pouvez supprimer les applications indésirables pour libérer leurs jetons
Si vous publiez plusieurs applications, par exemple pour vos sous-domaines Extended enterprise, vous aurez besoin d'un jeton par application.
La page de l'éditeur d'application mobile personnalisée
Pour accéder à la page de l'éditeur d'application personnalisée, naviguez vers le Menu de navigation / Personnalisation (icône des formes) / Éditeur d’application mobile personnalisée.
Vous y verrez toutes vos applications mobiles existantes listées. Pour chaque application, vous pouvez afficher les dernières versions iOS et Android générées et vérifier rapidement si elles sont à jour avec la version disponible la plus récente.
Ici, vous pouvez cliquer sur l'une des applications existantes pour la modifier ou continuer sa configuration (voir Modifier ou supprimer une application personnalisée), ou cliquer sur le bouton + Créer une application pour commencer à en créer une nouvelle.
Créer une nouvelle application personnalisée
Pour configurer une nouvelle application mobile personnalisée :
- Sélectionnez le Menu de navigation / Personnalisation (icône des formes) / Éditeur d’application mobile personnalisée.
-
Ensuite, dans le coin supérieur droit de la page, cliquez sur le bouton + Créer une application. Dans la boîte de dialogue, vérifiez que vous disposez du jeton nécessaire, puis cliquez sur Créer une application.
-
Dans le panneau Créer une application personnalisée qui s'ouvre, saisissez les
informations suivantes :
-
URL de la plateforme : il s'agit de l'adresse Web complète de
la
plateforme de formation à laquelle votre application se connecte. Il peut s'agir d'une
URL
docebosaasou d'un domaine personnalisé, s'il est configuré. Pour Extended enterprise, sélectionnez l'URL du client souhaité, ou son domaine secondaire le cas échéant. - Nom de l'application : le nom public que vous avez sélectionné pour votre application. C'est le nom que vos apprenants verront, et il sera identique pour les versions Android et iOS de l'application. Assurez-vous qu'il s'agit d'un nom unique qui n'existe pas déjà sur le Google Play Store ou l'Apple App Store.
- Systèmes d’exploitation : définissez si vous souhaitez créer une application iOS ou Android, ou les deux.
-
URL de la plateforme : il s'agit de l'adresse Web complète de
la
plateforme de formation à laquelle votre application se connecte. Il peut s'agir d'une
URL
- Lorsque vous êtes prêt, cliquez sur Créer une application.
Une page s'affichera où vous pourrez configurer tous les paramètres de votre application personnalisée nouvellement créée. Cette page est divisée en trois domaines principaux : Image de marque, Paramètres, et Sécurité.
Vous pouvez maintenant commencer la configuration de votre application. Référez-vous aux chapitres sur les Détails de l’appli, l'Image de marque, les Paramètres de l'application iOS, les Paramètres de l'application Android, les Services Firebase, la Sécurité. Vous pouvez enregistrer votre progression à tout moment en cliquant sur Enregistrer les modifications. Puis, lorsque vous êtes prêt à reprendre, vous pouvez sélectionner l'application depuis la page Éditeur d’application mobile personnalisée pour continuer ou modifier sa configuration.
Générer et téléverser les builds vers les app stores
Lorsque vous avez configuré tous les paramètres de votre application mobile personnalisée, cliquez sur Enregistrer les modifications pour sauvegarder les configurations de votre application. Vous êtes alors prêt à générer les versions.
- Si vous avez configuré à la fois une version iOS et Android de votre application, vous pourrez sélectionner s'il faut générer une version pour une seule d'entre elles, ou pour les deux.
- Si vous avez configuré les Mises à jour directes pour votre application iOS ou Android, vous pourrez générer et téléverser sa version en une seule étape.
Pour plus d'informations, consultez l'article Configuring direct updates for the branded mobile app.
Générer les versions
Dans le coin supérieur droit de la page de configuration de votre application personnalisée, cliquez sur le bouton Générer versions.
Ensuite, dans la fenêtre qui s'ouvre, sélectionnez pour quelles versions de l'application vous souhaitez générer les builds : iOS, Android, ou les deux.
Astuce : si vous n'avez configuré qu'une seule version de l'application, on ne vous proposera que cette option (iOS uniquement ou Android uniquement).
Le message vous indiquera également, pour chaque version que vous générez, si elle verra sa signature renouvelée automatiquement et sera soumise à la boutique (Mises à jour directes configurées) ou si sa signature devra être renouvelée manuellement et soumise à la boutique (Mises à jour directes non configurées).
Lorsque vous êtes prêt, cliquez sur le bouton Générer versions ou Générer et téléverser les builds pour démarrer le processus.
Cela démarrera la génération du ou des paquets d'application (selon que vous avez sélectionné de générer une version uniquement pour Android, uniquement pour iOS, ou pour les deux). Le processus de génération du paquet peut prendre quelques heures pour se terminer (jusqu'à 8 heures).
À noter : la génération de la version peut échouer lorsqu'elle est lancée lors du processus de parution hebdomadaire ou mensuelle de Docebo. Si cela se produit, veuillez réessayer de la générer une fois le processus de parution terminé.
Vous pouvez vérifier l'avancement dans la bannière en haut de la page de configuration de votre application personnalisée :
-
Lorsque vous cliquez sur le bouton Générer versions/Générer et téléverser les builds,
celui-ci passera à Preparing your builds... Version demandée.
-
Lorsque le processus est terminé, le résultat s'affichera (version générée
ou version générée et envoyée à la boutique) pour chaque version de l'application que
vous
avez choisie de générer. Vous recevrez également une notification par e-mail.
-
Si une version a été générée et envoyée à la boutique, l'ensemble du processus a réussi, et l'application a vu sa signature renouvelée et a été soumise à la boutique. Il n'y a aucune autre action requise.
Astuce : vous pouvez toujours utiliser le bouton Télécharger la version pour télécharger une copie locale de la version, si nécessaire. Notez cependant que la signature de la version téléchargée n'est pas renouvelée.
- Si une version a uniquement été générée, vous devez encore télécharger le paquet, puis en renouveler la signature manuellement et le soumettre à l'app store.
Renouveler la signature manuellement et téléverser votre paquet vers l'app store :
Répétez les étapes suivantes pour chaque version de votre application (iOS et Android) qui n'est pas automatiquement soumise.
Une fois la version disponible, dans la bannière de résultat en haut de la page de configuration de l'application, cliquez sur le lien Télécharger la version pour télécharger le paquet.
Astuce : vous pouvez également cliquer sur le bouton Gérer les builds pour afficher un historique de vos versions générées précédemment et télécharger la dernière en date.
Vous devez maintenant en renouveler la signature pour remplacer la signature numérique appliquée temporairement par Docebo lors du processus de création de l'application par la vôtre, puis téléverser le paquet re-signé sur les app stores. Suivez les instructions de l'article Re-signing and publishing the branded mobile app.
À noter : si vous ne téléchargez pas le paquet avant la date d'expiration, vous ne pourrez pas télécharger le paquet, mais vous devrez générer une nouvelle version.
Messages d'erreur de version
Si une erreur se produit lors du processus de génération ou de téléversement de la version, la bannière de résultat affichera un message indiquant à quelle étape l'erreur s'est produite. Ces mêmes informations sont également fournies dans l'e-mail que vous recevez.
- Erreur lors de la génération de la version. La version n'a pas pu être générée du tout. Vérifiez les paramètres de votre éditeur d'application personnalisée, ou contactez le Support client. Dans ce cas, il n'y a aucune version disponible au téléchargement.
- Erreur lors du renouvellement de la signature du build : la version a été correctement générée, mais une erreur s'est produite lors du renouvellement de signature automatique. Vous pouvez toujours télécharger le paquet non signé et essayer d'en renouveler la signature manuellement et de le téléverser.
-
Erreur lors du téléversement du build sur la boutique : la génération de la version et le renouvellement de signature automatique ont tous deux réussi, mais le téléversement vers la boutique a échoué. Vous pouvez vérifier les paramètres des Mises à jour directes et réessayer. Alternativement, vous pouvez télécharger la version et en renouveler la signature manuellement et la téléverser.
À noter : la version que vous téléchargez n'est jamais signée et nécessite que sa signature soit renouvelée, même si la signature automatique a réussi.
Modifier ou supprimer une application personnalisée
La page Éditeur d’application mobile personnalisée répertorie toutes les applications personnalisées qui ont été créées jusqu'à présent. Si vous souhaitez modifier ou supprimer une application, sélectionnez l'icône des points de suspension à la fin de la ligne de l'application, puis sélectionnez le choix correspondant dans le menu déroulant.
Chaque fois que vous modifiez l'application, vous devez demander une nouvelle version. Une fois le processus de version terminé, vous recevrez une notification par e-mail.
Pour modifier une application personnalisée
- Cliquez sur l'icône des points de suspension sur la ligne de l'application et sélectionnez Modifier.
- Apportez les modifications requises dans les Détails de l’appli, l'Image de marque, les Paramètres de l'application iOS, les Paramètres de l'application Android, les Services Firebase, et la Sécurité.
-
Lorsque vous êtes prêt, cliquez sur Enregistrer les modifications.
À noter : après avoir mis à jour les paramètres de votre application, rappelez-vous que, pour que vos modifications prennent effet, vous devrez générer une nouvelle version et la soumettre aux boutiques.
Pour supprimer une application personnalisée
- Cliquez sur l'icône des points de suspension sur la ligne de l'application et sélectionnez Supprimer.
- Dans la boîte de dialogue, cliquez de nouveau sur Supprimer pour confirmer, ce qui supprime l'application de la page Éditeur d’application mobile personnalisée. Notez que cette suppression ne supprime pas l'application des boutiques où elle a été publiée. Vous devrez également dépublier séparément l'application des app stores.
À noter : si vous supprimez une application et que vous en avez à nouveau besoin plus tard, vous devrez reconfigurer tous ses paramètres dans la page de l'éditeur d'application personnalisée.
Mettre à jour l'application personnalisée
Même si vous ne modifiez pas les paramètres de votre application mobile personnalisée, vous devrez périodiquement générer et distribuer une nouvelle version pour intégrer les dernières mises à jour, basées sur la nouvelle version du code source. Les versions de l'éditeur d'application mobile personnalisée sont toujours générées à l'aide de la version disponible la plus récente du code source.
Vérifier les mises à jour
Lorsqu'une nouvelle version de Go.Learn et de l'application mobile personnalisée est publiée, cela est annoncé sur la page des Product updates.
Vous pouvez également vérifier les mises à jour directement sur la page de l'éditeur d'application personnalisée :
- Dans la colonne Dernière version, vous pouvez vérifier la dernière version publiée de Go.Learn et de l'application mobile personnalisée.
- Les colonnes Version iOS et Version Android vous indiquent quant à elles la version de la dernière version que vous avez générée. Une icône d'alerte s'affiche également si vous devez effectuer la mise à jour vers la dernière version.
Mettre à jour votre application
Lorsque vous voyez qu'une nouvelle version de l'application est disponible, pour transmettre cette mise à jour à vos utilisateurs, vous devez générer de nouvelles versions de vos applications iOS et Android et les téléverser vers les boutiques. Pour ce faire :
- Effectuez les étapes décrites dans le chapitre Générer et téléverser les builds vers les app stores
À noter :
- Vous n'êtes pas obligé de mettre à jour votre application personnalisée, cependant la mise à jour est fortement recommandée pour vous assurer de disposer de la version la plus fiable et la plus complète de l'application avec toutes les fonctionnalités incluses dans la version pour Go.Learn.
- Notez également que Docebo propose uniquement une assistance technique pour la dernière version de l'application mobile.
Passer en revue les détails de l'appli
Après avoir créé une application, vous pouvez vérifier si nécessaire le nom de l'application et l'URL de la plateforme que vous avez saisis lors de la création de l'application. Vous devrez également saisir une adresse e-mail pour recevoir les notifications de version :
Pour ce faire, sur la page de l'éditeur d'application personnalisée de votre application, sélectionnez Paramètres / Détails.
À noter : la modification du nom de l'application crée une application distincte. Une fois la liste de votre boutique créée et la configuration de l'application personnalisée terminée, la modification du nom de l'application nécessitera la création d'une liste de boutique entièrement nouvelle, et la reconfiguration de l'application depuis le début.
Personnaliser l'image de marque de votre application
Dans le domaine Image de marque de la page de l'éditeur d'application personnalisée, vous pouvez personnaliser l'apparence de votre application personnalisée.
Pour y accéder, sélectionnez le Menu de navigation / Personnalisation (icône des formes) / Éditeur d’application mobile personnalisée / [nom de l'application].
Ici, vous pouvez configurer l'Icône de l'application, le Splash screen, le Menu à tiroirs, et la Page de préconnexion.
Dimensions d'image pour l'icône de l'application et l'icône du splash screen :
Les dimensions d'image pour à la fois l'icône du launcher et l'icône du splash screen doivent être de 1024×1024 px à 72 DPI.
Le format de fichier requis est PNG 32 bit :
- avec canal alpha pour Android
- sans canal alpha pour iOS
La taille de fichier maximale est de 4 Mo.
Vous devez également centrer votre icône dans le carré de 1024 px comme indiqué dans les sections suivantes.
Icône de l'application
L'icône de l'application est l'icône affichée sur l'écran de l'appareil, sur laquelle les utilisateurs doivent appuyer pour démarrer l'application.
Une icône ronde est généralement utilisée sur Android, tandis qu'une icône carrée avec des bordures arrondies est utilisée sur iOS. Pour éviter le recadrage, centrez votre icône dans un cercle de 1024 px de diamètre comme illustré ci-dessous.
Splash screen
Le splash screen est l'image affichée après que l'utilisateur a appuyé sur l'icône de l'application, pendant le chargement de l'application. Celle-ci présentera généralement votre image de marque ou votre logo. Pour éviter le recadrage, notez que le logo doit être placé dans un cercle centré de 832 px de diamètre comme indiqué ci-dessous.
Page de préconnexion
Uniquement dans le cas de l'application mobile en domaine ouvert, vous verrez une section d'image d'Image de fond pré-connexion. Vous pouvez y téléverser l'arrière-plan de l'écran de bienvenue où l'utilisateur insère l'URL de la plateforme.
Les dimensions de l'image de fond pré-connexion doivent être de 720×1280 px (orientation portrait pour s'adapter aux téléphones mobiles) à 72 DPI, et le format de fichier requis est PNG 32 bit avec canal alpha. La taille de fichier maximale est de 4 Mo.
Paramètres de l'application iOS
Dans le domaine Paramètres / Application mobile iOS de la page de l'éditeur d'application personnalisée, vous pouvez activer et configurer la version iOS de votre application personnalisée.
Pour démarrer, si vous n'aviez pas déjà activé iOS lors de la création de l'application, vous pouvez le faire maintenant : cochez la case Activer l’application mobile iOS.
Les paramètres que vous configurez ici sont ceux spécifiques à l'application iOS :
iOS / Mode app de lecture
Le Mode app de lecture est requis par les consignes d'Apple pour permettre aux utilisateurs d'accéder au contenu acheté en dehors de l'application.
- Cela rendra votre application conforme aux consignes d'Apple sur l'e-commerce (contenu payant) (s'ouvre dans un nouvel onglet), et évitera qu'elle soit refusée par l'Apple App Store.
Activer le Mode app de lecture garantit que vos utilisateurs peuvent utiliser l'application mobile pour accéder au contenu acheté précédemment, tel que des cours payants achetés sur la version desktop de la plateforme.
Veuillez noter qu'avec le Mode app de lecture activé, les comptes utilisateurs ne peuvent pas être créés dans l'application mobile. Par conséquent, si vous autorisez l'auto-inscription sur votre plateforme, les utilisateurs devront s'inscrire à partir de la plateforme desktop.
iOS / Link store
Insérez l'URL de la page de liste de votre application personnalisée dans l'Apple App Store.
Exemple :
https://apps.apple.com/us/app/go-learn/id1362542319
Si vous ne distribuez pas votre application via les boutiques, vous pouvez laisser le champ vide.
iOS / Universal link
Un universal link est une URL qui permet aux utilisateurs d'ouvrir l'application personnalisée sur un écran spécifique, plutôt que dans le navigateur.
Pour activer cette fonctionnalité, cochez la case Activer universal link. Ensuite, vous devrez insérer votre App ID.
Récupérer l'App ID
Vous pouvez récupérer l'App ID dans l' Apple Developer's Console (s'ouvre dans un nouvel onglet), dans la section Certificates, Identifiers & Profiles.
La valeur de la clé de l'App ID est l'ID d'équipe ou le préfixe de l'App ID suivi de l'ID du paquet. Les deux parties sont séparées par un point. Format : teamID.bundleID, exemple : ABCD1234.com.apple.wwdc.
Par exemple, avec la configuration d'App ID affichée dans cette capture d'écran, dans le champ App ID, vous devrez taper :
9YR6YH8KLL.com.mycompany.myapp.clientVérifier que le Domaine associé est activé
Sur la page Certificates, Identifiers & Profiles, faites défiler vers le bas jusqu'à ce que vous atteigniez l'onglet Capabilities, où vous devez vous assurer que la fonctionnalité Domaine associé est activée.
Découvrez plus d'informations sur les domaines associés (s'ouvre dans un nouvel onglet).
iOS / S'identifier en mode démo
La fonctionnalité de connexion en mode démo permet aux utilisateurs de prévisualiser l'application sans créer de compte et sans s'inscrire. Pour utiliser cette fonction, vous devez d'abord configurer un compte spécifique sur la plateforme, avec des droits limités de manière appropriée, que vous utiliserez comme compte de démonstration.
Pour l'activer, cochez la case Activer la connexion à iOS en mode démo et saisissez les identifiants du compte de démonstration dans les champs Nom d’utilisateur de démonstration et Mot de passe de démonstration.
iOS / Format package
Dans cette section, sélectionnez le format de la version de l'application iOS. IPA est recommandé pour la distribution et les tests.
iOS / Mises à jour directes
Dans ce domaine, vous pouvez facultativement configurer des paramètres pour envoyer automatiquement les mises à jour de l'application aux boutiques directement depuis la page Éditeur d’application mobile personnalisée, sans avoir à renouveler la signature manuellement et à téléverser chaque nouvelle version de votre application.
À noter : vous pouvez également ignorer cette configuration et l'ajouter à une date ultérieure.
Lorsque vous configurez les mises à jour directes, chaque fois que vous générez une version, elle verra sa signature renouvelée automatiquement et sera soumise à l'app store.
Pour des instructions, consultez l'article Configuring direct updates for the branded mobile app.
Paramètres de l'application Android
Dans le domaine Paramètres / Application mobile Android de la page de l'éditeur d'application personnalisée, vous pouvez activer et configurer la version Android de votre application personnalisée.
Pour démarrer, si vous n'aviez pas déjà activé Android lors de la création de l'application, vous pouvez le faire maintenant : cochez la case Activer l’application mobile Android.
Les paramètres que vous configurez ici sont ceux spécifiques à l'application Android :
Android / Link store
Insérez l'URL de la page de liste de votre application personnalisée dans le Google Play Store.
Exemple :
https://play.google.com/store/apps/details?id=com.docebo.mobile
Si vous ne distribuez pas votre application via les boutiques, vous pouvez laisser le champ vide.
Android / Nom paquet
Saisissez l'ID du paquet Android de votre application mobile personnalisée. Par exemple, com.docebo.mobile.
Android / App links
Un app link est une URL qui permet aux utilisateurs d'ouvrir l'application personnalisée sur un écran spécifique.
Pour activer cette fonctionnalité, cochez la case Activer app links. Ensuite, dans le champ Empreinte digitale du certificat SHA, vous devrez insérer l'empreinte digitale SHA256 du certificat signé.
Pour la récupérer, accédez à la Google Play Console (s'ouvre dans un nouvel onglet) et accédez à l'élément de menu App Integrity. Dans la section Digital Asset Links JSON de la page, copiez la valeur que vous trouvez sous sha256_cert_fingerprints.
Android / Format package
Sélectionnez AAB (Android App Bundle) si vous souhaitez publier votre application mobile personnalisée sur le Google Play Store.
Remarques importantes : depuis août 2021, Google Play (s'ouvre dans un nouvel onglet) exige que les nouvelles applications et les mises à jour d'applications existantes publiées sur le Google Play Store Android utilisent le format package Android App Bundle (AAB).
Vous pouvez toujours sélectionner l'option Android Package (APK) si vous prévoyez de publier votre application via un système de Mobile Device Management (MDM) plutôt que sur le Google Play Store public.
Android / Mises à jour directes
Dans ce domaine, vous pouvez facultativement configurer des paramètres pour envoyer automatiquement les mises à jour de l'application aux boutiques directement depuis la page Éditeur d’application mobile personnalisée, sans avoir à renouveler la signature manuellement et à téléverser chaque nouvelle version de votre application.
À noter : vous pouvez également ignorer cette configuration et l'ajouter à une date ultérieure.
Lorsque vous configurez les mises à jour directes, chaque fois que vous générez une version, elle verra sa signature renouvelée automatiquement et sera soumise à l'app store.
Pour des instructions, consultez l'article Configuring direct updates for the branded mobile app.
Services Firebase (notifications push, connexion via Google, Analytics)
Vous devrez configurer la section Services si vous souhaitez que votre application mobile personnalisée prenne en charge Firebase Messaging (Notifications ou messagerie in-app), la connexion via Google, ou Google Analytics.
- Les paramètres spécifiques que vous devez configurer dépendront des services que vous souhaitez utiliser.
- Si vous ne nécessitez pas ces fonctionnalités, vous pouvez laisser la case Activer les services Firebase décochée.
Avant de commencer : si vous ne l'avez pas déjà fait, terminez d'abord les étapes décrites dans Configuring Firebase for the branded mobile app.
Ensuite, sur la page de l'éditeur d'application personnalisée de votre application, sélectionnez Paramètres / Services et cochez la case Activer les services Firebase.
Pour tous les services Firebase, vous devez maintenant téléverser le Fichier de configuration des Google services obtenu de Firebase. Les fichiers à téléverser dépendent des versions de l'application que vous créez :
- Pour l'application iOS, téléversez le fichier GoogleService-Info.plist obtenu de Firebase.
- Pour l'application Android, téléversez le fichier google-services-json obtenu de Firebase.
Maintenant, sous Paramètres de Firebase, cochez les cases correspondantes aux services que vous souhaitez activer sur votre application. Vous devez sélectionner au moins un service.
Si vous ne souhaitez aucun de ces services, désélectionnez la case Activer les services Firebase.
Activer les notifications push
Si vous souhaitez utiliser les notifications push ou Google Analytics sur votre application, cochez cette case. Ensuite, saisissez l'ID de projet Firebase et téléversez le fichier de clé de compte de service Firebase.
Pour plus d'informations sur l'obtention de ces éléments, veuillez consulter l'article Configuring Firebase for branded mobile app / Get Firebase project ID and Service account key file.
Activer la connexion via Google
Cochez cette case pour utiliser la connexion via Google sur votre application. Ensuite, saisissez l' ID client Web du projet de votre application dans Firebase, et si vous avez une application iOS saisissez également l'ID client iOS.
Pour plus d'informations sur l'obtention de ces éléments, veuillez consulter l'article Configuring Firebase for branded mobile app / Enable Google sign-in.
Paramètres de sécurité
Enfin, dans le domaine Sécurité, vous pouvez configurer certains paramètres liés à la protection des données, à l'authentification et au suivi d'utilisation.
Sous Sécurité / Protection des données, vous pouvez configurer l'Ajout d’un certificat et l'Utilisation de l'app en Chine.
Sous Sécurité / Suivi, vous pouvez configurer le Mobile Measurement Partner (MMP) Adjust.
Ajout d’un certificat
L'ajout d'un certificat est une technique développée pour protéger les applications web et mobiles des autorités de certification malveillantes. Elle garantit qu'aucune donnée réseau n'est compromise même si un utilisateur est piégé et installe un certificat racine malveillant sur son appareil mobile. Cela aide à mieux protéger l'application contre le phishing et les attaques de l'homme du milieu.
Avec l'ajout d'un certificat, vous intégrez au sein de votre application l'empreinte digitale (résumé) du certificat dont vous savez qu'il est utilisé par vos services d'arrière-plan, et cela renforce le niveau de sécurité de votre application personnalisée car cela vous permet de découvrir immédiatement si vous êtes victime d'une cyberattaque.
Pour configurer cela, activez l'option Activer l’ajout d’un certificat. Ensuite, dans le champ Résumé, insérez le résumé de votre certificat HTTPS au format SHA-256 Pin.
- Pour récupérer votre résumé, vous pouvez demander l'assistance du Security Officer de votre entreprise.
- Alternativement, vous pouvez utiliser le service en ligne gratuit https://www.ssllabs.com/ssltest/ (s'ouvre dans un nouvel onglet), qui effectue une analyse de la configuration de tout serveur web SSL.
-
Veuillez noter que, si vous publiez un nouveau certificat numérique, vous
devrez
mettre à jour l'empreinte digitale dans le champ Résumé et générer une nouvelle version de votre
application.
À noter : si vous activez l'ajout d'un certificat, vous êtes responsable de la gestion du cycle de vie complet de votre certificat. Si votre certificat change et que vous ne mettez pas à jour le résumé ni ne générez de nouvelle version, l'application sera incapable de se connecter à votre plateforme et restera bloquée sur l'écran de chargement pour tous les utilisateurs. Docebo recommande de conserver une note de vos dates de renouvellement de certificat et de programmer les générations de version de l'application en conséquence. Pour la procédure recommandée afin de renouveler votre certificat sans entraîner de temps d'arrêt de l'application, consultez Renouveler votre certificat SSL sans temps d'arrêt de l'application.
Récupération du résumé à partir de SSL Labs
Suivez ces étapes sur le site Web de SSL Labs (veuillez noter que Docebo n'est pas responsable de l'exhaustivité des informations suivantes en cas de modifications apportées par SSL Labs au processus décrit) :
- Saisissez l'URL de votre plateforme Docebo dans le champ Hostname et cliquez sur Submit. Cela devrait être la même URL que vous avez définie dans le champ URL domaine sur la page Éditeur d’application mobile personnalisée.
- Attendez que l'analyse soit terminée, puis cliquez sur l'adresse IP récupérée dans la colonne Server. Si plus d'un résultat est affiché dans le tableau, veuillez sélectionner le premier.
- Une page affichant le rapport SSL s'ouvrira, où vous pourrez trouver le résumé de votre certificat dans la section Subject de la boîte de Certificate.
- Copiez la chaîne Pin SHA256 suivante, puis collez-la dans le champ Résumé de la section Ajout d’un certificat sur votre plateforme Docebo. Vérifiez bien de ne pas copier-coller d'espaces vides au début ou à la fin de la chaîne.
Renouveler votre certificat SSL sans temps d'arrêt de l'application
Si vous utilisez l'ajout d'un certificat et devez renouveler ou changer votre certificat SSL, suivez ces étapes pour éviter de rendre l'application inaccessible à vos utilisateurs.
Tout d'abord, obtenez le nouveau certificat de votre fournisseur de certificats et téléversez-le sur votre plateforme, mais ne supprimez pas encore le certificat existant (qui arrive à échéance) de l'attribution de votre domaine. Votre plateforme doit avoir à la fois l'ancien et le nouveau certificat attribués au domaine en même temps pendant la fenêtre de transition.
Ensuite, générez le résumé du nouveau certificat. Vous pouvez utiliser la commande suivante :
openssl x509 -in certificate.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | openssl enc -base64Alternativement, vous pouvez récupérer le résumé à partir de SSL Labs.
Une fois que vous avez le nouveau résumé, mettez à jour le champ Résumé dans la section Ajout d’un certificat de la configuration de votre application personnalisée, puis générez de nouvelles versions de vos applications iOS et Android et soumettez-les aux app stores.
Une fois les nouvelles versions examinées, publiées et mises à jour par vos utilisateurs vers la nouvelle version, vous pourrez supprimer l'ancien certificat de l'attribution de votre domaine en toute sécurité.
À noter : si vous supprimez l'ancien certificat du domaine avant que la nouvelle version de l'application ne soit en direct et que vos utilisateurs ne l'aient mise à jour, l'application restera bloquée sur l'écran de chargement pour ceux qui exécutent encore l'ancienne version. Docebo recommande d'accorder plusieurs jours entre la publication de la nouvelle version et la suppression de l'ancien certificat pour tenir compte des délais d'examen de l'app store et de l'adoption par l'utilisateur.
Utilisation de l'app en Chine
Si vous souhaitez activer l'optimisation pour l'utilisation de l'app en Chine, activez l'option Permettre l’utilisation de l’application en Chine. Cette fonctionnalité offre des performances optimisées à ceux qui utilisent l'application en Chine, y compris les utilisateurs entrant et sortant du pays et y séjournant pour de courtes périodes.
MMP Adjust
Si vous avez créé différentes campagnes promotionnelles pour votre application personnalisée sur divers réseaux publicitaires et réseaux sociaux, vous devrez mesurer et analyser le Retour sur Investissement (ROI) de chaque campagne. Les Mobile Measurement Partners (MMP) sont particulièrement utiles pour mesurer les performances et le taux de conversion de différents réseaux publicitaires et sont utilisés pour comparer les performances de chaque réseau afin de comprendre quel moyen donne les meilleurs résultats.
Un MMP collecte, organise et normalise les données de l'application mobile pour fournir une évaluation uniforme des indicateurs de performance de la campagne.
Le MMP Adjust (s'ouvre dans un nouvel onglet) peut être intégré avec la fonctionnalité d'Éditeur d’application mobile personnalisée de Docebo. Afin d'activer le support pour Adjust comme MMP pour votre application personnalisée, sélectionnez l'option Permettre l’intégration d’Adjust, puis collez le jeton de l'application que vous avez généré sur le tableau de bord d'Adjust.
À noter : lorsque vous publiez votre application personnalisée sur l'Apple App Store, il vous est posé des questions de confidentialité sur les types de données collectés dans votre application. Vous pouvez trouver ces détails dans la Base de connaissances Adjust (s'ouvre dans un nouvel onglet). Pour vous assurer de remplir le formulaire avec les bonnes réponses, consultez le PDF joint au chapitre Important Notes on the Publishing Process de l'article de la base de connaissances expliquant comment publier une application personnalisée.