ManagementApi
in package
The CONTRACT.md §27 management surface: 147 operations across 24 namespaces.
Reached as $client->management(). This class holds nothing but the shared ManagementTransport and the client's default scope; each accessor below hands back a
namespace handle (§27.2) that can be re-scoped per call with ->inOrg() / ->forTenant()
(§27.4 rule 3).
Handles are constructed on demand rather than cached. §27.4 rule 10 forbids caching
RESPONSES, not handles — but a handle is two references and a scope, and building one per
call keeps ->inOrg() from having anything shared to mutate.
Table of Contents
Methods
- __construct() : mixed
- Wires the management surface onto the client's existing request path.
- audit() : AuditApi
- Append-only audit log, read-only by construction.
- caCertificates() : CaCertificatesApi
- Organization CAs and the per-tenant signing CAs chained beneath them.
- certificates() : CertificatesApi
- End-entity X.509 certificates -- the ones issued to users, services and IoT devices.
- emailConfig() : EmailConfigApi
- Transactional-mail transport, configurable at organization level and overridable per tenant.
- federation() : FederationApi
- Upstream IdP configuration and the per-user links it produces.
- groups() : GroupsApi
- Named collections of users. Roles assigned to a group are inherited by every member.
- manifest() : ManifestApi
- The §27.6 declarative layer: plan and apply a manifest.
- notificationRules() : NotificationRulesApi
- Which events raise a notification, and to whom.
- oauth2Clients() : Oauth2ClientsApi
- Registered OAuth2/OIDC clients -- the registration half of what §12, §21 and §26 then speak to.
- organizations() : OrganizationsApi
- Organizations an SDK client may read and configure. Creation and deletion are outside the SDK boundary (§27.0).
- permissions() : PermissionsApi
- Permissions -- an action on a resource, optionally narrowed by a scope.
- pgpKeys() : PgpKeysApi
- OpenPGP keys used for audit signing and encrypted data export.
- platform() : PlatformApi
- Deployment-level probes and FIDO metadata state. Unauthenticated where the server leaves them so.
- privacy() : PrivacyApi
- GDPR self-service: the authenticated account's own export and erasure. Scoped to the caller, never to another user.
- reactors() : ReactorsApi
- Registration of §22 AMQP extension actors -- the admin surface §22.9 describes, which no SDK could previously reach.
- resources() : ResourcesApi
- The resource hierarchy role assignments cascade down.
- roles() : RolesApi
- Roles, their permission sets, and their assignment to users and groups.
- scimTokens() : ScimTokensApi
- Bearer tokens for the SCIM 2.0 provisioning endpoint.
- scopes() : ScopesApi
- Sub-resource granularity, always addressed under their resource.
- serviceAccounts() : ServiceAccountsApi
- Machine identities, their secrets, and the certificate a device-bound one authenticates with.
- settings() : SettingsApi
- Effective settings, and the organization/tenant layers they resolve from.
- tenants() : TenantsApi
- Tenants within an organization -- the isolation boundary every other namespace is scoped to.
- users() : UsersApi
- Users within the client's tenant, and the administrative side of their second factor and lockout state.
- webauthnPolicy() : WebauthnPolicyApi
- Per-tenant attestation policy governing the §24 ceremonies, and the compliance report over it.
- webhooks() : WebhooksApi
- Outbound event notifications. Delivery signatures are verified with the §13 helper, which this namespace configures.
Methods
__construct()
Wires the management surface onto the client's existing request path.
public
__construct(ManagementTransport $transport[, string|null $orgId = null ][, string|null $tenantId = null ]) : mixed
Parameters
- $transport : ManagementTransport
-
The one §27.8 wire path.
- $orgId : string|null = null
-
The client's organization id, or
nullif unset. - $tenantId : string|null = null
-
The client's tenant id, or
nullif unset.
audit()
Append-only audit log, read-only by construction.
public
audit() : AuditApi
Return values
AuditApicaCertificates()
Organization CAs and the per-tenant signing CAs chained beneath them.
public
caCertificates() : CaCertificatesApi
Return values
CaCertificatesApicertificates()
End-entity X.509 certificates -- the ones issued to users, services and IoT devices.
public
certificates() : CertificatesApi
Return values
CertificatesApiemailConfig()
Transactional-mail transport, configurable at organization level and overridable per tenant.
public
emailConfig() : EmailConfigApi
Return values
EmailConfigApifederation()
Upstream IdP configuration and the per-user links it produces.
public
federation() : FederationApi
Return values
FederationApigroups()
Named collections of users. Roles assigned to a group are inherited by every member.
public
groups() : GroupsApi
Return values
GroupsApimanifest()
The §27.6 declarative layer: plan and apply a manifest.
public
manifest() : ManifestApi
plan() writes nothing; apply() performs the plan, stops at the first failure and
does not roll back (§27.7). Hand-written rather than generated — the manifest layer is a
convergence loop over the operations below, not an endpoint the registry describes.
Return values
ManifestApinotificationRules()
Which events raise a notification, and to whom.
public
notificationRules() : NotificationRulesApi
Return values
NotificationRulesApioauth2Clients()
Registered OAuth2/OIDC clients -- the registration half of what §12, §21 and §26 then speak to.
public
oauth2Clients() : Oauth2ClientsApi
Return values
Oauth2ClientsApiorganizations()
Organizations an SDK client may read and configure. Creation and deletion are outside the SDK boundary (§27.0).
public
organizations() : OrganizationsApi
Return values
OrganizationsApipermissions()
Permissions -- an action on a resource, optionally narrowed by a scope.
public
permissions() : PermissionsApi
Return values
PermissionsApipgpKeys()
OpenPGP keys used for audit signing and encrypted data export.
public
pgpKeys() : PgpKeysApi
Return values
PgpKeysApiplatform()
Deployment-level probes and FIDO metadata state. Unauthenticated where the server leaves them so.
public
platform() : PlatformApi
Return values
PlatformApiprivacy()
GDPR self-service: the authenticated account's own export and erasure. Scoped to the caller, never to another user.
public
privacy() : PrivacyApi
Return values
PrivacyApireactors()
Registration of §22 AMQP extension actors -- the admin surface §22.9 describes, which no SDK could previously reach.
public
reactors() : ReactorsApi
Return values
ReactorsApiresources()
The resource hierarchy role assignments cascade down.
public
resources() : ResourcesApi
Return values
ResourcesApiroles()
Roles, their permission sets, and their assignment to users and groups.
public
roles() : RolesApi
Return values
RolesApiscimTokens()
Bearer tokens for the SCIM 2.0 provisioning endpoint.
public
scimTokens() : ScimTokensApi
Return values
ScimTokensApiscopes()
Sub-resource granularity, always addressed under their resource.
public
scopes() : ScopesApi
Return values
ScopesApiserviceAccounts()
Machine identities, their secrets, and the certificate a device-bound one authenticates with.
public
serviceAccounts() : ServiceAccountsApi
Return values
ServiceAccountsApisettings()
Effective settings, and the organization/tenant layers they resolve from.
public
settings() : SettingsApi
Return values
SettingsApitenants()
Tenants within an organization -- the isolation boundary every other namespace is scoped to.
public
tenants() : TenantsApi
Return values
TenantsApiusers()
Users within the client's tenant, and the administrative side of their second factor and lockout state.
public
users() : UsersApi
Return values
UsersApiwebauthnPolicy()
Per-tenant attestation policy governing the §24 ceremonies, and the compliance report over it.
public
webauthnPolicy() : WebauthnPolicyApi
Return values
WebauthnPolicyApiwebhooks()
Outbound event notifications. Delivery signatures are verified with the §13 helper, which this namespace configures.
public
webhooks() : WebhooksApi