52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# Accès et preuves
|
|
|
|
## Principe
|
|
|
|
Toujours choisir l'accès le moins intrusif qui permet de répondre correctement.
|
|
|
|
## Ordre de préférence
|
|
|
|
1. **Artefacts locaux fournis par l'utilisateur**
|
|
- `home-assistant.log`
|
|
- `configuration.yaml` et fichiers inclus
|
|
- exports ou captures de dashboards
|
|
- diagnostics téléchargés depuis une intégration
|
|
- sorties de commandes déjà collectées
|
|
|
|
2. **API Home Assistant avec token longue durée**
|
|
- utile pour récupérer version, états, registres, services et diagnostics exposés
|
|
- préférer le token au mot de passe
|
|
|
|
3. **SSH**
|
|
- utile seulement pour métriques hôte, journaux système, stockage, fichiers non exportés, commandes supervisor/core selon le type d'installation
|
|
- justifier pourquoi SSH est nécessaire avant de le demander
|
|
- si SSH est retenu, collecter au minimum : hôte, port, utilisateur, puis soit mot de passe soit chemin de clé privée
|
|
- préférer l'authentification par clé quand elle est disponible ; utiliser le mot de passe seulement si c'est le mode réellement fourni
|
|
|
|
4. **MCP**
|
|
- optionnel, jamais requis par principe
|
|
- l'utiliser uniquement s'il existe déjà et apporte un accès structuré, traçable ou plus sûr qu'un accès ad hoc
|
|
|
|
## Preuves minimales à réunir
|
|
|
|
- version exacte de Home Assistant Core
|
|
- date/heure de collecte
|
|
- type d'installation si connu ; si le shell distant est isolé dans un add-on, corroborer avec l'API ou d'autres indices au lieu de conclure trop vite à `unknown`
|
|
- sources de logs inspectées
|
|
- liste des fichiers de configuration lus
|
|
- provenance des métriques matériel
|
|
- liste des dashboards inspectés
|
|
- liste des entités réellement observées
|
|
|
|
## Commandes ou données typiquement utiles
|
|
|
|
Les commandes exactes dépendent du mode d'installation et ne doivent être proposées qu'après vérification documentaire compatible avec la version installée.
|
|
|
|
Exemples de catégories de données utiles :
|
|
- version de Home Assistant
|
|
- CPU et mémoire
|
|
- espace disque
|
|
- extraits de logs autour des erreurs, selon la source officielle adaptée au mode d'installation
|
|
- registres d'entités et d'appareils
|
|
- contenu des dashboards YAML ou exports équivalents
|