From 1b1a6caa62b14130775582e58b69d088d9c40d6f Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Wed, 13 May 2026 18:08:35 +0000 Subject: [PATCH 1/5] Update README Release Information for r2.1 --- README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 30cadd7..13ae2a9 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,16 @@ Sandbox API Repository to describe, develop, document, and test the NetworkAcces ## Release Information -The repository has no (pre)releases yet, work in progress is within the main branch. +> [!NOTE] +> This repository has only pre-release versions available yet. Pre-releases are for testing and may change before public release. + +* The latest pre-release is [r2.1](https://github.com/camaraproject/NetworkAccessManagement/releases/tag/r2.1) (alpha), with the following API versions: + * **network-access-management 0.2.0-alpha.1** + [[YAML]](https://github.com/camaraproject/NetworkAccessManagement/blob/r2.1/code/API_definitions/network-access-management.yaml) [[ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/NetworkAccessManagement/r2.1/code/API_definitions/network-access-management.yaml&nocors) [[Swagger]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/NetworkAccessManagement/r2.1/code/API_definitions/network-access-management.yaml) + +* For changes see [CHANGELOG](https://github.com/camaraproject/NetworkAccessManagement/tree/main/CHANGELOG) + +_The above section is automatically synchronized by CAMARA project-administration._ ## Contributing From 6c721b3601eaf7f4ce20addd54c9ee69a55fd4f7 Mon Sep 17 00:00:00 2001 From: "camara-release-automation[bot]" <261643975+camara-release-automation[bot]@users.noreply.github.com> Date: Wed, 13 May 2026 18:08:37 +0000 Subject: [PATCH 2/5] Add CHANGELOG draft for r2.1 --- CHANGELOG/CHANGELOG-r2.md | 120 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 120 insertions(+) create mode 100644 CHANGELOG/CHANGELOG-r2.md diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md new file mode 100644 index 0000000..c6be716 --- /dev/null +++ b/CHANGELOG/CHANGELOG-r2.md @@ -0,0 +1,120 @@ +# Changelog NetworkAccessManagement + + +## Table of Contents +- [r2.1](#r21) + + +**Please be aware that the project will have frequent updates to the main branch. There are no compatibility guarantees associated with code in any branch, including main, until it has been released. For example, changes may be reverted before a release is published. For the best results, use the latest published release.** + +The below sections record the changes for each API version in each release as follows: + +* for an alpha release, the delta with respect to the previous release +* for the first release-candidate, all changes since the last public release +* for subsequent release-candidate(s), only the delta to the previous release-candidate +* for a public release, the consolidated changes since the previous public release + +# r2.1 + +## Release Notes + +This pre-release contains the definition and documentation of +* network-access-management 0.2.0-alpha.1 + +The API definition(s) are based on +* Commonalities 0.8.0-rc.2 +* Identity and Consent Management 0.5.0 + + +> **Working area — candidate changes (auto-removed on merge)** +> Copy relevant entries into the Added/Changed/Fixed/Removed sections below. +> You may edit this list while triaging; it will be removed on merge. +> This working-area section is removed automatically when the PR is merged. + +
+Candidate changes (auto-generated from merged PRs) + +## What's Changed +* Update README.md by @wrathwolf in https://github.com/camaraproject/NetworkAccessManagement/pull/1 +* fix: removes trailing substitution marker from mailing list contact by @caubut-charter in https://github.com/camaraproject/NetworkAccessManagement/pull/3 +* Add linting for OpenAPI and Camara guidelines by @RandyLevensalor in https://github.com/camaraproject/NetworkAccessManagement/pull/5 +* Change Sub Project name in Readme by @MarkusKuemmerle in https://github.com/camaraproject/NetworkAccessManagement/pull/6 +* Adding config files for spectral and yamllint by @RandyLevensalor in https://github.com/camaraproject/NetworkAccessManagement/pull/9 +* Moving the linting fixes from init to new PR by @RandyLevensalor in https://github.com/camaraproject/NetworkAccessManagement/pull/11 +* chore: adds initial proposal from the backlog working group by @caubut-charter in https://github.com/camaraproject/NetworkAccessManagement/pull/7 +* Add benhepworth as maintainer so he can review PRs by @benhepworth in https://github.com/camaraproject/NetworkAccessManagement/pull/23 +* Update README.md with meeting info by @wrathwolf in https://github.com/camaraproject/NetworkAccessManagement/pull/24 +* Updating mandatory ICM text by @RandyLevensalor in https://github.com/camaraproject/NetworkAccessManagement/pull/21 +* fix: standardize errors to track with commonalities by @caubut-charter in https://github.com/camaraproject/NetworkAccessManagement/pull/30 +* fix: updates commonalities, icm, and version by @caubut-charter in https://github.com/camaraproject/NetworkAccessManagement/pull/32 +* Update Meeting Minutes Link to new location by @benhepworth in https://github.com/camaraproject/NetworkAccessManagement/pull/41 +* Update README.md - alignment with current template by @hdamker in https://github.com/camaraproject/NetworkAccessManagement/pull/45 +* chore: migrate swagger editor links to CAMARA swagger-ui by @hdamker-bot in https://github.com/camaraproject/NetworkAccessManagement/pull/50 +* admin: add line 13 (API description for marketing) to API readiness checklists by @hdamker-bot in https://github.com/camaraproject/NetworkAccessManagement/pull/51 +* Add Cody as Maintainer. Swap out Randy for Cody as Owner. by @benhepworth in https://github.com/camaraproject/NetworkAccessManagement/pull/54 +* Create user story docs for Isolated Networks and Device Reboot Requests by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/55 +* 38 operator device capability discovery by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/49 +* feat: adds deviceStatus field to Device model by @caubut-charter in https://github.com/camaraproject/NetworkAccessManagement/pull/56 +* feat: adds the ability to provision a Thread network by @caubut-charter in https://github.com/camaraproject/NetworkAccessManagement/pull/64 +* Add section on additional CAMARA error responses by @benhepworth in https://github.com/camaraproject/NetworkAccessManagement/pull/68 +* Update Commonalities to 0.6 by @benhepworth in https://github.com/camaraproject/NetworkAccessManagement/pull/69 +* Remove IDENTIFIER_MISMATCH from 422 error by @benhepworth in https://github.com/camaraproject/NetworkAccessManagement/pull/67 +* Remove 401 AUTHENTICATION_REQUIRED as per commonalities by @benhepworth in https://github.com/camaraproject/NetworkAccessManagement/pull/66 +* fix: aligns base Device type with commonalities by @caubut-charter in https://github.com/camaraproject/NetworkAccessManagement/pull/70 +* admin: migrate to centralized linting workflows by @hdamker-bot in https://github.com/camaraproject/NetworkAccessManagement/pull/83 +* Reset versions in yaml files to 'wip' by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/98 +* Reconcile release candidate scope with main by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/107 +* [bulk] Sync Release Information section (2026-02-19-001) by @hdamker-bot in https://github.com/camaraproject/NetworkAccessManagement/pull/111 +* Update API Repository wiki page link in README by @hdamker in https://github.com/camaraproject/NetworkAccessManagement/pull/112 +* [bulk] Add release-plan.yaml (2026-02-23-001) by @hdamker-bot in https://github.com/camaraproject/NetworkAccessManagement/pull/113 +* 115 refactor per commonalities 577 by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/117 +* 110 add zto device registration by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/118 +* docs(maintainers): removes stale maintainer by @caubut-charter in https://github.com/camaraproject/NetworkAccessManagement/pull/119 +* Move common/ and modules/ up one level under code/ by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/121 +* [bulk] Enable release automation and validation by @camara-release-automation[bot] in https://github.com/camaraproject/NetworkAccessManagement/pull/125 +* 52 create gherkin feature file by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/120 +* Plan release r2.1 with API network-access-management alpha 0.2.0 by @hdamker in https://github.com/camaraproject/NetworkAccessManagement/pull/126 +* Sync common files from Commonalities r4.2 by @camara-release-automation[bot] in https://github.com/camaraproject/NetworkAccessManagement/pull/131 +* Feat/wkso bootstrapping by @clundie-CL in https://github.com/camaraproject/NetworkAccessManagement/pull/122 +* fix: pin validation caller to tooling S-037 hotfix SHA by @hdamker in https://github.com/camaraproject/NetworkAccessManagement/pull/138 + +## New Contributors +* @wrathwolf made their first contribution in https://github.com/camaraproject/NetworkAccessManagement/pull/1 +* @caubut-charter made their first contribution in https://github.com/camaraproject/NetworkAccessManagement/pull/3 +* @RandyLevensalor made their first contribution in https://github.com/camaraproject/NetworkAccessManagement/pull/5 +* @MarkusKuemmerle made their first contribution in https://github.com/camaraproject/NetworkAccessManagement/pull/6 +* @benhepworth made their first contribution in https://github.com/camaraproject/NetworkAccessManagement/pull/23 +* @hdamker made their first contribution in https://github.com/camaraproject/NetworkAccessManagement/pull/45 +* @hdamker-bot made their first contribution in https://github.com/camaraproject/NetworkAccessManagement/pull/50 +* @camara-release-automation[bot] made their first contribution in https://github.com/camaraproject/NetworkAccessManagement/pull/125 + +
+ + +## network-access-management 0.2.0-alpha.1 + +**network-access-management 0.2.0-alpha.1 is ...** + +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/NetworkAccessManagement/r2.1/code/API_definitions/network-access-management.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/NetworkAccessManagement/r2.1/code/API_definitions/network-access-management.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/NetworkAccessManagement/blob/r2.1/code/API_definitions/network-access-management.yaml) + +### Added + +* _To be filled during release review_ + +### Changed + +* _To be filled during release review_ + +### Fixed + +* _To be filled during release review_ + +### Removed + +* _To be filled during release review_ + +**Full Changelog**: https://github.com/camaraproject/NetworkAccessManagement/commits/r2.1 + From 000914397e63d7e5e0e50a017bd50cbcb5b43273 Mon Sep 17 00:00:00 2001 From: Cody Lundie Date: Wed, 13 May 2026 17:15:45 -0400 Subject: [PATCH 3/5] Update changelog for network-access-management 0.2.0-alpha.1 Added detailed information about the initial release of the Network Access Management API, including features, CRUD operations, and documentation links. --- CHANGELOG/CHANGELOG-r2.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md index c6be716..5eb5415 100644 --- a/CHANGELOG/CHANGELOG-r2.md +++ b/CHANGELOG/CHANGELOG-r2.md @@ -93,7 +93,7 @@ The API definition(s) are based on ## network-access-management 0.2.0-alpha.1 -**network-access-management 0.2.0-alpha.1 is ...** +**network-access-management 0.2.0-alpha.1 is** the first consumable alpha of NAM, providing Trust Domain management, Zero-Touch Onboarding for subscriber devices, and reboot-request operations on operator-supplied network access devices. - API definition **with inline documentation**: - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/NetworkAccessManagement/r2.1/code/API_definitions/network-access-management.yaml&nocors) @@ -102,19 +102,26 @@ The API definition(s) are based on ### Added -* _To be filled during release review_ +* Initial Network Access Management API surface: + - **Trust Domains** — CRUD operations for declarative LAN-scoped network configurations, with policy-driven control over device admission, bandwidth, and egress. Capability discovery endpoint (`GET /trust-domains/capabilities`) exposes operator-supported configurations. Wi-Fi (WPA Personal/Enterprise) and Thread (Structured/TLV) access types supported. + - **Trust Domain Devices** — CRUD operations for registering subscriber and IoT devices into Trust Domains with Zero-Touch Onboarding via DPP, Matter, and Well-Known SSID Onboarding (WKSO) bootstrapping protocols (#118, #122). + - **Reboot Requests** — CRUD operations for immediate or scheduled reboot of operator-supplied network access devices. + - **Services** — read-only enumeration of subscriber service instances (`GET /services`, `GET /services/{serviceId}`). + - **Network Access Devices** — read-only enumeration of operator-supplied network access equipment (`GET /network-access-devices`, `GET /network-access-devices/{networkAccessDeviceId}`). +* Basic-tier Gherkin test definitions covering sunny-day scenarios for every operation (#120). +* Local cache of `CAMARA_common.yaml` and a project-local `modules/` directory under `code/`, aligned with the Commonalities Consumption-and-Bundling Design (#117, #121). ### Changed -* _To be filled during release review_ +* Dependency on Commonalities updated to r4.2 (0.8.0-rc.2); ICM dependency updated to r4.2 (#126, #131). ### Fixed -* _To be filled during release review_ +_none_ ### Removed -* _To be filled during release review_ +_none_ **Full Changelog**: https://github.com/camaraproject/NetworkAccessManagement/commits/r2.1 From a6bf1aa7e56dabda9b0e92cd526a9c54f9aaa22a Mon Sep 17 00:00:00 2001 From: Cody Lundie Date: Thu, 28 May 2026 09:53:05 -0400 Subject: [PATCH 4/5] Remove CHANGELOG item referencing CODEOWNER information Removed a CHANGELOG item that referred to a feature that supports ingesting Commonalities artifacts, which is not an API Consumer concern. --- CHANGELOG/CHANGELOG-r2.md | 1 - 1 file changed, 1 deletion(-) diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md index 5eb5415..b6e14c0 100644 --- a/CHANGELOG/CHANGELOG-r2.md +++ b/CHANGELOG/CHANGELOG-r2.md @@ -109,7 +109,6 @@ The API definition(s) are based on - **Services** — read-only enumeration of subscriber service instances (`GET /services`, `GET /services/{serviceId}`). - **Network Access Devices** — read-only enumeration of operator-supplied network access equipment (`GET /network-access-devices`, `GET /network-access-devices/{networkAccessDeviceId}`). * Basic-tier Gherkin test definitions covering sunny-day scenarios for every operation (#120). -* Local cache of `CAMARA_common.yaml` and a project-local `modules/` directory under `code/`, aligned with the Commonalities Consumption-and-Bundling Design (#117, #121). ### Changed From fd98f276b2e1995603337e599ab2c3b73eb99cf1 Mon Sep 17 00:00:00 2001 From: Cody Lundie Date: Thu, 28 May 2026 09:53:30 -0400 Subject: [PATCH 5/5] Apply suggestions from code review Co-authored-by: Tanja de Groot <87864067+tanjadegroot@users.noreply.github.com> --- CHANGELOG/CHANGELOG-r2.md | 2 +- README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CHANGELOG/CHANGELOG-r2.md b/CHANGELOG/CHANGELOG-r2.md index b6e14c0..8479fac 100644 --- a/CHANGELOG/CHANGELOG-r2.md +++ b/CHANGELOG/CHANGELOG-r2.md @@ -93,7 +93,7 @@ The API definition(s) are based on ## network-access-management 0.2.0-alpha.1 -**network-access-management 0.2.0-alpha.1 is** the first consumable alpha of NAM, providing Trust Domain management, Zero-Touch Onboarding for subscriber devices, and reboot-request operations on operator-supplied network access devices. +**network-access-management 0.2.0-alpha.1 is** the first consumable alpha of this API, providing Trust Domain management, Zero-Touch Onboarding for subscriber devices, and reboot-request operations on operator-supplied network access devices. - API definition **with inline documentation**: - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/NetworkAccessManagement/r2.1/code/API_definitions/network-access-management.yaml&nocors) diff --git a/README.md b/README.md index 13ae2a9..f3f58f5 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ Sandbox API Repository to describe, develop, document, and test the NetworkAcces ## Scope * Service APIs for “Network Access Management” of Home Devices (see APIBacklog.md) -* It provides the customer with the ability to: +* It provides the API consumer with the ability to: * manage fixed devices provided by network operators that reside at customer premises. * Describe, develop, document, and test the APIs (with 1-2 Telcos) * Started: May 2024