systemd · Capability

systemd Varlink — UserDatabase

Self-contained Naftiko capability wrapping the io.systemd.UserDatabase Varlink interface, the pluggable NSS-replacement that returns systemd JSON UserRecord/GroupRecord documents from nss-systemd, homed, machined, and userdbd backends.

systemd Varlink — UserDatabase is a Naftiko capability published by systemd, one of 9 capabilities the APIs.io network indexes for this provider.

Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Identity, IPC, User Records, and Varlink.

Run with Naftiko IdentityIPCUser RecordsVarlink

Capability Spec

varlink-userdb.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: systemd Varlink — UserDatabase
  description: |
    Self-contained Naftiko capability wrapping the io.systemd.UserDatabase Varlink interface, the
    pluggable NSS-replacement that returns systemd JSON UserRecord/GroupRecord documents from
    nss-systemd, homed, machined, and userdbd backends.
  tags:
  - Identity
  - IPC
  - User Records
  - Varlink
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
- namespace: env
  keys:
    SYSTEMD_VARLINK_SOCKET: SYSTEMD_VARLINK_SOCKET
capability:
  consumes:
  - type: varlink
    namespace: io.systemd.UserDatabase
    socket: /run/systemd/userdb/io.systemd.UserDatabase
    description: User/group lookup via Varlink.
    resources:
    - name: identity
      operations:
      - { name: GetUserRecord, method: io.systemd.UserDatabase.GetUserRecord, description: Resolve a user record by name/uid. }
      - { name: GetGroupRecord, method: io.systemd.UserDatabase.GetGroupRecord, description: Resolve a group record by name/gid. }
      - { name: GetMemberships, method: io.systemd.UserDatabase.GetMemberships, description: Enumerate group memberships for a user or group. }