Nullplatform Resource Name (NRN)
An NRN is a hierarchical string that uniquely identifies any entity in nullplatform — similar to Amazon ARNs. NRNs encode an entity's position in the organizational hierarchy and appear throughout the platform in authorization grants, notification filters, provider configurations, and API responses.
Format
organization=1:account=2:namespace=3:application=4:scope=5
Each segment represents a level in the hierarchy:
| Level | Example | Description |
|---|---|---|
| Organization | organization=1 | Top-level tenant |
| Account | organization=1:account=2 | Business unit or team |
| Namespace | organization=1:account=2:namespace=3 | Logical grouping of applications |
| Application | …:namespace=3:application=4 | A single deployable application |
| Scope | …:application=4:scope=5 | A deployment target (environment) |
You can use a partial NRN to reference any level. For example, organization=1:account=2 targets the account and everything beneath it.
Where NRNs appear
- Authorization grants — scope permissions to specific levels in the hierarchy.
- Notification filters — route events from specific resources.
- Provider configurations — bind providers at any hierarchy level, with inheritance downward.
- Parameters — attach configuration at any level; child entities inherit parent values.
- Banners — target announcements to specific resources using NRNs.
- API responses — most entities include an
nrnfield showing their position.
NRN API (deprecated)
The NRN API (/nrn/:id) is a legacy hierarchical configuration store that may be removed in the future. Use Providers for infrastructure configuration and Parameters for application runtime settings.
The NRN API stored key-value configuration data keyed by NRN strings, with hierarchical merging and profile-based overrides. See the NRN API reference for details.