From 33d064393c087495e19376387f5b87420b1c1935 Mon Sep 17 00:00:00 2001 From: Matthew Donoughe Date: Sat, 18 Nov 2017 09:41:05 -0500 Subject: [PATCH] documentation for Lutron Caseta update (#3883) * initial documentation for caseta update * get zip from home-assistant.github.io --- source/_components/lutron_caseta.markdown | 10 +++++++++- source/assets/get_lutron_cert.zip | Bin 0 -> 2468 bytes 2 files changed, 9 insertions(+), 1 deletion(-) create mode 100644 source/assets/get_lutron_cert.zip diff --git a/source/_components/lutron_caseta.markdown b/source/_components/lutron_caseta.markdown index c2a3f41f7c6..912bd82dc41 100644 --- a/source/_components/lutron_caseta.markdown +++ b/source/_components/lutron_caseta.markdown @@ -27,17 +27,25 @@ The currently supported Caseta devices are: When configured, the `lutron_caseta` component will automatically discover the currently supported devices as setup in the Lutron Smart Bridge. The name assigned in the Lutron mobile app will be used to form the `entity_id` used in Home Assistant. e.g. a dimmer called 'Bedroom Lamp' becomes `light.bedroom_lamp` in Home Assistant. -To use Lutron Caseta devices in your installation, add the following to your `configuration.yaml` file using the IP of your Smart Bridge: +To use Lutron Caseta devices in your installation, you must first log in to your Lutron account and generate a certificate that allows Home Assistant to connect to your bridge. This can be accomplished by downloading and executing [this script](/assets/get_lutron_cert.zip), which will generate three files: caseta.key, caseta.crt, caseta-bridge.crt when you run it. See the instructions at the top of the script for more information. + +Once you have the three necessary files, place them in your configuration directory and add the following to your `configuration.yaml`: ```yaml # Example configuration.yaml entry lutron_caseta: host: IP_ADDRESS + keyfile: caseta.key + certfile: caseta.crt + ca_certs: caseta-bridge.crt ``` Configuration variables: - **host** (*Required*): The IP address of the Lutron Smart Bridge. +- **keyfile** (*Required*): The private key that Home Assistant will use to authenticate to the bridge. +- **certfile** (*Required*): The certificate chain that Home Assistant will use to authenticate to the bridge. +- **ca_certs** (*Required*): The list of certificate authorities (usually only one) that Home Assistant will expect when connecting to the bridge.

It is recommended to assign a static IP address to your Lutron Smart Bridge. This ensures that it won't change IP address, so you won't have to change the `host` if it reboots and comes up with a different IP address. diff --git a/source/assets/get_lutron_cert.zip b/source/assets/get_lutron_cert.zip new file mode 100644 index 0000000000000000000000000000000000000000..b3849e8a4120cd5d2e6eda0c985e064a715ffb89 GIT binary patch literal 2468 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 literal 0 HcmV?d00001