1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
// @generated by tools/gen_management.py from management-registry.json and
// openapi.json. DO NOT EDIT -- your changes will be overwritten. Regenerate
// with `tools/gen_management.py`; CI verifies the committed output is current.
//! One handle per §27 namespace, and the accessors that reach them.
//!
//! §27.2 makes this namespacing normative rather than stylistic: twenty
//! namespaces have a `list` and fourteen a `get`, so flattening 147
//! operations onto the client would need a disambiguating prefix invented
//! once per operation -- and would bury the eight §1 methods most callers
//! actually want under five times as many they do not.
pub mod audit;
pub mod ca_certificates;
pub mod certificates;
pub mod directory;
pub mod email_config;
pub mod federation;
pub mod groups;
pub mod network;
pub mod notification_rules;
pub mod oauth2_clients;
pub mod organizations;
pub mod permissions;
pub mod pgp_keys;
pub mod platform;
pub mod privacy;
pub mod reactors;
pub mod resources;
pub mod roles;
pub mod saml;
pub mod scim_targets;
pub mod scim_tokens;
pub mod scopes;
pub mod service_accounts;
pub mod settings;
pub mod ssf;
pub mod tenants;
pub mod users;
pub mod webauthn_policy;
pub mod webhooks;
use crate::client::AxiamClient;
impl AxiamClient {
/// The `organizations` management namespace.
///
/// Organizations an SDK client may read and configure. Creation and deletion
/// are outside the SDK boundary (§27.0).
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn organizations(&self) -> organizations::Organizations<'_> {
organizations::Organizations::new(self)
}
/// The `tenants` management namespace.
///
/// Tenants within an organization -- the isolation boundary every other
/// namespace is scoped to.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn tenants(&self) -> tenants::Tenants<'_> {
tenants::Tenants::new(self)
}
/// The `users` management namespace.
///
/// Users within the client's tenant, and the administrative side of their
/// second factor and lockout state.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn users(&self) -> users::Users<'_> {
users::Users::new(self)
}
/// The `groups` management namespace.
///
/// Named collections of users. Roles assigned to a group are inherited by
/// every member.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn groups(&self) -> groups::Groups<'_> {
groups::Groups::new(self)
}
/// The `roles` management namespace.
///
/// Roles, their permission sets, and their assignment to users and groups.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn roles(&self) -> roles::Roles<'_> {
roles::Roles::new(self)
}
/// The `permissions` management namespace.
///
/// Permissions -- an action on a resource, optionally narrowed by a scope.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn permissions(&self) -> permissions::Permissions<'_> {
permissions::Permissions::new(self)
}
/// The `resources` management namespace.
///
/// The resource hierarchy role assignments cascade down.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn resources(&self) -> resources::Resources<'_> {
resources::Resources::new(self)
}
/// The `scopes` management namespace.
///
/// Sub-resource granularity, always addressed under their resource.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn scopes(&self) -> scopes::Scopes<'_> {
scopes::Scopes::new(self)
}
/// The `service_accounts` management namespace.
///
/// Machine identities, their secrets, and the certificate a device-bound one
/// authenticates with.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn service_accounts(&self) -> service_accounts::ServiceAccounts<'_> {
service_accounts::ServiceAccounts::new(self)
}
/// The `certificates` management namespace.
///
/// End-entity X.509 certificates -- the ones issued to users, services and
/// IoT devices.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn certificates(&self) -> certificates::Certificates<'_> {
certificates::Certificates::new(self)
}
/// The `ca_certificates` management namespace.
///
/// Organization CAs and the per-tenant signing CAs chained beneath them.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn ca_certificates(&self) -> ca_certificates::CaCertificates<'_> {
ca_certificates::CaCertificates::new(self)
}
/// The `pgp_keys` management namespace.
///
/// OpenPGP keys used for audit signing and encrypted data export.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn pgp_keys(&self) -> pgp_keys::PgpKeys<'_> {
pgp_keys::PgpKeys::new(self)
}
/// The `webhooks` management namespace.
///
/// Outbound event notifications. Delivery signatures are verified with the
/// §13 helper, which this namespace configures.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn webhooks(&self) -> webhooks::Webhooks<'_> {
webhooks::Webhooks::new(self)
}
/// The `oauth2_clients` management namespace.
///
/// Registered OAuth2/OIDC clients -- the registration half of what §12, §21
/// and §26 then speak to.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn oauth2_clients(&self) -> oauth2_clients::Oauth2Clients<'_> {
oauth2_clients::Oauth2Clients::new(self)
}
/// The `federation` management namespace.
///
/// Upstream IdP configuration and the per-user links it produces.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn federation(&self) -> federation::Federation<'_> {
federation::Federation::new(self)
}
/// The `notification_rules` management namespace.
///
/// Which events raise a notification, and to whom.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn notification_rules(&self) -> notification_rules::NotificationRules<'_> {
notification_rules::NotificationRules::new(self)
}
/// The `email_config` management namespace.
///
/// Transactional-mail transport, configurable at organization level and
/// overridable per tenant.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn email_config(&self) -> email_config::EmailConfig<'_> {
email_config::EmailConfig::new(self)
}
/// The `directory` management namespace.
///
/// A tenant's LDAP / Active Directory identity source (CONTRACT §30): the one
/// configuration, the explicit act that links an existing local account to
/// its directory entry, and a read-only view of the sync job. Signing in
/// needs nothing new -- a directory account calls the same §1 `login`.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn directory(&self) -> directory::Directory<'_> {
directory::Directory::new(self)
}
/// The `saml` management namespace.
///
/// A tenant's SAML 2.0 identity provider (CONTRACT §29): the registry of
/// service providers, the import of an SP's metadata into a *draft*
/// registration (never a write), and the lifecycle of the IdP signing
/// credential. The protocol itself -- single sign-on, single logout, the IdP
/// metadata document -- is browser and SP-to-IdP surface under
/// /saml/v2/{tenant_id}, an SP's own SAML library speaks to it, and it is not
/// in this registry.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn saml(&self) -> saml::Saml<'_> {
saml::Saml::new(self)
}
/// The `ssf` management namespace.
///
/// A tenant's Shared Signals Framework streams (CONTRACT §32): which receiver
/// -- an OAuth2 client of the tenant -- receives which CAEP and RISC security
/// events, as SETs pushed to its endpoint or polled. The receiver's own
/// protocol (transmitter metadata, the SSF stream management API, polling) is
/// not in this registry.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn ssf(&self) -> ssf::Ssf<'_> {
ssf::Ssf::new(self)
}
/// The `scim_targets` management namespace.
///
/// A tenant's outbound SCIM targets (CONTRACT §31): the downstream SCIM 2.0
/// service providers AXIAM pushes the tenant's users and groups to, each with
/// its delivery state. The credential AXIAM pushes with is write-only.
/// Deleting a target does not deprovision anything downstream.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn scim_targets(&self) -> scim_targets::ScimTargets<'_> {
scim_targets::ScimTargets::new(self)
}
/// The `network` management namespace.
///
/// A tenant's network segments and the RADIUS reply profile each owns (RADIUS
/// Live profile): a segment is a node of the reserved /network subtree of the
/// resource tree (kind, VLAN, Filter-Id envelope, placement rank), and its
/// profile is the typed `axiam-radius-reply/1` record a decision renders.
/// Every write is conditional on the `version` the caller read and passes the
/// server's write gate. The tenant's Session-Timeout cap is one more row of
/// it (get_policy, replace_policy): lowering it is always allowed, raising it
/// is allowed and audited. The decision route FreeRADIUS calls is not in this
/// registry.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn network(&self) -> network::Network<'_> {
network::Network::new(self)
}
/// The `settings` management namespace.
///
/// Effective settings, and the organization/tenant layers they resolve from.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn settings(&self) -> settings::Settings<'_> {
settings::Settings::new(self)
}
/// The `scim_tokens` management namespace.
///
/// Bearer tokens for the SCIM 2.0 provisioning endpoint.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn scim_tokens(&self) -> scim_tokens::ScimTokens<'_> {
scim_tokens::ScimTokens::new(self)
}
/// The `reactors` management namespace.
///
/// Registration of §22 AMQP extension actors -- the admin surface §22.9
/// describes, which no SDK could previously reach.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn reactors(&self) -> reactors::Reactors<'_> {
reactors::Reactors::new(self)
}
/// The `webauthn_policy` management namespace.
///
/// Per-tenant attestation policy governing the §24 ceremonies, and the
/// compliance report over it.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn webauthn_policy(&self) -> webauthn_policy::WebauthnPolicy<'_> {
webauthn_policy::WebauthnPolicy::new(self)
}
/// The `audit` management namespace.
///
/// Append-only audit log, read-only by construction.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn audit(&self) -> audit::Audit<'_> {
audit::Audit::new(self)
}
/// The `privacy` management namespace.
///
/// GDPR self-service: the authenticated account's own export and erasure.
/// Scoped to the caller, never to another user.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn privacy(&self) -> privacy::Privacy<'_> {
privacy::Privacy::new(self)
}
/// The `platform` management namespace.
///
/// Deployment-level probes and FIDO metadata state. Unauthenticated where the
/// server leaves them so.
///
/// Acquiring the handle performs no I/O (§27.2 rule 1).
#[must_use]
pub fn platform(&self) -> platform::Platform<'_> {
platform::Platform::new(self)
}
}