Assistant de configuration
La plateforme Navixy propose un assistant de configuration que les utilisateurs peuvent utiliser pour configurer la plateforme initialement ou modifier certains paramètres courants. Bien que tous les paramètres décrits ci-dessous puissent être appliqués directement à la base de données et aux configurations des services, cela peut être risqué si ce n'est pas fait avec précaution. Pour éviter tout risque potentiel, il est fortement recommandé d'utiliser le configurateur.
Lancement de l'assistant de configuration
Pour exécuter l'assistant, allez dans le répertoire /navixy-package et exécutez ./configure.sh
Vous serez accueilli par le menu principal :
Vous trouverez ci-dessous l'explication de chaque menu et sous-menu :
1. Paramètres de nom de domaine et SSL
1.1. Noms de domaine
La seule option ici est de modifier les noms de domaine et le SSL.
L'assistant de configuration vous permet d'effectuer la configuration soit avec un nom de domaine unique pour l'ensemble de la plateforme, soit avec trois noms de domaine distincts - séparés pour l'API, pour le panneau d'administration et pour l'interface utilisateur.
Dans le cas d'un nom de domaine unique, vous devez uniquement spécifier le domaine de votre service à la première étape, laisser les deux autres domaines vides. Dans ce cas, l'API et le panneau d'administration seront configurés en tant que sous-répertoires (cela est fait automatiquement). Exemples :
Si vous effectuez une configuration à trois noms de domaine , vous devez spécifier successivement :
Domaine du service (utilisé pour l'interface utilisateur et l'activation des appareils). Par ex. : my.domain.com
Domaine de l'API (utilisé pour toutes les opérations API). Par ex. : api.domain.com
Domaine du panneau d'administration (utilisé pour accéder au panneau Admin). Par ex. : panel.domain.com
Une fois tous les domaines spécifiés, l'assistant vous montrera les résultats de votre configuration. Si vous avez besoin de modifications, exécutez l'assistant à nouveau
Vous pouvez en apprendre davantage sur les noms de domaine à cette page : Domaines
1.2. Certificats SSL
Après la configuration des noms de domaine, vous verrez un menu d'installation du certificat SSL.
Si vous sélectionnez Oui, votre plateforme sera configurée pour utiliser HTTPS.
Ensuite, le script vous demandera si vous allez utiliser les certificats SSL gratuits Let's Encrypt, ou si vous souhaitez utiliser vos propres certificats.
Certificat gratuit Let's Encrypt
Sélectionnez Oui pour installer les certificats SSL gratuits Let's Encrypt pour vos domaines. Cela configurera également le renouvellement automatique des certificats afin que vous n'ayez pas à les renouveler manuellement.
Le script installera les logiciels nécessaires pour émettre le certificat (cela peut prendre un certain temps).
Il vous sera demandé de spécifier votre adresse e-mail. Ce n'est pas nécessaire mais recommandé.
Le script reconnaîtra automatiquement les noms de domaine (en les prenant depuis les configurations), générera et installera les certificats. Après cela, le script se terminera.
Vous avez maintenant configuré les noms de domaine, et votre site est protégé par SSL.
Votre propre certificat SSL
La sélection de l' Non option en réponse à la question sur les certificats SSL Let's Encrypt vous mènera au menu d'installation de vos propres certificats SSL. Pour poursuivre, vous devez disposer d'un certificat full-chain valide ainsi que de sa clé privée. Placez-les quelque part sur votre serveur. L'emplacement standard est /etc/nginx/ssl.
Tout d'abord, vous devez spécifier le chemin vers le fichier du certificat :
Ensuite, spécifiez le chemin vers le fichier de la clé privée de votre certificat SSL :
Les chemins vers vos certificats seront insérés dans la configuration Nginx.
Les certificats sont désormais installés et vos domaines sont protégés par SSL.
2. Paramètres SMS
Ici vous pouvez appliquer les paramètres de votre passerelle SMS, et aussi spécifier les identifiants de l'expéditeur de SMS du service.
2.1. Configurer la passerelle SMS
La première option de ce menu vous permet de désactiver la passerelle SMS si vous en avez déjà une configurée et n'avez plus besoin de l'utiliser.
Les autres options vous permettent d'appliquer les paramètres pour un fournisseur de service de passerelle SMS spécifique.
La dernière option vous permet de connecter la passerelle SMS via le protocole SMPP. Cette option convient également si votre fournisseur de passerelle n'est pas dans la liste, mais qu'il prend en charge SMPP de son côté.
Vous pouvez en apprendre davantage sur les passerelles SMS sur la page Passerelles de messagerie.
Configurer le 'nom d'expéditeur' et le 'numéro de téléphone de l'expéditeur'
Dans ce menu, vous pouvez spécifier le numéro et le nom de l'expéditeur des messages SMS de service, si nécessaire.
3. Paramètres de la passerelle e-mail
Ici vous ne pouvez configurer que les paramètres de l'e-mail de retour. Veuillez noter : Les principaux paramètres de la passerelle e-mail sont configurés depuis le panneau d'administration (Passerelles de messagerie).
Le script vous demandera de spécifier l'adresse e-mail pour recevoir les retours des utilisateurs depuis la section d'aide (adresse e-mail DESTINATAIRE).
Ensuite, il vous sera demandé la substitution de l'e-mail utilisateur.
Sélectionnez OUI pour utiliser l'adresse e-mail de l'utilisateur pour envoyer les demandes de retour.
Sélectionnez NON pour remplacer l'adresse e-mail de l'expéditeur par une adresse spécifique. Dans ce cas, le script vous demandera de spécifier cette adresse e-mail (adresse e-mail EXPÉDITEUR).
4. Paramètres de l'API Google Maps
Ici vous pouvez spécifier la clé API Google Maps si vous n'avez pas acheté le package GIS Premium de Navixy, mais avez préféré utiliser la clé que vous avez achetée vous-même (GIS)
Tout d'abord, vous devez spécifier la clé JavaScript Google API (requise pour la disponibilité des cartes).
Ensuite, appliquez la clé serveur Google API (requise pour les opérations de géocodage).
5. Clé de licence Navixy
Cette section contient deux options.
5.1. Changer la clé de licence
Ici vous pouvez spécifier la clé de licence pour votre instance On-premise. La clé de licence est appliquée lors de l'installation initiale de la plateforme, ou si elle est perdue ou corrompue pour une raison quelconque (généralement conséquence d'une altération de la base de données). La clé de licence est délivrée et fournie par le support technique.
Après la sélection de cette option, vous verrez un avertissement indiquant que changer la clé de licence sans précaution peut rendre la plateforme inutilisable.
Après cela, vous devez appliquer la clé de licence que vous avez reçue. Il s'agit d'une combinaison de caractères assez longue, il peut donc être assez difficile de la saisir manuellement. Vous pouvez coller la clé depuis le presse-papiers en utilisant la combinaison Shift+Insert . En alternative, vous pouvez maintenir Shift et utiliser clic droit de la souris.
La clé sera insérée dans la base de données et votre instance disposera d'une licence valide.
5.2. Demander une clé d'essai
Cette option ne peut être utilisée que pour obtenir une clé d'essai unique. La clé est valide pendant 30 jours. N'utilisez pas cette option si vous avez déjà une clé valide.
Vous ne pouvez pas réémettre ou renouveler la clé d'essai de cette manière.
Vous ne pouvez pas restaurer une clé perdue de cette manière.
Vous ne pouvez pas restaurer une licence désactivée de cette manière.
Après l'expiration de votre période d'essai et si vous souhaitez continuer à utiliser votre instance On-premise, veuillez contacter notre équipe Customer Success pour obtenir la clé de licence commerciale.
6. Paramètres des plugins
Les plugins permettent de modifier ou d'activer diverses fonctions de la plateforme. Étant donné que le configurateur est conçu pour la configuration de base de la plateforme, vous ne trouverez que trois plugins dans ce menu.
6.1. Paramètres du code d'activation
Ici vous pouvez activer ou désactiver l'utilisation de codes d'activation obligatoires pour l'enregistrement des appareils. Si l'option « Obligatoire » est activée, les utilisateurs ne pourront pas enregistrer un appareil sans code d'activation.
6.2. Paramètres du logo personnalisé
Ici vous pouvez configurer un logo spécial pour un utilisateur individuel.
Veuillez noter: le logo pour l'ensemble de la plateforme est personnalisé dans le panneau d'administration.
L'assistant de configuration vous demandera de spécifier l'ID utilisateur (il peut être trouvé dans le panneau d'administration ou dans l'interface utilisateur)
Ensuite, vous devez spécifier un lien vers le logo de l'utilisateur. Il peut être situé sur une ressource externe ou localement sur le serveur dans un répertoire du site web. Le logo doit être au format PNG, la taille recommandée est 400x400.
Le logo sera appliqué à l'interface de l'utilisateur et aux rapports.
6.3. Paramètres de la section d'aide
Ici vous pouvez choisir de masquer ou d'afficher la section d'aide dans l'interface utilisateur (elle est affichée par défaut). La section d'aide mène au site Web de Navixy, donc sa désactivation peut être utile pour le white labeling.
7. Paramètres de stockage des fichiers
Cette section vous permet d'activer et de désactiver le stockage des fichiers.
Il est utilisé pour stocker les fichiers et les pièces jointes d'images aux formulaires de tâches et aux travaux de maintenance. Le répertoire par défaut pour stocker les fichiers est /home/java/api-server/files.
Mis à jour
Ce contenu vous a-t-il été utile ?