# 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