opnsense: 403 on connect

[EndlessEden]

The problem

Will edit with correct details later.
Secrets are correct. 24.7.12

What version of Home Assistant Core has the issue?

core-2025.4.1

What was the last working version of Home Assistant Core?

No response

What type of installation are you running?

Home Assistant OS

Integration causing the issue

opnsense

Link to integration documentation on our website

No response

Diagnostics information

No response

Example YAML snippet

Anything in the logs that might be useful for us?

Additional information

No response

[home-assistant]

Hey there @mtreinish, mind taking a look at this issue as it has been labeled with an integration (opnsense) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of opnsense can trigger bot actions by commenting:

• @home-assistant close Closes the issue.
• @home-assistant rename Awesome new title Renames the issue.
• @home-assistant reopen Reopen the issue.
• @home-assistant unassign opnsense Removes the current integration label and assignees on the issue, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component) to the issue.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component) on the issue.

_{^{(message by CodeOwnersMention)}}

---

opnsense documentation
opnsense source
_{^{(message by IssueLinks)}}

[issue-triage-workflows]

There hasn't been any activity on this issue recently. Due to the high number of incoming GitHub notifications, we have to clean some of the old issues, as many of them have already been resolved with the latest updates.
Please make sure to update to the latest Home Assistant version and check if that solves the issue. Let us know if that works for you by adding a comment 👍
This issue has now been marked as stale and will be closed if no further activity occurs. Thank you for your contributions.

[EndlessEden]

HASS: core-2025.5.0b0 | OS 15.2
Opnsense Version: 24.7.12

in config:

opnsense:
url: https://REDACTED/api
api_secret: REDACTED
api_key: REDACTED

Log state following:

Setup failed for 'opnsense': Integration failed to initialize. 
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/components/opnsense/__init__.py", line 56, in setup
    interfaces_client.get_arp()
    ~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "/usr/local/lib/python3.13/site-packages/pyopnsense/diagnostics.py", line 55, in get_arp
    return self._get("diagnostics/interface/getArp")
           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/pyopnsense/client.py", line 61, in _get
    return self._process_response(response, raw)
           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/pyopnsense/client.py", line 49, in _process_response
    raise exceptions.APIException(
        status_code=response.status_code, resp_body=response.text
    )
pyopnsense.exceptions.APIException: {"status":403,"message":"Forbidden"}

[EndlessEden]

Update: correction, it appears the wiki doesnt list it requires admin level permissions, rather than RO-only.

Please update wiki to reflect that.