pklogin_finder(1)

Name | Synopsis | Description | Options | Exit Status | Examples | Files | Authors | Attributes | See Also

Name

pklogin_finder– map certificates into a user

Synopsis

/usr/lib/pam_pkcs11/pklogin_finder [debug] [config_file=filename]

Description

pklogin_finder uses the pam_pkcs11 library infrastructure to interactively map a PKCS#11 provided certificate to a user.

pklogin_finder uses the same configuration file and arguments than pam_pkcs11(5) PAM module. It loads defined mapper modules and tries to find a map between found certificates and a user login.

Options

The following options are supported:

config_file=fileame

Set the configuration file.

The default value is /etc/security/pam_pkcs11/pam_pkcs11.conf.

debug

Enable debugging output.

The default is no debug.

As it uses the same configuration file as pam_pkcs11(5), all of the pam_pkcs11 options are available. Some of these options make no sense in a non-PAM environment, and are therefore ignored. Some mapper options (mapfile, ignorecase) have no effect on certificate contents, and they are ignored as well.

Exit Status

The following exit values are returned:

0

Successful completion.

pkcs11_inspect prints on stdout the login name and exits.

1

An error occurred.

A user mapping error was found.

2

An error occurred.

No user match was found.

Examples

---

Example 1 Using pklogin_finder




The following example runs the pklogin_finder command without any options:

% pkcs11_inspect

---

---

Example 2 Using pklogin_finder with Options




The following example runs the pkcs_finder command with options:

% pklogin_finder debug config_file=${HOME}/.pam_pkcs11.conf

---

Files

/etc/security/pam_pkcs11/pam_pkcs11.conf

Authors

Juan Antonio Martinez, jonsito@teleline.es

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWpampkcs11u, SUNWpampkcs11r, SUNWpampkcs11-docs
Interface Stability	Uncommitted

See Also

pkcs11_inspect(1), attributes(5), pam_pkcs11(5)

PAM-PKCS11 User Manual, http://www.opensc-project.org/pam_pkcs11

SunOS 5.11  Last Revised 17 Jul 2008

Name | Synopsis | Description | Options | Exit Status | Examples | Files | Authors | Attributes | See Also