You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
55 lines
1.5 KiB
55 lines
1.5 KiB
4 months ago
|
---
|
||
|
|
title: OpenWRT
|
||
|
|
description: OpenWRT widget configuration
|
||
|
|
---
|
||
|
|
|
||
|
|
Learn more about [OpenWRT](https://openwrt.org/).
|
||
|
|
|
||
|
|
Provides information from OpenWRT
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
widget:
|
||
|
|
type: openwrt
|
||
|
|
url: http://host.or.ip
|
||
|
|
username: homepage
|
||
|
|
password: pass
|
||
|
|
interfaceName: eth0 # optional
|
||
|
|
```
|
||
|
|
|
||
|
|
## Interface
|
||
|
|
|
||
|
|
Setting `interfaceName` (e.g. eth0) will display information for that particular device, otherwise the widget will display general system info.
|
||
|
|
|
||
|
|
## Authorization
|
||
|
|
|
||
|
|
In order for homepage to access the OpenWRT RPC endpoints you will need to [create an ACL](https://openwrt.org/docs/techref/ubus#acls) and [new user](https://openwrt.org/docs/techref/ubus#authentication) in OpenWRT.
|
||
|
|
|
||
|
|
Create an ACL named `homepage.json` in `/usr/share/rpcd/acl.d/`, the following permissions will suffice:
|
||
|
|
|
||
|
|
```
|
||
|
|
{
|
||
|
|
"homepage": {
|
||
|
|
"description": "Homepage widget",
|
||
|
|
"read": {
|
||
|
|
"ubus": {
|
||
|
|
"network.interface.wan": ["status"],
|
||
|
|
"network.interface.lan": ["status"],
|
||
|
|
"network.device": ["status"]
|
||
|
|
"system": ["info"]
|
||
|
|
}
|
||
|
|
},
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
Then add a user that will use that ACL in `/etc/config/rpc`:
|
||
|
|
|
||
|
|
```config login
|
||
|
|
option username 'homepage'
|
||
|
|
option password '<password>'
|
||
|
|
list read homepage
|
||
|
|
list write '*'
|
||
|
|
```
|
||
|
|
|
||
|
|
This username and password will be used in Homepage's services.yaml to grant access.
|