Skip to content

v1.1.1 — Clearer error when camera user lacks write privileges

Choose a tag to compare

@JoshADC JoshADC released this 15 Apr 03:05
· 7 commits to main since this release

What changed

When the Home Assistant user configured in this integration lacks write privileges on a Hikvision camera, the firmware returns HTTP 403 with a variety of unhelpful subStatusCode values (lowPrivilege, notSupport, etc. — depending on firmware). Previously the integration surfaced only the raw code, which was misleading (e.g., "notSupport" made it look like a firmware or capabilities issue when it was actually a permissions issue).

This release adds a clear hint whenever a PUT fails with HTTP 403:

<raw_code> — permission denied. Check that the HA user has write privileges in the camera's web UI (Hikvision is picky about per-user permissions).

The hint shows up in both the user-facing entity error logs (select/number/switch) and the diagnostic warnings. Raw status codes are still used internally for conflict-resolution lookups — no behavior change for that.

How to fix a 403 on your camera

  1. Log in to the camera directly at http://<camera-ip>/ with an administrator account.
  2. Configuration → System → User Management.
  3. Edit the user configured in Home Assistant.
  4. Under Remote Permissions, enable Parameters / Configuration.
  5. Save — no HA restart needed; new writes will succeed immediately.

Credit

Diagnosed from issue #2 — thanks to @lkwchoi for the detailed logs that made the root cause obvious.