pki-tps-profile(1)

📦
version 11.7.1 · 3 versions
, in centos-stream 9, ubuntu jammy

💖 NAME 💖

okay so bestie, listen — pki-tps-profile is literally the command-line interface for managing PKI TPS profiles. that's it, that's the whole vibe ✨

🦋 SYNOPSIS 🦋

pki [CLI-options] tps-profile
pki [CLI-options] tps-profile-find [command-options]
pki [CLI-options] tps-profile-show profile-ID [command-options]
pki [CLI-options] tps-profile-add --input file-path [command-options]
pki [CLI-options] tps-profile-mod profile-ID --action action [command-options]
pki [CLI-options] tps-profile-mod profile-ID --input file-path [command-options]
pki [CLI-options] tps-profile-del profile-ID [command-options]

🌸 DESCRIPTION 🌸

the pki tps-profile commands are your little command-line besties for managing profiles on the TPS. no cap, they do a lot 💅

  • pki [CLI-options] tps-profile-find [command-options] — this one lists the profiles. window shopping, basically 🎀
  • pki [CLI-options] tps-profile-show profile-ID [command-options] — this one views the details of a profile. getting the full tea ☕
  • pki [CLI-options] tps-profile-add --input file-path [command-options] — this one creates a brand new profile. main character birth moment 👑
  • pki [CLI-options] tps-profile-mod profile-ID --action action [command-options] — this one changes the status of a profile. glow-up era 🔥
  • pki [CLI-options] tps-profile-mod profile-ID --input file-path [command-options] — this one modifies an existing profile. tweak and slay 🦋
  • pki [CLI-options] tps-profile-del profile-ID [command-options] — this one deletes a profile. goodbye bestie, it's giving closure 💀

✨ OPTIONS ✨

the CLI options are described in pki(1) — go read that one, iykyk 🫶

💜 OPERATIONS 💜

to see all the available profile commands, just type pki tps-profile. and to see each command's usage, type pki tps-profile-<command> --help — that's your cheat sheet, lowkey iconic ⭐

real talk: all the pki tps-profile commands require TPS admin or agent authentication. no auth, no entry 🙈

🎀 Listing profiles 🎀

to list all profile:

$ pki <TPS admin/agent authentication> tps-profile-find

the results can be paged using the --start and --size options described in pki(1). pagination ate, fr fr ✨

🍓 Viewing a profile 🍓

to view the status and properties of a profile:

$ pki <TPS admin/agent authentication> tps-profile-show <profile ID>

and to store the output of the above operation into a file:

$ pki <TPS admin/agent authentication> tps-profile-show <profile ID> --output <file path>

screenshot it, save it, keep the receipts 💖

🌈 Adding a profile 🌈

to add a new profile, prepare an input file specifying the profile properties in the following format:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Profile id="..." xmlns:ns2="http://www.w3.org/2005/Atom">
    <Properties>
        <Property name="...">...</Property>
        ...
    </Properties>
</Profile>

the profile properties are described in pki-tps-profile(5). then execute the following command:

$ pki <TPS admin authentication> tps-profile-add --input <file path>

✨ new profile just dropped ✨

🦋 Changing profile status 🦋

to change the profile status, execute the following command:

$ pki <TPS admin/agent authentication> tps-profile-mod <profile ID> --action <action>

so which actions can you use? it's giving role-dependent, bestie:

  • available actions for admins: submit, cancel
  • available actions for agents: approve, reject
  • available actions for users with both admin and agent rights: enable, disable

💅 Modifying a profile 💅

to modify a profile, first disable the profile using the tps-profile-mod --action disable command. then download the current profile properties using the tps-profile-show --output command. make the modifications in the file, then upload the updated file using the following command:

$ pki <TPS admin authentication> tps-profile-mod <profile ID> --input <file path>

finally, the profile should be re-enabled using the tps-profile-mod --action enable command. disable → edit → re-enable, that's the whole ritual, don't skip steps 🫶

💀 Deleting a profile 💀

to delete a profile, first disable the profile using the tps-profile-mod --action disable command, then execute:

$ pki <TPS admin authentication> tps-profile-del <profile ID>

and that's the end of that era 😭

👑 SEE ALSO 👑

pki(1), pki-tps-profile(5)

🌟 AUTHORS 🌟

Endi S. Dewata <edewata@redhat.com>. — yes, a whole legend 🫡

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.

and that's the whole page, bestie — brought to you by PKI, dated Jul 14, 2015. stan a classic manpage 💖✨🎀

📦 where this page comes from