16  Zigbee Security

zigbee-thread
zigbee
security
Keywords

Zigbee security evidence, Zigbee Trust Center review, Zigbee key custody, Zigbee install code review, Zigbee replay protection

16.1 In 60 Seconds

Zigbee security review asks whether joining, key transport, traffic protection, replay handling, and operations custody are proven for the deployment boundary. A network is not secure because it names encryption or has a Trust Center. It is reviewable when the join path, key custody, gateway visibility, device removal behavior, exceptions, owners, and retest triggers are recorded.

This chapter keeps the focus on evidence. It avoids treating security as a checklist of protocol fields, a business-case calculation, or a promise that one protocol choice removes operational risk.

16.2 Learning Objectives

By the end of this chapter, you will be able to:

  • state a bounded Zigbee security claim,
  • identify Trust Center and join-approval evidence,
  • separate network-key protection from application-specific protection,
  • review frame-counter and replay assumptions without overclaiming,
  • record key custody, exceptions, owners, and retest triggers, and
  • recognize common Zigbee security drift in deployment records.

16.3 Quick Check: Zigbee Security

16.4 Start With a Security Claim

Begin with the behavior being approved.

Weak claim: the Zigbee network is encrypted.

Stronger claim: within this deployment boundary, only authorized devices can join, the Trust Center and coordinator are owned, key transport is protected by an approved join method, traffic protection matches the application risk, replay protection assumptions are recorded, exceptions are visible, removed or replaced devices reopen the review, and operations knows who owns retest.

The stronger claim can be checked. It names the boundary, security authority, join method, protected traffic, operational visibility, and change triggers.

16.5 Evidence Families

Use these evidence families before accepting a Zigbee security claim.

Trust Center custody evidence records who owns the coordinator or Trust Center role, how configuration is backed up, who can change join policy, and how replacement is approved.

Join approval evidence records how a new device is authorized, whether permit-join is bounded, whether the expected device joined, and whether unauthorized joins are visible.

Key transport evidence records how the network key reaches a joining device and whether the join method depends on a shared default assumption or a device-specific credential.

Network-key custody evidence records where the shared network key is stored, who can access it, how backup is protected, and what happens after suspected exposure.

Application-security evidence records whether sensitive commands need pairwise or application-layer protection beyond mesh-layer encryption.

Replay and counter evidence records how replay assumptions are handled after device reset, rejoin, replacement, or gateway restore.

Operations evidence records monitoring, removal, incident response, retest triggers, and the owner of each security decision.

16.6 Trust Center and Join Approval Evidence

The Trust Center is the review anchor for Zigbee security. Do not stop at naming it. Review what it controls and who controls it.

Review:

  • which device or service holds the Trust Center role,
  • who can open or close joining,
  • how expected joiners are identified,
  • what credential or authorization evidence is used,
  • whether the gateway records join attempts and failures,
  • how removed devices are excluded from future approval, and
  • when Trust Center replacement requires retest.

Open joining is not automatically wrong, but it is not enough evidence by itself. The record should show the approved join window, the expected device, the observer, the result, and the follow-up action.

16.7 Key Transport and Key Custody

Zigbee deployments commonly depend on a shared network key for mesh-layer protection. The security review asks how that key was delivered, stored, backed up, and protected from unauthorized use.

At the protocol layer, Zigbee security rests on symmetric AES-128 CCM* and two key scopes. The network key is shared by every node in the PAN and secures NWK-layer frames, giving mesh-wide confidentiality and integrity. Link keys are pairwise, or in legacy cases global, and secure APS-layer commands between two specific nodes. The most important APS use is join-time network-key transport from the Trust Center to a newly authorized device.

That split makes the review sharper. The reviewer should be able to name the Trust Center, identify the link key or credential that protected each join, and explain who controls the shared network key. A single shared network key means one key exposure can affect the whole mesh, so the join step and key-custody record deserve direct evidence rather than a generic “encrypted network” note.

Zigbee security evidence boundary showing Trust Center custody, authorized join evidence, protected key transport, network traffic protection, application boundary review, operations visibility, decision, owner, and retest trigger.

Zigbee security evidence boundary showing Trust Center custody, authorized join evidence, protected key transport, network traffic protection, application boundary review, operations visibility, decision, owner, and retest trigger.

Review:

  • whether the joining method uses device-specific authorization evidence,
  • whether a well-known or shared commissioning assumption remains,
  • who can view, export, restore, or rotate key material,
  • where coordinator or gateway backups are stored,
  • how key exposure would be detected or handled,
  • whether removed devices require key or membership action, and
  • whether a backup restore preserves or weakens security state.

Avoid two common mistakes. First, do not treat encryption names as proof of key custody. Second, do not treat a successful join as proof that the correct device joined for the correct reason.

The riskiest instant in a Zigbee network’s life is a device joining, because that is when the Trust Center transports the network key to the newcomer. Two approaches protect that transport very differently. The legacy method uses a well-known default global link key, the ZigBeeAlliance09 value. Because it is public, anyone who sniffs a join secured only by that default can recover the network key and, with it, the whole mesh. The modern method uses install codes: each device ships with a unique install code, often printed as a QR label, from which a unique pairwise link key is derived. The Trust Center is pre-provisioned with that code, so the network-key transport is protected by a secret only that device and the Trust Center know.

This is why Zigbee 3.0 mandates install-code-based joining. A security review of a deployment asks one direct question about every device: was its join protected by a per-device install code, or by a default global link key that turns one captured join into permanent network compromise?

Join method Key protecting network-key transport Exposure
Default global link key Public ZigBeeAlliance09 value Sniff one join and recover the network key.
Install code Unique per-device derived link key Join secret known only to the device and Trust Center.

16.8 Network and Application Security Boundaries

Mesh-layer encryption and application-specific protection answer different questions.

Mesh-layer evidence answers: can network members exchange protected Zigbee traffic under the approved key and policy?

Application-security evidence answers: does a sensitive command, state change, or service action need protection that remains meaningful if the shared mesh key is exposed or if a gateway is replaced?

Use application-boundary review when the behavior affects physical access, safety-relevant actuation, tenant or patient privacy, billing, or other high-impact decisions. The review does not need a device-line promise. It needs a recorded reason for whether mesh-layer protection is sufficient or whether stronger pairwise, application, gateway, or operational controls are required.

16.9 Frame Counter and Replay Review

Frame counters and message freshness checks help reject replayed traffic, but they still need review at lifecycle boundaries.

Every secured Zigbee frame carries a monotonically increasing frame counter. A receiver rejects a secured frame when its counter is not greater than the last counter accepted from that sender. That mechanism defeats replay of captured frames. It also explains two operational realities: a device reset that zeroes its counter can cause neighbors to reject its frames until state is refreshed, and frame-counter rollover needs planned key action before the counter wraps.

If devices stop being accepted after a power cycle, suspect frame-counter state before assuming the keys are wrong. Anti-replay may be doing its job; the deployment may need a controlled rejoin, state refresh, or key update.

Review:

  • what happens after device reset or rejoin,
  • whether a replaced device inherits identity or starts as a new member,
  • whether coordinator restore changes remembered counter state,
  • whether stale gateway state can hide replay symptoms,
  • whether the application has a second check for high-impact commands, and
  • who retests after firmware, gateway, or Trust Center change.

Do not approve replay protection from a single normal message exchange. Approve only the behavior that was tested under the lifecycle condition being claimed.

16.10 Green Power and Constrained Device Boundaries

Some Zigbee deployments include constrained or energy-harvesting devices that use simplified security behavior. The review question is not whether those devices are “secure enough” in general. The question is whether their limits are acceptable for the specific action they trigger.

Green Power serves ultra-constrained, energy-harvesting devices, such as a battery-less light switch, that cannot run the full Zigbee stack. It uses a lighter security profile with a Green Power Device key, sequence-number and MIC protection, and nearby routers acting as proxies to relay its frames. That is a deliberate trade: battery-free operation comes with a different security profile from full network-key devices. Those endpoints need their own line in the security record instead of being treated as equivalent to ordinary Zigbee nodes.

Review:

  • whether the constrained device sends telemetry, control, or safety-relevant commands,
  • what key or credential is preloaded or provisioned,
  • how duplicate or replay-like behavior is handled,
  • whether nearby physical access changes the threat model,
  • how replacement or recommissioning is documented, and
  • whether the gateway labels constrained-device exceptions clearly.

Accept the exception only when the use case, command impact, physical context, and operations owner are recorded.

16.11 Security Review Record

Use a security record when approving join, key, or replay behavior.

Zigbee security review record showing claim, boundary, Trust Center owner, join evidence, key custody, traffic boundary, exception, decision, owner, and retest trigger.

Zigbee security review record showing claim, boundary, Trust Center owner, join evidence, key custody, traffic boundary, exception, decision, owner, and retest trigger.

The record should include:

  • Claim: security behavior being approved.
  • Boundary: site, gateway, Trust Center, device families, and application actions covered.
  • Join evidence: how expected devices are authorized and verified.
  • Key custody: who can store, restore, rotate, or recover key material.
  • Traffic boundary: whether mesh-layer protection is sufficient for the application action.
  • Replay evidence: lifecycle conditions tested, such as reset, rejoin, replacement, or restore.
  • Exception: constrained device, legacy join, gateway limitation, or monitoring gap.
  • Decision: accept, narrow, revise, reject, or retest.
  • Owner: person or team responsible for controls and monitoring.
  • Retest trigger: new device family, Trust Center replacement, gateway restore, firmware update, key exposure, policy change, or repeated unauthorized join attempt.

16.12 Worked Review: Controlled Device Join

Scenario: A site adds a group of new sensors. The gateway shows successful joins, but the record does not show whether the expected devices joined or whether the join window was closed afterward.

Review path:

  1. State the join boundary and expected device family.
  2. Check the authorization evidence used for each join.
  3. Confirm the gateway or Trust Center log shows expected identifiers.
  4. Confirm joining was closed or returned to the approved policy.
  5. Record any unknown join, missed log, or delayed closure as an exception.

Decision: Revise before approval when the record proves only that something joined. Approve only after expected-device evidence, join-policy closure, owner, and retest trigger are recorded.

16.13 Worked Review: Trust Center Replacement

Scenario: A coordinator or gateway is replaced after failure. Devices appear online, but operations cannot show whether key backup, membership state, and replay assumptions were preserved.

Review path:

  1. Separate availability evidence from security evidence.
  2. Confirm who restored coordinator or Trust Center configuration.
  3. Check key custody and backup handling.
  4. Retest representative joining, removal, protected traffic, and high-impact commands.
  5. Record any device family that needs rejoin, exclusion, key action, or application-level retest.

Decision: Do not approve the replacement from online status alone. Approve only the security behavior that was retested after restore.

16.14 Knowledge Check: Join Evidence

16.15 Matching Quiz: Security Evidence Family

16.16 Ordering Quiz: Security Review Sequence

16.17 Common Security Drift

Encryption-name drift: approving a deployment because it names AES or mesh-layer encryption.

Join-success drift: treating a successful join as proof that the expected device joined under the approved policy.

Trust Center drift: naming the coordinator without naming the owner, backup method, restore path, or replacement retest.

Key-backup drift: storing coordinator backup material without recording who can access or restore it.

Replay drift: testing only normal traffic while claiming behavior after reset, rejoin, replacement, or restore.

Application-boundary drift: assuming mesh-layer protection is sufficient for every command or application action.

Exception drift: accepting constrained-device or legacy behavior without a named boundary and owner.

16.18 Knowledge Check: Security Readiness

16.19 Security Evidence Checklist

Before accepting a Zigbee security claim, verify that the record answers these questions:

  • What exact security behavior is being approved?
  • Which site, gateway, Trust Center, device families, and application actions are in scope?
  • Who owns the Trust Center configuration and policy?
  • How are expected devices authorized before joining?
  • How is permit-join or equivalent joining policy bounded?
  • How is key material transported, stored, backed up, restored, and rotated or replaced?
  • What happens after device removal, reset, rejoin, gateway restore, or Trust Center replacement?
  • Which application actions need protection beyond normal mesh-layer evidence?
  • What exceptions remain for constrained, legacy, or high-impact devices?
  • Who owns monitoring, incident response, and retest?

16.20 Summary

Zigbee security review is an evidence problem. Trust Center custody, join approval, key transport, key storage, replay assumptions, application-security boundaries, exceptions, and operations ownership must be recorded before a deployment claim is accepted.

The safest review posture is bounded approval. Accept the behavior that has evidence, narrow the behavior that is only partly proven, and retest after Trust Center, gateway, key, firmware, device-family, or policy changes.

16.21 Key Takeaway

Approve Zigbee security only when Trust Center custody, join authorization, key transport and custody, replay lifecycle, exceptions, owner, and retest evidence support the exact behavior being released.

16.22 Concept Relationships

  • Trust Center and join policy: the Trust Center controls who can join, while the review record proves whether the approved join policy was followed.
  • Join evidence and key transport: a join is not approved until the credential or authorization path used for key delivery is recorded.
  • Network key and application boundary: mesh-layer protection can protect network traffic, but high-impact application actions may need additional evidence.
  • Frame counters and lifecycle events: replay assumptions need retest after reset, rejoin, replacement, restore, or firmware changes.
  • Backup and operations: coordinator recovery is useful only when backup access, restore behavior, and ownership are controlled.

16.23 What’s Next