From e8ff2ac71240ef0722dd1826311e4a265296d423 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Tue, 6 Aug 2024 18:22:30 +0200
Subject: [PATCH] Add another person to Home Assistant (#34157)
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
source/_docs/authentication.markdown | 4 +++
source/_integrations/person.markdown | 46 ++++++++++++++++++----------
2 files changed, 34 insertions(+), 16 deletions(-)
diff --git a/source/_docs/authentication.markdown b/source/_docs/authentication.markdown
index 871cef34bc0..8a83d5cc374 100644
--- a/source/_docs/authentication.markdown
+++ b/source/_docs/authentication.markdown
@@ -51,6 +51,10 @@ _Make sure to choose a secure password!_ At some time in the future, you will pr
As an extra level of security, you can turn on [multi-factor authentication](/docs/authentication/multi-factor-auth/).
+## Adding a person to Home Assistant
+
+If you have administrator rights, you can [add a person to Home Assistant](/integrations/person/#adding-a-person-to-home-assistant) and create them a user account.
+
## Changing display or user name
To learn how to change a display or user name, refer to [setting up basic information](/docs/configuration/basic/).
diff --git a/source/_integrations/person.markdown b/source/_integrations/person.markdown
index ac2de5440e1..eeedf8c73eb 100644
--- a/source/_integrations/person.markdown
+++ b/source/_integrations/person.markdown
@@ -32,6 +32,36 @@ In short, when you're at home, your position is determined first by stationary t
You can manage persons {% my people title="via the UI from the person page inside the configuration panel" %} or via `YAML` in your {% term "`configuration.yaml`" %} file.
+## Adding a person to Home Assistant
+
+If you have administrator rights, you can add other persons to Home Assistant and create them a user account. Depending on the rights you give them, they can then use Home Assistant on their own devices, can have their own dashboards, and be used in automations.
+
+1. Go to {% my people title="**Settings** > **People**" %} and select **Add person**.
+2. Enter their **Name**.
+3. Add an image if you like.
+4. Under **Allow login**, select if they should be able to log in.
+ - If they cannot log in, they do not get a user account, and they cannot do much with Home Assistant.
+ - They cannot have their own dashboard, for example.
+ - But they can still be used for device tracking and show up on a map and be used in automations.
+5. If they are able to log in, fill in the user information.
+ - Check if the user name is correct. A suggestion is made based on the person name. But they do not have to be identical.
+ - The username is required to log in.
+ - The person name is the name displayed in the UI.
+ - Enter a password and store it in a safe location.
+ - Define if they should have **Local access only**.
+ - If this is enabled, they won't have access to Home Assistant when they are outside your network, for example from their phone.
+ - Define if they should have **Administrator** rights.
+ - Select **Create**.
+6. If you have already set up devices for [presence detection](/getting-started/presence-detection/), **select the devices that belong to this person**.
+
+### Customizing the picture for a person
+
+You can easily upload a picture in the frontend. Simply click on a person, select or drop an image in the input field, and then crop it.
+
+
+
+See the documentation about [hosting files](/integrations/http/#hosting-files) for more information about the `www` folder.
+
## Configuring the `person` integration via the Home Assistant configuration panel
This integration is by default enabled, unless you've disabled or removed the [`default_config:`](/integrations/default_config/) line from your configuration. If that is the case, the following example shows you how to enable this integration manually:
@@ -90,19 +120,3 @@ person:
```
If you change the YAML, you can reload it by calling the `person.reload` service.
-
-### Customizing the picture for a person
-
-You can easily upload a picture in the frontend. Simply click on a person, select or drop an image in the input field, and then crop it.
-
-
-
-You can also do this using YAML. By following the instructions on the [customizing entities](/docs/configuration/customizing-devices#entity_picture) page, you can customize the picture used for a person entity in the `customize:` section of your configuration. For example:
-
-```yaml
-customize:
- person.ada:
- entity_picture: "/local/ada.jpg"
-```
-
-See the documentation about [hosting files](/integrations/http/#hosting-files) for more information about the `www` folder.