homepage/openwrt.md at 571cfa2231383c41a157f28c18dbc39160346fea

Update homepage.json detail to add a missing comma, add json formatting
Add guidance on creating a crypt(5) password hash for improved security (suggested by OpenWRT community dev)
Correct /etc/config/rpc to /etc/config/rpcd
Remove additional (not required) permissions from rpcd

2024-02-28 12:26:06 +13:00

1.6 KiB

Raw Blame History

title	description
OpenWRT	OpenWRT widget configuration

Learn more about OpenWRT.

Provides information from OpenWRT

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 and new user 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"]
                        }
                },
        }
}

Create a crypt(5) password hash using the following command in the OpenWRT shell:

uhttpd -m "<somepassphrase>"

Then add a user that will use that ACL in /etc/config/rpcd:

config login
        option username 'homepage'
        option password '<hashedpassword>'
        list read homepage

This username and password will be used in Homepage's services.yaml to grant access.

1.6 KiB Raw Blame History

Interface

Authorization

1.6 KiB

Raw Blame History