Skip to content

Commit

Permalink
adding device_tracker.tomato https params (#4389)
Browse files Browse the repository at this point in the history
* adding device_tracker.tomato https params

* converting to newer standard

* removing extra space

* Adding default values

* fixing some misc quoting bugs

* cleaning up optional params

* updating default port param to match ssl choice

* changing verbage
  • Loading branch information
GregoryDosh authored and frenck committed Jan 24, 2018
1 parent 2f8bd0b commit 48fbcd8
Showing 1 changed file with 40 additions and 7 deletions.
47 changes: 40 additions & 7 deletions source/_components/device_tracker.tomato.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -29,14 +29,47 @@ device_tracker:
http_id: YOUR_HTTP_ID
```
Configuration variables:
- **host** (*Required*): The IP address of your router, e.g. 192.168.1.1.
- **username** (*Required*: The username of an user with administrative privileges, usually *admin*.
- **password** (*Required*): The password for your given admin account.
- **http_id** (*Required*): The value can be obtained by logging in to the Tomato admin interface and search for `http_id` in the page source code.
{% configuration %}
host:
description: "The IP address or hostname of your router, e.g. `192.168.1.1` or `rt-ac68u`."
required: false
type: string
port:
description: "The port number of your router, e.g. `443`."
required: false
type: int
default: 80/443 (automatically detected)
ssl:
description: "Whether to connect via `https`."
required: false
type: bool
default: false
verify_ssl:
description: "If SSL verification for https resources needs to be turned off (for self-signed certs, etc.) this can take on boolean values `False` or `True` or you can pass a location on the device where a certificate can be used for verification e.g. `/mnt/NAS/router_cert.pem`."
required: false
type: [string, bool]
default: true
username:
description: "The username of an user with administrative privileges, usually *admin*."
required: true
type: string
password:
description: "The password for your given admin account."
required: true
type: string
http_id:
description: "The value can be obtained by logging in to the Tomato admin interface and search for `http_id` in the page source code."
required: true
type: string
{% endconfiguration %}

See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked.

A description of the API s available in this [Tomato API](http://paulusschoutsen.nl/blog/2013/10/tomato-api-documentation/) blog post.


SSL Certificate:

Gathering the SSL Certificate of your router can be accomplished with this (or a similar) command:
```bash
openssl s_client -showcerts -connect 172.10.10.1:443 </dev/null 2>/dev/null | openssl x509 -outform PEM > router_cert.pem
```

0 comments on commit 48fbcd8

Please sign in to comment.