navin-manager serve s'arrête avec une liste de problèmes | Un réglage de production n'est pas sûr (TLS, certificats clients, attribut du cookie, jeton de métriques, coût scrypt, clé maître, sslmode). | Corrigez chaque ligne affichée par navin-manager check. |
master key file ... must not be readable by group or others | Le fichier de la clé a une permission de groupe ou pour les autres. | chown navin-manager:navin-manager /etc/navin-manager/master.key && chmod 0600 /etc/navin-manager/master.key |
sealed value was altered or sealed with another master key | La clé maître a changé après le stockage des secrets. | Restaurez la clé d'origine depuis le coffre de la banque. Une nouvelle clé ne lit pas les anciens secrets. |
/readyz répond 503 database_unavailable | La base de la console est injoignable ou refuse le TLS. | Vérifiez database_url, le fichier d'autorité de sslrootcert, le pare-feu vers PostgreSQL, le mot de passe dans server.env. |
La console répond 503 ui_not_built | Les fichiers de la console manquent dans NM_UI_DIR. | Réinstallez le paquet, ou dans une copie des sources lancez npm ci && npm run build dans navin-manager/ui. |
nm-agent register échoue avec bootstrap_token_invalid | Le jeton a expiré, a été révoqué, épuisé ou mal saisi. | Créez un nouveau jeton dans Hôtes, Ajouter des hôtes. |
nm-agent register refuse l'empreinte de l'autorité | La valeur --ca-sha256 ne correspond pas à l'autorité servie par la console (mauvais serveur ou interception). | Recopiez la commande depuis la console ; vérifiez que l'agent joint la bonne console. |
host_in_other_cluster | L'hôte est encore enregistré dans un autre cluster. | Mettez-le d'abord hors service dans cet autre cluster. |
Requêtes de l'agent refusées avec agent_signature_invalid | L'horloge de l'hôte s'écarte de plus de 5 minutes de celle de la console, ou le secret de l'agent a été remplacé. | Synchronisez l'horloge (chronyd ou systemd-timesyncd) ; enregistrez à nouveau l'hôte s'il a été réenregistré ailleurs. |
| Hôte affiché comme perdu | Aucun signal depuis 120 secondes : agent arrêté, réseau coupé, port 8461 filtré. | systemctl status navin-manager-agent, journalctl -u navin-manager-agent, testez curl https://<console>:8461/healthz depuis l'hôte. L'alerte se résout au signal suivant. |
Contrôle préalable time_sync en échec | Aucun service de synchronisation de l'heure n'est actif. | Activez chronyd (RHEL) ou systemd-timesyncd (Ubuntu). |
Installation refusée avec artifact_missing | Le miroir ne contient pas une archive, une image ou un dépôt Python de la version demandée. | Construisez un bundle avec ce service et cette version, décompressez-le, rechargez le miroir. Administration, Miroir liste ce qui manque. |
Tâche en échec avec checksum_mismatch | Un fichier téléchargé diffère du manifeste (miroir corrompu ou réécriture par un proxy). | Lancez verify-bundle.py --mirror ; restaurez le bundle. Ne modifiez jamais manifest.json à la main. |
Tâche en échec avec path_not_allowed | La tâche vise un chemin hors des répertoires gérés, ou un lien symbolique se trouve dans le chemin. | Supprimez le lien symbolique (par exemple un lien /var/lib/navin vers un autre disque : montez plutôt le disque à cet endroit). |
Tâche en échec avec not_root | Un agent sans root (bac à sable) a reçu une tâche qui demande root. | Utilisez un hôte de production avec l'agent lancé en root, ou un cluster bac à sable. |
Tâche timed_out | Aucun résultat avant le délai : agent redémarré, commande bloquée. | Lisez les journaux de la tâche, puis Relancer. Une tâche interrompue par un redémarrage de l'agent échoue avec agent_restarted. |
Contrôle préalable port_free en échec | Un autre processus écoute sur le port du composant. | Arrêtez ce processus ou changez le paramètre de port du service. |
health_check_failed après le démarrage | Le composant n'est pas devenu sain. | Journaux sur le composant, puis corrigez sa configuration et Redémarrer. |
| Un utilisateur ne peut plus se connecter après la perte de son appareil TOTP | | Un security_admin réinitialise le second facteur dans Administration, Utilisateurs ; l'utilisateur l'enrôle à nouveau. |
| Tous les administrateurs sont verrouillés | | navin-manager create-admin --username <nom> --password-stdin sur l'hôte de la console réinitialise ce compte local. |
GET /api/v1/audit/verify indique valid: false | Un événement d'audit a été modifié dans la base. | Conservez la base comme preuve et déclarez un incident de sécurité : la réponse donne le premier événement altéré. |