Marque blanche de l'agent

Ce que fait la marque blanche

La marque blanche change les noms que l'agent porte sur les machines de vos clients : son service, ses dossiers, son programme et son entrée dans Applications installées. Vos clients voient donc vos noms, pas ceux de BaaStide.

Ces noms forment le profil d'installation de votre MSP. Le portail garde un seul profil par MSP. Chaque enregistrement donne une nouvelle révision.

Le changement s'applique seulement aux nouvelles installations. Les agents déjà installés gardent leurs noms, même après une mise à jour.

Vous choisissez des noms, jamais des chemins. Les dossiers racines ne changent pas.

Prérequis

• Le rôle Administrateur pour changer le profil. Tous les autres rôles lisent la page, sans la changer. Voir Rôles et droits.
• Un nom court et un nom de service qu'aucun autre MSP n'utilise déjà.
• Pour un domaine : un accès à la zone DNS de ce domaine.

Ouvrir la page et lire l'état

1. Dans le menu Administration, cliquez sur Marque blanche de l'agent.

2. Lisez le badge en haut de la page :

   Badge	Ce qu'il veut dire
   Noms BaaStide	Vous n'avez pas encore enregistré de profil. L'agent porte les noms de BaaStide.
   Révision N	Votre profil est enregistré. N est sa révision.

Sans profil enregistré, le formulaire est vide : les noms de BaaStide sont réservés.

Remplir le profil

1. Remplissez le bloc Profil :

   Champ	Ce qu'il donne	Règles
   Nom du produit	Le nom dans Applications installées et le nom affiché du service.	1 à 64 caractères.
   Éditeur	L'éditeur dans Applications installées.	1 à 64 caractères.
   Nom court	Le nom du fichier du programme, des dossiers Linux et de l'unité systemd.	3 à 32 caractères : lettres minuscules, chiffres et tirets. Commence par une lettre ou un chiffre.
   Nom du service Windows	Le nom du service Windows et de ses dossiers.	3 à 64 caractères : lettres, chiffres, tirets et tirets bas. Commence par une lettre ou un chiffre.
   Description du service	La description du service.	256 caractères au plus. Le champ peut rester vide.
   Adresse du support	L'adresse du support dans Applications installées.	Facultatif. Une adresse https.
   Domaine	Votre propre domaine.	Facultatif. Voir « Poser votre domaine » plus bas.

2. Lisez le bloc Aperçu à droite. Il suit votre saisie.

3. Cliquez sur Enregistrer le profil.

Le portail affiche « Profil enregistré », avec la nouvelle révision.

Le portail refuse un nom dans ces cas :

Cas	Message
Un nom qui commence par baastide	Le préfixe est réservé.
Un nom de service ou de dossier du système, par exemple systemd, vss, docker ou nginx	Le nom est réservé par le système.
Un nom court ou un nom de service déjà pris par un autre MSP	Choisissez d'autres noms.

Un enregistrement avec les mêmes valeurs ne change rien : la révision reste la même.

Lire l'aperçu

Le bloc Aperçu donne ce qu'une nouvelle installation pose sur la machine, avec les valeurs du formulaire.

Section de l'aperçu	Ce qu'elle donne
Windows	Le service, son nom affiché, le programme et le dossier des données.
Applications installées	Le nom, l'éditeur et le support.
Linux	Le programme, les dossiers et l'unité systemd.
Commandes d'installation	Les deux commandes, avec <jeton> à la place d'un vrai jeton.

Les noms se posent ainsi sur la machine :

	Linux	Windows
Programme	/usr/local/bin/<nom court>	%ProgramFiles%\<nom du service>\<nom court>.exe
Identité de la machine	/etc/<nom court>/agent.conf	%ProgramData%\<nom du service>\agent.conf
État	/var/lib/<nom court>	%ProgramData%\<nom du service>
Cache	/var/cache/<nom court>	%ProgramData%\<nom du service>\cache
Service	Unité systemd <nom court>.service	Service <nom du service>
Entrée de désinstallation	Aucune	Dans Applications installées, sous le nom du produit

Donner les commandes d'installation

Le bloc Adresse d'installation donne l'adresse d'où les commandes téléchargent le script d'installation. Cette adresse porte l'identifiant de votre profil. Elle ne donne aucun accès.

1. Lisez Script Linux et Script Windows.
2. Créez un jeton d'enrôlement ou un jeton de déploiement. Le portail donne alors les commandes complètes, avec ces adresses et le jeton. Voir Créer un jeton d'enrôlement et Déployer sur beaucoup de machines.
3. Lancez la commande sur la machine. Voir Installer l'agent sur Linux et Installer l'agent sur Windows.

Sans profil enregistré, les commandes utilisent l'adresse de BaaStide.

Régénérer l'adresse d'installation

Régénérez l'adresse quand une commande d'installation a pu fuiter, ou quand vous voulez arrêter des commandes données auparavant.

1. Dans le bloc Adresse d'installation, cliquez sur Régénérer l'adresse.
2. Lisez la fenêtre Régénérer l'adresse d'installation ?.
3. Cliquez sur Régénérer l'adresse.

L'adresse précédente ne répond plus, dès maintenant. Les commandes d'installation données avant échouent. Les agents déjà installés continuent de fonctionner.

Donnez les nouvelles commandes d'installation à vos techniciens et à votre outil de déploiement.

Poser votre domaine

Avec votre domaine, les adresses que vos clients voient portent votre nom.

1. Dans le champ Domaine, saisissez le nom de domaine, sans https:// et sans chemin, par exemple sauvegarde.example.com.
2. Lisez l'aide sous le champ. Elle donne le nom d'hôte de la plateforme.
3. Dans votre zone DNS, créez un enregistrement CNAME de votre domaine vers ce nom d'hôte.
4. Cliquez sur Enregistrer le profil.
5. Demandez au support d'activer le certificat de votre domaine.

Les nouvelles commandes d'installation, les nouveaux agents et les liens des emails utilisent ensuite ce domaine.

Vérifier le profil d'un agent installé

1. Ouvrez la fiche de l'endpoint.

2. Ouvrez l'onglet Paramètres.

3. Lisez la ligne Profil d'installation :

   Valeur	Ce qu'elle veut dire
   Noms BaaStide	L'agent porte les noms de BaaStide.
   Révision N	L'agent a été installé avec la révision N de votre profil.
   Inconnu (agent plus ancien que la marque blanche)	L'agent est trop ancien pour envoyer cette information.

Limites et précautions

• Un changement du profil ne touche pas les agents déjà installés. Ils gardent leurs noms, leurs dossiers et leur service. Une mise à jour de l'agent garde aussi le nom et le chemin du programme.
• Un agent déjà installé ne prend jamais les nouveaux noms. Choisissez donc vos noms avant de déployer un parc.
• Un nouvel enrôlement de la même machine est refusé tant que son endpoint est actif dans le client. Voir Avant d'installer.
• Le nom court et le nom du service sont uniques sur la plateforme, sans tenir compte de la casse. Un autre MSP peut déjà les avoir pris.
• Les noms réservés du système ne sont pas acceptés. L'agent crée, et à la désinstallation retire, le service et les dossiers de ces noms : un nom réservé arrêterait ou supprimerait une partie du système.
• Les dossiers racines sont fixes : %ProgramFiles%, %ProgramData%, /usr/local/bin, /etc, /var/lib, /var/cache et /usr/lib. Le profil ne donne que des noms.
• Sous Windows, l'installation refuse un dossier %ProgramFiles% ou %ProgramData% qui contient déjà les fichiers d'un autre programme.
• Les propriétés du fichier du programme gardent des noms neutres : Backup Agent. La signature numérique du programme reste au nom de l'entreprise qui publie l'agent.
• L'adresse d'installation est publique. Elle ne donne que les noms de votre profil, jamais un jeton. Le jeton reste dans la variable d'environnement de la commande d'installation.
• Une seule adresse d'installation est valable à la fois. Après une régénération, l'ancienne répond une erreur.
• Un domaine appartient à un seul MSP. Le domaine de la plateforme n'est pas accepté.
• Un agent garde le domaine avec lequel il s'est enrôlé. Un changement du domaine ne le déplace pas.
• Chaque changement est tracé dans le Journal d'audit, sous les actions « Profil d'installation modifié » et « Lien d'installation remplacé ».

Référence

• API : Enrollment, route GET /install-profile.