pki-group(1)

💅 pki-group — the group-chat for your PKI groups

Okay bestie, so this is pki-group(1) from the PKI Group Management Commands family, and it's literally your command-line bestie for managing PKI groups. No cap. 🎀

✨ NAME ✨

pki-group — command-line interface for managing PKI groups. That's it, that's the vibe. 👑

🌸 SYNOPSIS 🌸

pki [CLI-options] <subsystem>-group
pki [CLI-options] <subsystem>-group-find [command-options]
pki [CLI-options] <subsystem>-group-show group-ID [command-options]
pki [CLI-options] <subsystem>-group-add group-ID [command-options]
pki [CLI-options] <subsystem>-group-mod group-ID [command-options]
pki [CLI-options] <subsystem>-group-del group-ID [command-options]

🦋 DESCRIPTION 🦋

The pki <subsystem>-group commands are your whole group-management era — they give you command-line interfaces to manage groups on the specified subsystem. It's giving "I have a CLI for that" 💅

The valid subsystems are ca, kra, ocsp, tks, and tps. Memorize them, iykyk.

• pki [CLI-options] <subsystem>-group — this command is to list available group commands for the subsystem. The menu, the directory, the little index of what you can do. ✨
• pki [CLI-options] <subsystem>-group-find [command-options] — this command is to list groups in the subsystem. Stalking the roster, respectfully. 🙈
• pki [CLI-options] <subsystem>-group-show group-ID [command-options] — this command is to view a group details in the subsystem. Main character inspection energy. 👑
• pki [CLI-options] <subsystem>-group-add group-ID [command-options] — this command is to add a group into the subsystem. New member just dropped. 🎀
• pki [CLI-options] <subsystem>-group-mod group-ID [command-options] — this command is to modify a group in the subsystem. Glow-up time, bestie. 💖
• pki [CLI-options] <subsystem>-group-del group-ID [command-options] — this command is to delete a group from the subsystem. Leaving the group chat, no hard feelings. 💀

💜 OPTIONS 💜

The CLI options are described in pki(1). Go read that one, it's the parent page and it ate. 🔥

🌈 OPERATIONS 🌈

Wanna see the available group commands? Just type:

pki <subsystem>-group

Wanna see each command's usage? Hit it with the help flag:

pki <subsystem>-group-<command> --help

⚠️ Important caveat, bestie: all group commands must be executed as the subsystem administrator. Not just anyone can roll up in here — you need the right credentials or it's not gonna slay. 🫶

So for example, to list groups in CA, you execute the following command:

$ pki <CA admin authentication> ca-group-find

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-group-find --start 20 --size 10

The above command will return entries #20 to #29. Yes, 0-based, meaning --start 20 really does start at #20 — it's giving "the numbering is what it is" 😭.

To view a CA group, specify the group ID in the following command:

$ pki <CA admin authentication> ca-group-show testgroup

To add a CA group, specify the group ID in the following command:

$ pki <CA admin authentication> ca-group-add testgroup

To modify a CA group, specify the group ID and the attributes to be modified in the following command:

$ pki <CA admin authentication> ca-group-mod testgroup --description "Test Group"

To delete a CA group, specify the group ID in the following command:

$ pki <CA admin authentication> ca-group-del testgroup

🧚 SEE ALSO 🧚

• pki-group-member(1) — group member management commands. The whole squad of related pages, go browse. 🦋

⭐ AUTHORS ⭐

Ade Lee <alee@redhat.com>, Endi S. Dewata <edewata@redhat.com>, and Matthew Harmsen <mharmsen@redhat.com>. Icons, all of them, we stan. 💜

🍓 COPYRIGHT 🍓

Copyright (c) 2014 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.

---

And that's the whole page, bestie — /usr/share/man realness brought to you by PKI, dated May 5, 2014. Periodt. 💅✨