Managing Partner Control Boundary

A managing partner helps an operator become and stay operational: hosting, DNS, onboarding, runbooks, trust bundle packaging and client coordination. Connectorzzz is the intended example. This page is the boundary between what the partner may do and what stays with the operator. RFC-008 defines the role; this page is the operational checklist.

The boundary

Action

Operator

Managing partner

Hold the root key

yes

never

Hold operator (admin) keys that approve trust changes

yes

never

Hold the NA signing key

yes (recommended)

only with the operator’s written approval (“managed NA key” model), never as the default

Issue, revoke, suspend or replace treaties

yes

no

Issue and revoke membership attestations

yes

no

Publish the revocation feed

yes

no

Publish and activate boundary policies

yes

no

Run the NA process, database and backups

optional

yes, on request

Manage endpoints and DNS

optional

yes, on request

Assemble trust bundles and proof bundles

yes

yes (assist)

Run continuity checks and runbooks (RFC-007)

yes

yes (assist)

Fork, exit, or switch partner

yes

cannot block

How the software enforces it

  • Admin actions need an operator key. Every trust-changing route (treaties, attestations, revocations, policies, feed imports) requires a signed admin request from a configured operator key. Keys have tiers; issuing and revoking need a privileged key.

  • Operator keys can be revoked at runtime (genesis-mesh admin revoke-operator-key); a revoked key is refused before its signature is checked. An operator can remove a partner’s access without the partner’s cooperation.

  • Every admin action is audited with the key id that signed it (genesis-mesh managed audit-export), so the operator can see what the partner did.

  • No built-in authority. The software has no Genesis Core or partner key baked in (genesis_mesh/tests/test_operator_independence.py).

What the software cannot enforce

  • If a partner runs the NA process and its database, it can technically read the database and the process memory. The split-operation custody model (the partner runs the service; the operator holds the operator keys and approves every treaty and revocation) keeps trust decisions with the operator, but the operator must still trust the partner’s operation of the host. A deployment where the operator also runs the host removes that.

  • If a partner holds the NA signing key, it can sign anything the NA can sign. See Operator Exit and Fork for why that key must then be treated as exposed when the relationship ends.

Pilot checklist

  • Root and operator keys generated by the operator, on the operator’s machines; the partner never received them.

  • Partner access, if any, is a separate operator key with the lowest tier that its tasks need, and the operator knows how to revoke it.

  • The NA signing key is in a key store the operator owns (for example the operator’s own Azure Key Vault with managed identity), or the operator approved the managed-key model in writing.

  • The operator has a current database backup and evidence export it can restore without the partner.

  • The operator has rehearsed Operator Exit and Fork.