Freeipa/group
@shrug/freeipa/groupv2026.07.11.1
01README
Manage FreeIPA user & host groups over the JSON-RPC API: snapshot the inventory, ensure the FreeRADIUS radius-vlan- group pair, and add/remove members — idempotent and auditable.
02Models
@shrug/freeipa/groupv2026.07.11.1group.ts
fn groupFind()
Snapshot user groups (group_find) and host groups (hostgroup_find), including membership.
fn ensureVlanGroup(vlanId: number)
Idempotently ensure the FreeRADIUS radius-vlan-<id> group exists as BOTH an ipausergroup (group_add) and an ipahostgroup (hostgroup_add). Swallows DuplicateEntry so re-runs are safe.
| Argument | Type | Description |
|---|---|---|
| vlanId | number | VLAN id to steer onto |
fn groupAddMember(cn: string)
Add members to a group in one call. kind=user -> group_add_member (user:[...]); kind=host -> hostgroup_add_member (host:[...]). Surfaces IPA's `failed` structure in the audit response.
| Argument | Type | Description |
|---|---|---|
| cn | string | Target group common name |
fn groupRemoveMember(cn: string)
Remove members from a group in one call. kind=user -> group_remove_member (user:[...]); kind=host -> hostgroup_remove_member (host:[...]). Surfaces IPA's `failed` structure in the audit response.
| Argument | Type | Description |
|---|---|---|
| cn | string | Target group common name |
Resources
groups(infinite)— User-group + host-group inventory snapshot
vlanGroup(infinite)— State of a radius-vlan-<id> group pair (user + host) after ensure
attempt(infinite)— Audit record of a mutation attempt (request + result/error + timestamp). Written on both success and failure.
03Previous Versions
2026.07.10.1Jul 11, 2026
04Stats
A
100 / 100
Downloads
0
Archive size
17.5 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/shrugpw/swamp-freeipa05Platforms
06Labels