Dépannage

Problèmes courants & solutions#

Un partage ne se monte pas#

Si l’application tente de monter un partage mais échoue :

  1. Connectivité réseau : Assure-toi d’être connecté au bon réseau (ou VPN) et que le serveur est joignable.
  2. Profil d’authentification : Vérifie que le profil d’authentification assigné contient le bon mot de passe, à jour.
  3. Tickets Kerberos : Si tu utilises un profil Kerberos, ouvre le Terminal macOS et tape klist pour vérifier que tu as un Ticket-Granting Ticket (TGT) valide et non expiré.
  4. NetAuthSysAgent : NetAuthSysAgent est un processus macOS responsable du montage des partages réseau et de l’autorisation réseau. Il peut afficher des boîtes de dialogue via NetAuthAgent si nécessaire. Malheureusement, sur de nombreuses versions de macOS, il existe un problème où NetAuthSysAgent se bloque parfois. On le voit quand une demande de montage n’est pas exécutée. Dans ce cas, la seule solution est d’exécuter killall NetAuthSysAgent.

Un partage Kerberos dans un espace de noms DFS affiche “invalid credentials”#

Si un partage Kerberos utilise le nom de domaine au lieu d’un nom de serveur (un espace de noms DFS basé sur le domaine comme smb://example.com/shares), le montage peut échouer avec “invalid credentials” alors que le ticket Kerberos est valide. macOS demande alors un ticket pour le nom de domaine lui-même (cifs/example.com), qu’Active Directory ne connaît généralement pas. Tu peux le vérifier dans le Terminal : kgetcred cifs/example.com@EXAMPLE.COM indique que le serveur est inconnu.
Solution (macOS 26.5 ou ultérieur, Mac non liés à Active Directory) : Laisse macOS résoudre l’espace de noms DFS via les contrôleurs de domaine. Crée le fichier ~/Library/Preferences/nsmb.conf avec le contenu suivant et redémarre le Mac :

[default]
srv_lookup_enabled=yes

Les administrateurs peuvent déployer ce réglage pour tous les utilisateurs sous forme de /etc/nsmb.conf (voir Guide de l’administrateur informatique (MDM)).

Erreur de nom en double#

Si tu reçois une erreur de nom en double lors de l’ajout d’un partage, cela signifie qu’un autre partage utilise déjà ce nom de dossier dans ~/Networkshares/. Solution : Utilise la fonctionnalité de nom personnalisé de la version 4 pour assigner un nom local unique au nouveau partage.

Statut “Affectation de profil requise”#

Si un partage affiche ce statut dans l’interface, cela signifie qu’il n’a pas d’identifiants. Solution :

  1. Ouvre Preferences → Network Shares.
  2. Sélectionne le partage concerné et clique sur modifier.
  3. Assigne manuellement un profil d’authentification depuis le menu déroulant.
  4. Clique sur Save Changes.

Débogage avancé#

Pour un dépannage IT approfondi, Network Share Mounter journalise son activité nativement dans le système de logs unifié de macOS. Ouvre Console.app et filtre sur le processus NetworkShareMounter pour voir les logs de connexion en temps réel et les états d’erreur :
log stream --predicate "subsystem == 'de.fau.rrze.NetworkShareMounter'" --level debug

Tu peux maintenant envoyer des logs directement depuis l’application aux développeurs pour le dépannage :

  1. Ouvre Settings et sélectionne General à gauche.
  2. Clique 5 fois d’affilée sur Diagnostics.
  3. Un nouveau bouton apparaîtra, te permettant d’envoyer des diagnostics ou des fichiers de logs aux développeurs de Network Share Mounter.

Les journaux des composants macOS comme le client SMB ne peuvent être inclus qu’avec des droits d’administrateur. Sans ces droits, seuls les journaux de Network Share Mounter lui-même sont envoyés.