jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-15 13:26:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

update Xbox docs to accurately represent manual setup (#15378)

Browse Source
This commit is contained in:
Jason Hunter 2020-10-28 05:06:14 -04:00 committed by GitHub
parent b106fe0bf1
commit cc9e661629
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 3 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
source/_integrations/xbox.markdown
View File

@ -15,7 +15,7 @@ ha_domain: xbox
The Xbox integration allows you to control Xbox One (or newer) consoles from Home Assistant.
Home Assistant authenticates with Xbox Live through OAuth2 using the Home Assistant account linking service. Set up the integration through **Configuration -> Integrations -> Xbox**. Ensure you login using the Microsoft account that is linked to your Xbox consoles.
Home Assistant authenticates with Xbox Live through OAuth2 using the Home Assistant Cloud account linking service. Set up the integration through **Configuration -> Integrations -> Xbox**. Ensure you login using the Microsoft account that is linked to your Xbox consoles.
- [Media Player](#media-player)
- [Service `play_media`](#service-play_media)
@ -274,13 +274,12 @@ It can take up to a couple of days for newly installed applications to appear in
These steps are not required, nor will they be supported if issues are encountered. It is recommended to add the integration directly in the Integrations page.
</div>
If you prefer not to use the Home Assistant account linking service, you may manually configure a local implementation using the following steps:
If you prefer not to use the Home Assistant account linking service, you may manually configure a local implementation if your instance is exposed externally over HTTPS using the following steps:
- Register a new application in [Azure AD](https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade)
- Name your app
- Select "Personal Microsoft accounts only" under supported account types
- For Redirect URI, add: `<INTERNAL_HOME_ASSISTANT_URL>/auth/external/callback`
Use your internal Home Assistant URL, if you didn't configure one manually, use your local IP address. Examples: `http://192.168.0.2:8123/auth/external/callback`, `http://homeassistant.local:8123/auth/external/callback`.
- For Redirect URI, add: `https://<EXTERNAL_HOME_ASSISTANT_URL>/auth/external/callback`
- Copy your Application (client) ID for later use
- On the App Page, navigate to "Certificates & secrets"
- Generate a new client secret and save for later use