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-12 20:06:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add documentation for application credentials (#22847)

Browse Source 
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Allen Porter 2022-05-30 04:02:10 -07:00 committed by Franck Nijhof
parent dfa5b3717b
commit d9e227fec5
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
1 changed files with 26 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
source/_integrations/application_credentials.markdown Normal file
View File

@ -0,0 +1,26 @@
---
title: Application Credentials
description: Allows users to link accounts with integrations that support OAuth2
ha_release: 2022.6
ha_domain: application_credentials
ha_quality_scale: internal
ha_category: []
ha_codeowners:
- '@home-assistant/core'
ha_integration_type: integration
---
The Application Credentials integration is used by integrations that use OAuth2 to link your account to Home Assistant. The most common and preferred approach is using account linking with Home Assistant Cloud, however not all cloud providers support that and integrations can use Application Credentials instead. Additionally, users may use Application Credentials if preferred instead of Home Assistant Cloud Account Linking.
## Manual Setup
Note that integrations that do not support cloud linking will prompt to setup Application Credentials
when setting up for the first time. You may also manually enter credentials with the following steps:
1. Obtain an OAuth *Client ID* and *Client Secret* from the cloud provider. The integration should have specific instructions for this.
2. In Home Assistant navigate to **Settings** -&gt; **Devices &amp; Services**
3. Click the overflow menu **...** and choose **Application Credentials**
4. Select the integration, enter a *Name* and your OAuth *Client ID* and *Client Secret*.
5. Save the credentials
You may then visit **Integrations** and setup the integration.