pki-us...bership(1)

πŸ“¦
version 11.7.1 Β· 3 versions
, in centos-stream 9, ubuntu jammy

okay so welcome to pki-user-membership(1), bestie β€” the header/footer does that little pki-us...bership(1) abbreviation thing, but the manual name is pki-user-membership, and this whole page is the PKI User Membership Management Commands. πŸŽ€

🌸 NAME 🌸

pki-user-membership β€” the command-line interface for managing PKI user memberships, aka the group-chat roster of who belongs where. πŸ’–

✨ SYNOPSIS ✨

pki [CLI-options] <subsystem>-user-membership
pki [CLI-options] <subsystem>-user-membership-find user-ID
[command-options]
pki [CLI-options] <subsystem>-user-membership-add user-ID group-ID
[command-options]
pki [CLI-options] <subsystem>-user-membership-del user-ID group-ID
[command-options]

πŸ’– DESCRIPTION πŸ’–

the pki <subsystem>-user-membership commands are the command-line interfaces for managing user memberships on the specified subsystem. lowkey iconic. πŸ¦‹

Valid subsystems are ca, kra, ocsp, tks, and tps β€” those are the ones, fr fr.

  • pki [CLI-options] <subsystem>-user-membership β€” lists the available user membership commands for the subsystem. 🫢
  • pki [CLI-options] <subsystem>-user-membership-find user-ID [command-options] β€” lists the groups in which the subsystem user is a member. πŸ‘‘
  • pki [CLI-options] <subsystem>-user-membership-add user-ID group-ID [command-options] β€” adds the subsystem user into a group. ✨
  • pki [CLI-options] <subsystem>-user-membership-del user-ID group-ID [command-options] β€” deletes the subsystem user from a group. πŸ’…

πŸŽ€ OPTIONS πŸŽ€

  • CLI-options β€” the CLI options are described in pki(1). that's the main-character page for the general flags, iykyk.

πŸ¦‹ OPERATIONS πŸ¦‹

to view the available user membership commands, type pki <subsystem>-user-membership. to view each command's usage, type pki <subsystem>-user-membership-<command> --help. 🫑

every single user membership command must be executed as the subsystem administrator β€” no exceptions, bestie. πŸ”₯

for example, to list the groups in which a CA user is a member, execute this:

$ pki <CA admin authentication> ca-user-membership-find testuser

the results can be paged by specifying the (0-based) index of the first entry to return and the maximum number of entries returned:

$ pki <CA admin authentication> ca-user-membership-find testuser --start 20 --size 10

the above command will return entries #20 to #29. periodt. πŸ’…

to add a CA user into a group, specify the user ID and the group ID in this command:

$ pki <CA admin authentication> ca-user-membership-add testuser Administrators

to delete a CA user from a group, specify the user ID and the group ID in this command:

$ pki <CA admin authentication> ca-user-membership-del testuser Administrators

πŸ‘‘ AUTHORS πŸ‘‘

Endi S. Dewata <edewata@redhat.com>. πŸ‘‘

Copyright (c) 2015 Red Hat, Inc. This is licensed under the GNU General Public License, version 2 (GPLv2). A copy of this license is available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.


xoxo, stay iconic πŸ’– β€” this page comes from the PKI source/version set, dated Aug 24, 2015, and the footer still labels it pki-us...bership(1). πŸŽ€

πŸ“¦ where this page comes from