Introduction
Lorsque vous clonez un appareil sur lequel l'agent Level est déjà installé, l'original et le clone partagent le même identifiant d'agent. Cela entraîne un conflit : les deux appareils se disputent la même entrée dans Level, et l'un ou les deux afficheront une connectivité erratique. Cet article explique la récupération d'identité automatique et comment faire tourner l'identifiant de l'agent sur l'appareil cloné si le conflit persiste.
ℹ️ REMARQUE : Cela ne concerne que les appareils clonés. La réinstallation de l'agent sur un appareil existant ne modifie pas son identifiant. Level conserve l'identifiant d'origine lors des réinstallations afin d'éviter les doublons.
ℹ️ REMARQUE : La réinitialisation et la réinscription via Autopilot constituent un cas différent. Les appareils Autopilot joints à Entra utilisant les agents actuels sont associés à la même ligne Level en utilisant l'identifiant d'appareil Entra joint au niveau machine. Ne faites pas tourner l'identifiant de l'agent pour « corriger » une réinscription Autopilot. Voir Installer via Intune sur Windows.
Récupération d'identité automatique
Sur les agents qui prennent en charge la récupération d'identité automatique, Level peut demander à l'agent déclarant de changer son identifiant lorsqu'il détecte des modifications répétées du nom d'hôte et du numéro de série sous la même identité d'agent. Le rapport qui déclenche la réinitialisation doit inclure un numéro de série différent de celui actuellement enregistré. Un changement de nom d'hôte seul n'est pas suffisant.
L'agent remplace son identifiant stocké par un UUID aléatoire. Lorsqu'il se réenregistre avec succès à l'aide de sa clé d'installation existante, il apparaît comme une entrée d'appareil distincte dans l'espace de travail associé à cette clé. Cette récupération ne fusionne ni ne supprime l'enregistrement existant.
Si la clé d'installation spécifie un groupe, la nouvelle entrée est affectée à ce groupe. Elle ne copie pas l'affectation de groupe actuelle de l'enregistrement existant.
La récupération automatique n'est pas garantie pour chaque clone. Les clones qui signalent le même nom d'hôte ou numéro de série peuvent ne pas satisfaire les critères de détection. La récupération dépend également de la réception par l'agent de la demande de réinitialisation et de l'enregistrement réussi de sa nouvelle identité.
Vérifier si le conflit a été résolu
Identifiez l'appareil d'origine et le clone à l'aide de leurs noms d'hôte et de leurs informations matérielles. Ouvrez l'onglet Système et vérifiez la Numéro de série dans l'onglet Système section par rapport à la machine attendue. Voir Système de l'appareil.
Confirmez que chaque machine possède sa propre entrée. Vérifiez les rapports ultérieurs pour vous assurer que le nom d'hôte et le numéro de série n'alternent plus entre les machines sur une même entrée. Une nouvelle entrée seule ne prouve pas que les deux appareils communiquent correctement.
Vérifiez le groupe, les étiquettes et les valeurs des champs personnalisés de la nouvelle entrée, et appliquez les paramètres dont elle a besoin.
Si les machines partagent encore une seule entrée ou si leurs détails continuent de changer, utilisez les procédures de rotation d'identifiant ci-dessous sur le clone confirmé, ou contactez le support Level. Si un appareil reste hors ligne, suivez également Dépannage des problèmes d'agent plutôt que de supposer que le conflit d'identité est la seule cause.
Ne supprimez pas une entrée uniquement parce qu'une seconde entrée est apparue. Confirmez d'abord quelle machine correspond à chaque enregistrement.
Faire tourner l'identifiant de l'agent avec une commande
Pour un conflit de clone confirmé qui n'a pas été résolu, le drapeau --new-agent-id régénère la configuration d'identité de l'agent et tente de redémarrer le service de l'agent.
Exécutez ceci sur l'appareil cloné :
🖥️ NOTE DE PLATEFORME :
Windows :
& 'C:\Program Files\Level\level.exe' --new-agent-idmacOS :
sudo /usr/local/bin/level --new-agent-idLinux :
sudo /usr/local/bin/level --new-agent-id
Lorsque l'appareil cloné s'enregistre avec un nouvel identifiant d'agent, il apparaît comme une entrée distincte dans Level. Utilisez les vérifications de récupération ci-dessus pour confirmer le résultat.
Sur les appareils Windows joints à Entra, cette commande peut réutiliser l'identifiant d'appareil Entra au niveau machine. Si les entrées sont toujours en conflit, utilisez la procédure manuelle ci-dessous ou contactez le support Level.
Faire tourner l'identifiant de l'agent manuellement
Si vous ne pouvez pas exécuter le binaire de l'agent directement (par exemple, l'agent est arrêté ou le binaire est inaccessible), vous pouvez modifier l'identifiant directement dans la configuration.
⚠️ AVERTISSEMENT : Définissez la valeur sur un UUID v4 valide (généré aléatoirement). Ne réutilisez pas un identifiant provenant d'un autre appareil et ne laissez pas le champ vide. Après modification, redémarrez le service Level pour que le changement prenne effet.
🖥️ NOTE DE PLATEFORME :
Windows, Clé de registre :
Chemin :
HKEY_LOCAL_MACHINE\SOFTWARE\LevelNom de la clé :
AgentIDRemplacez la valeur par un nouvel UUID.
macOS, Fichier de configuration :
Chemin :
/Library/Application Support/Level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Linux, Fichier de configuration :
Chemin :
/etc/level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Après modification, redémarrez le service Level :
🖥️ NOTE DE PLATEFORME :
Windows :
Restart-Service -Name LevelmacOS :
sudo launchctl kickstart -k system/LevelLinux :
systemctl restart Level
Prévenir ce problème à l'avenir
Deux options pour les flux de travail de provisionnement basés sur le clonage :
Option 1 : Faire tourner l'UUID après le clonage (recommandé) : Conservez l'agent dans votre image principale et exécutez --new-agent-id dans le cadre de votre étape de provisionnement post-clonage (via MDM, script de démarrage ou RMM). Incluez les vérifications de récupération ci-dessus dans votre processus de provisionnement pour vérifier que chaque clone s'enregistre séparément.
Option 2 : Désinstaller avant la création de l'image : Supprimez l'agent Level avant de créer l'image principale, puis installez Level lors de l'étape post-clonage. Chaque appareil obtient un identifiant d'agent neuf à l'installation.
💡 CONSEIL : Les guides d'installation de Level pour Windows, macOS et Linux incluent des commandes d'installation silencieuse adaptées aux scripts de déploiement et aux flux de travail post-clonage MDM.
FAQ
Sur quel appareil dois-je exécuter --new-agent-id, l'original ou le clone ? Exécutez-la sur le clone, après avoir confirmé quelle machine est le clone. Ne faites pas tourner l'identifiant de l'appareil d'origine à titre de nettoyage général.
Après rotation de l'identifiant, l'appareil cloné héritera-t-il des groupes, étiquettes et champs personnalisés de l'original ? Il s'enregistre comme un nouvel appareil plutôt que de copier l'enregistrement d'origine. Si sa clé d'installation spécifie un groupe, Level l'affecte à ce groupe. Vérifiez le groupe, les étiquettes et les valeurs des champs personnalisés du nouvel enregistrement après l'enregistrement.
Puis-je pousser --new-agent-id via Level si les deux appareils apparaissent de façon intermittente ? C'est peu fiable lorsque deux appareils se disputent le même identifiant. L'accès local ou un autre outil distant est plus sûr. Après la rotation, utilisez les vérifications de récupération ci-dessus pour confirmer les enregistrements et connexions séparés.
Comment générer un UUID valide à utiliser pour une rotation manuelle d'identifiant ? Sur Windows :
[guid]::NewGuid().ToString()dans PowerShell. Sur macOS/Linux :uuidgen. L'un ou l'autre produit un UUID v4 valide.Mon appareil Autopilot a créé une deuxième ligne après une réinitialisation. Dois-je faire tourner l'identifiant de l'agent ? Non. Cet article concerne les appareils clonés qui partagent un même identifiant d'agent. La réinitialisation et la réinscription via Autopilot utilisent une identité différente. Voir Installer via Intune sur Windows.
