# netbox-proxbox v0.0.29.post1

v0.0.29.post1

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/netbox-proxbox/releases/v0.0.29.post1 |
| GitHub URL | https://github.com/emersonfelipesp/netbox-proxbox/releases/tag/v0.0.29.post1 |
| Tag | v0.0.29.post1 |
| State | stable |
| Author | emersonfelipesp |
| Created | 2026-10-08 18:12 UTC |
| Published | 2026-10-08 18:34 UTC |
| Target | main |
| Synced | 2026-10-13 00:08 UTC |
| Assets | 0 |

## Release notes

# Version 0.0.29.post1

## Summary

This maintenance release adds an explicit connection-target approval recovery
panel to NetBox and Proxmox endpoint detail pages. It also restores optional
netbox-openbao operation and corrects credential-storage settings rendering.

## Release identity

The package and plugin source both identify this maintenance release as
`0.0.29.post1`.

## Recover endpoint connections after upgrading

Version `0.0.29` introduced an approval requirement before endpoint credentials
can be sent. Existing endpoints retain their transport configuration but do not
receive an automatic approval. Consequently, a healthy FastAPI connection can
coexist with a Proxmox keepalive error when the Proxmox target is unapproved.

1. Open the affected Proxmox endpoint detail page in NetBox.
2. Select **Review again** in the connection approval panel.
3. Verify the displayed target address, port, TLS setting, and credential identity.
4. Select **Approve reviewed target** only if those values identify the intended
   destination, then retry the connection check or synchronization.
5. Repeat this review for a NetBox endpoint when its connection target also
   requires approval.

Approval requires the existing sensitive-data authorization and applicable
endpoint view and change permissions. Disabled endpoints cannot be approved.
Editing a connection target invalidates its previous approval. A failed or timed
out request requires a fresh review; it is never displayed as a successful
approval. No credential secret is returned by the review panel, and no target
is approved automatically.

## Credential storage without netbox-openbao

Automatic credential storage uses local Fernet encryption when the optional
netbox-openbao companion is unavailable. The Settings page now displays the
credential storage backend, OpenBao policy slug, and service username. Selecting
OpenBao explicitly while the companion is disabled produces a field error.

An endpoint without OpenBao credential references can be deleted without the
companion. Existing OpenBao references remain protected: deletion and changes
away from OpenBao are refused until those credentials are cleaned up through
the supported path.

## Credential recovery and optional companions

Verified Fernet rotation and selective reset can update the encrypted columns
of single-secret owners again. The recovery path requires the existing exact
model, database alias, field, and ciphertext permit. Ordinary encrypted-field
writes and OpenBao reference changes remain refused.

The home page renders PDM tables only when the PDM plugin is enabled in NetBox.
Proxmox endpoint serialization likewise queries RPC settings only when the RPC
plugin is enabled. An installed but disabled companion no longer causes a
missing-route or unmigrated-table failure. FastAPI list responses also reuse
credential assignment metadata within one response while retaining each
owner's assignment checks.

Bounded request timeouts retain their existing per-request deadline calculations.

Proxmox endpoint API responses derive local SSH readiness from encrypted-field
presence. OpenBao readiness additionally requires an authenticated caller,
matching credential metadata, reveal permission, and the applicable policy group
membership. Missing, deleted, inaccessible, or mismatched references fail closed.
These fields do not resolve secret material. Each response batches the required
credential metadata checks and reads the required global storage and RPC settings
once, while preserving endpoint overrides, optional companion gates, and
operational credential authorization.

Native compatibility coverage retains separate NetBox 4.5.8, 4.5.10, 4.6.0,
4.6.6, and 4.7.0 GA profiles, plus the supported PDM, all-companion, and
OpenBao/RPC configurations. The table prefetch test uses the shared API, PBS
rotation fixtures cover the real companion field family and dormant state, and
OpenBao fixtures preserve explicit storage, request identity, enabled endpoint,
and historical migration contracts.

## Upgrade and migration

Run the standard NetBox plugin migration procedure after installing this version.
This release introduces exactly one migration,
`0105_reset_implicit_openbao_storage_default`, after
`0104_security_hardening`. It changes an implicit plugin-wide OpenBao default
to Automatic only when no credential owner has an OpenBao reference. It
preserves explicit endpoint overrides and installations containing such
references. Reversing this data migration does not restore an implicit OpenBao
default.

SSH password reuse also forwards the requesting user's identity to OpenBao
material resolution. Enabled endpoints therefore reach the intended credential
availability checks instead of failing on an unsupported resolver argument.
Disabled endpoints still refuse credential disclosure before any provider read.

The connection approval panel adds no database fields and does not backfill
approval or sensitive-data grants. Existing plain-HTTP configurations retain
their stored transport choices; an approval requirement is independent of the
FastAPI transport choice.

## Compatibility baseline

The support contract remains NetBox `4.5.8` through `4.7.0` GA. This maintenance
source retains the preceding backend pairing.

Current backend-runtime pairing: netbox-proxbox 0.0.29.post1 <-> proxbox-api 0.0.23.post3 <-> proxmox-sdk 0.0.15 <-> netbox-sdk 0.0.13. This netbox-sdk version is proxbox-api's REST dependency only and does not provide the semantic MCP bridge.

| NetBox | netbox-proxbox | proxbox-api | netbox-sdk | proxmox-sdk |
|---|---|---|---|---|
| 4.5.8-4.7.0 GA | v0.0.29.post1 | v0.0.23.post3 | v0.0.13 | v0.0.15 |

## Installation

Install the maintenance release in the same Python environment as NetBox:

```sh
pip install --upgrade netbox-proxbox==0.0.29.post1
```

Run the standard NetBox plugin migrations and collect static assets, then restart the NetBox services. Container installations should rebuild their image with the pinned plugin version before following their normal migration and restart procedure.

## Validation

The release source passed the complete mocked regression suite and native NetBox 4.7.0 GA endpoint-approval and credential-storage tests. Strict documentation, distribution inventory, console asset, migration state, security boundary, and independent source review checks passed. Approval remains an explicit operator action after upgrading.

Source-install Docker end-to-end checks passed on NetBox 4.5.8, 4.5.9, 4.5.10, 4.6.0, 4.6.1, 4.6.2, 4.6.3, 4.6.4, 4.6.5, 4.6.6, and 4.7.0 GA. A separate check on NetBox 4.6.8-Docker 5.0.2 with proxbox-api 0.0.25 also passed and returned successful authentication and API access for the backend, NetBox, and Proxmox endpoints. This additional runtime check does not reproduce the original Helm chart deployment topology.

## Assets

No binary assets attached.

Source archives:

| Format |URL |
| --- | --- |
| zip | https://api.github.com/repos/emersonfelipesp/netbox-proxbox/zipball/v0.0.29.post1 |
| tar.gz | https://api.github.com/repos/emersonfelipesp/netbox-proxbox/tarball/v0.0.29.post1 |