table of contents
pki-tps-profile(1) | PKI TPS Profile Management Commands | pki-tps-profile(1) |
NAME¶
pki-tps-profile - Command-line interface for managing PKI TPS profiles.
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 provide command-line interfaces to manage profiles on the TPS.
pki [CLI-options] tps-profile-find
[command-options]
This command is to list the profiles.
pki [CLI-options] tps-profile-show
profile-ID [command-options]
This command is to view the details of a profile.
pki [CLI-options] tps-profile-add --input
file-path [command-options]
This command is to create a new profile.
pki [CLI-options] tps-profile-mod
profile-ID --action action [command-options]
This command is to change the status of a profile.
pki [CLI-options] tps-profile-mod
profile-ID --input file-path [command-options]
This command is to modify an existing profile.
pki [CLI-options] tps-profile-del
profile-ID [command-options]
This command is to delete a profile.
OPTIONS¶
The CLI options are described in pki(1).
OPERATIONS¶
To view available profile commands, type pki tps-profile. To view each command's usage, type pki tps-profile-<command> --help.
All the pki tps-profile commands require TPS admin or agent authentication.
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).
Viewing a profile¶
To view the status and properties of a profile:
$ pki <TPS admin/agent authentication> tps-profile-show <profile ID>
To store the output of the above operation into a file:
$ pki <TPS admin/agent authentication> tps-profile-show <profile ID> --output <file path>
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>
Changing profile status¶
To change the profile status execute the following command:
$ pki <TPS admin/agent authentication> tps-profile-mod <profile ID> --action <action>
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.
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>
SEE ALSO¶
pki(1), pki-tps-profile(5)
AUTHORS¶
Endi S. Dewata <edewata@redhat.com>.
COPYRIGHT¶
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.
July 14, 2015 | PKI |