Formation PUB420 : Système domotique DIY, 2020 Home Assistant

6.20 Réinitialiser le mot de passe de Home Assistant (et le code d'usager si désiré)


Lorsque vous accédez à l'interface Web de Home Assistant, vous devez entrer un code d'usager et un mot de passe avant de poursuivre.

Login

Si vous avez oublié ces informations, il est possible de les réinitialiser à condition d'avoir un accès direct au Raspberry Pi à l'aide d'un clavier et d'un écran ou à un branchement via SSH.

Notez que si vous avez encore les accès requis pour vous connecter avec un compte d'administrateur, il est préférable de modifier le mot de passe via l'interface Web : Paramètres / Personnes / Clic sur l'usager à modifier / Changer le mot de passe.

Changer mot de passe

Est-ce que vous tentez d'accéder au bon Home Assistant?

Avant d'entreprendre la procédure de réinitialisation du mot de passe, vérifiez si vous tentez de vous connecter au bon Home Assistant.

En effet, dans un environnement qui comprend plusieurs installations de Home Assistant, vous pourriez être branché sur n'importe laquelle des installations disponibles si vous avez utilisé l'URL http://homeassistant.local:8123 ou encore http://homeassistant:8123

Pour vous assurer d'accéder au Home Assistant désiré lorsque plusieurs sont disponibles, vous devez utiliser un URL qui contient l'adresse IP du Raspberry Pi. L'adresse sera au format http://192.168.1.145:8123 , où 192.168.1.145 sera remplacé par l'adresse IP du Pi.

Mot de passe oublié

Si vous vous rappelez du code d'usager mais que vous avez oublié le mot de passe, suivez ces instructions :

Entrez cette commande à la console Home Assistant :

Console Home Assistant

auth reset --username nom_usager --password nouveau_mot_de_passe_en_clair

ou celle-ci dans le terminal HassOS (invite #) :

Terminal

ha auth reset --username nom_usager --password nouveau_mot_de_passe_en_clair

Code d'usager oublié

Dans le cas où vous ne connaissez aucun code d'usager, il est possible de remédier à la situation en éditant directement certains fichiers sur le Raspberry Pi à partir du terminal HassOS.

Sur HassOS, il est possible d'éditer les fichiers à l'aide de l'éditeur vi, un proche parent de l'éditeur vim.

Pour éditer un fichier avec vi :

Terminal

vi chemin/fichier

À son ouverture, vi vous place en mode commande. Pour passer d'un mode à l'autre :

  • en mode commande : la lettre i vous place en mode insertion, ce qui permet d'éditer le texte
  • en mode insertion : Échap vous place en mode commande

Pour enregistrer le document puis fermer l'éditeur : Échap suivi de : w q (ce qui signifie Write and Quit).

Pour fermer l'éditeur sans enregistrer : Échap suivi de : q !.

Les fichiers à éditer sont dans le dossier /mnt/data/supervisor/homeassistant/.storage.

Le nom d'usager apparaît à 3 endroits :

Fichier person

{
    "version": 2,
    "key": "person",
    "data": {
        "items": [
          {
            "name": "Nom complet",
            "user_id": "f2cd12cfc6424f518721196496cce50f",
            "device_trackers": [],
            "id": "nom_usager"
          }
        ]
    }
}

Fichier auth

...
"credentials": [
  {
    "id": "dbc82e9608534610afd72541f4c9f7a7",
    "user_id": "f2cd12cfc6424f518721196496cce50f",
    "auth_provider_type": "homeassistant",
    "auth_provider_id": null,
    "data": {
        "username": "nom_usager"
    }
  }
],
...

Fichier auth_provider.homeassistant

{
    "version": 1,
    "key": "auth_provider.homeassistant",
    "data": {
        "users": [
          {
            "username": "nom_usager",
            "password": "JDJiJDEyJC9vSzlBamlOWE5wOTJheWdidHBJM3VKSTRONkdQbElBZnZUQmZzdWZxelBFbDkwRno1MWZh"
          }
        ]
    }
}

Une fois les modifications effectuées, vous devez redémarrer Home Assistant :

Terminal

ha core restart

Si vous ne connaissez pas le mot de passe de cet usager, vous pouvez le réinitialiser à l'aide de la technique présentée plus haut.

Rechargez maintenant la page Web et vous serez en mesure de vous authentifier avec ce nom d'usager.

Réinitialiser la phase de préparation (onboarding process)

Il est possible d'effectuer une action beaucoup plus drastique en supprimant complètement certains fichiers créés pendant la phase de préparation qui est effectuée lors de l'installation de Home Assistant.

Ceci détruira tous les usagers et vous ramènera à l'écran qui vous demande de créer l'usager initial.

Pour réinitialiser la phase de préparation, vous devez simplement supprimer ces fichiers :

  • /mnt/data/supervisor/homeassistant/.storage/auth
  • /mnt/data/supervisor/homeassistant/.storage/auth_provider.homeassistant
  • /mnt/data/supervisor/homeassistant/.storage/onboarding
  • /mnt/data/supervisor/homeassistant/.storage/hassio
  • /mnt/data/supervisor/homeassistant/.storage/cloud

Pour plus d'information

« I'm Locked Out! ». Home Assistant. https://www.home-assistant.io/docs/locked_out/

▼Publicité

Veuillez noter que le contenu de cette fiche vous est partagé à titre gracieux, au meilleur de mes connaissances et sans aucune garantie.
Merci de partager !
Soumettre