[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 1

certverify Command

Purpose

certverify verifies that the invoker is in possession of the private key for the specified certificate.

Syntax

certverify [-S servicename] tag [user-name]}

Description

The certverify command verifies that the user is in possession of the private key for the specified certificate. Once the system verifies that the user is in possession of the private key, a signature is created for this certificate and associated with the certificate. A certificate that has not gone through this verification process is considered untrustworthy by AIX.

The -S option specifies which end-entity services and libraries to use while verifying the certificate. Available services are defined in /usr/lib/security/pki/ca.cfg. When invoked without -S flag, certverify will use the default service, local. It is an error to specify a service name which does not have an entry in the /usr/lib/security/pki/ca.cfg file. The tag parameter uniquely selects one of the user's certificates. The username parameter specifies which AIX user is to be queried. The certverify command will issue a password prompt and request the user to enter the password of the keystore. The command may fail if it is unable to open /dev/tty for the current process.

Flags

-S servicename Specifies which service module to use.

Exit Status

0 Successful completion.
>0 An error occured.

Security

This is a setuid command.

A user must prove that he has the possession of the private key matching the certificate he owns by knowing the password of the private keystore and the label that identifies the private key in the keystore.

Root and invokers belonging to group security are allowed to perform the verification operation, however, they can only successfully complete this operation if they have the knowledge of the label and the password to the keystore.

A non-privileged user is allowed to verify the possession of the private key only for the certificates they own.

Audit

This command records the following event information:

CERT_Verify <username>

Examples

To verify Bob's cert1 certificate, enter:

$ certverify cert1 bob

Files

/usr/lib/security/pki/acct.cfg

Related Information

The certadd, certcreate, certdelete, certget, certlink, certlist, certrevoke, keyadd, keydelete, keylist, keypasswd, and mksecpki commands.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]