Skip to content

Credential management for Matter locks #69

@jlpouffier

Description

@jlpouffier

Problem statement

Right now, Home Assistant doesn't have an easy, built-in way to manage things like PINs and user codes for Matter smart locks. This forces people to use third-party app (the vendor's app) instead of a smooth, native system, which makes the whole experience clunky and confusing for new users.

Further information outlined here: https://docs.google.com/document/d/1kHqgRYzKV_FWDjPqZkr_D4B4jG2tf6nGhHUH0W7nBM4/edit?tab=t.0

Scope & Boundaries

In scope

  • CRUD (Create, Read, Update, Delete) actions for PINs and user codes.
  • Credentials are tied to the lock itself, not to a Home Assistant user.
  • Manage everything from the device page and show events in the device activity log.
  • Allow codes to be enabled or disabled without having to delete them.

Out of scope

  • Create and manage user profiles centrally in Home Assistant, similar to how Apple Home does it, and assign credentials to multiple devices from that profile.
  • Link a credential such as a PIN or fingerprint directly to a Home Assistant user so it can be managed across devices.
  • Features like scheduling and syncing codes across multiple devices are optional. For now, the focus is on the basics: core create, view, update, and delete actions, plus a device-centered experience.

Foreseen solution

Community signals

No response

Risks & open questions

  • Scope creep

Appetite

No response

Execution issues

No response

Decision log

Date Decision Outcome

Metadata

Metadata

Type

No type

Projects

Status

Done

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions