Safeguard Authentication Services 5.0.2 - Authentication Services for Smart Cards Administration Guide

Test the smart card user

To test that a card has been initialized with an appropriate user

1. Run the vastool smartcard test user command, as follows:

   # vastool smartcard test user
   Testing user user@vas.example
   Testing certificate validity ... ok
   Testing if PIN is required ... ok
   Enter PIN for user@vas.example: xxxxxxxx
   Performing login to card ... ok
   Generating signature ... ok
   Verifying signature ... ok

   This tests whether a valid user is on the card, and whether you are able to log into the card and use its cryptographic functions. If your card requires a PIN, enter the password at the prompt.

   The vastool smartcard test card function generates output similar to the following:

   CKM_RSA_X_509 CKM_MD2_RSA_PKCS CKM_MD5_RSA_PKCS CKM_SHA1_RSA_PKCS
   CKM_DES_KEY_GEN CKM_DES_ECB CKM_DES_CBC CKM_DES_CBC_PAD CKM_DES2_KEY_GEN
   CKM_DES3_KEY_GEN CKM_DES3_ECB CKM_DES3_CBC CKM_DES3_CBC_PAD CKM_MD2 CKM_MD5
   CKM_SHA_1
   Checking that CKM_RSA_PKCS mechanism is supported ... ok
   Checking info for CKM_RSA_PKCS mechanism ... ok
   Checking CKM_RSA_PKCS mechanism supports signing ... ok
   Checking CKM_RSA_PKCS mechanism supports decryption ... ok
   Testing that card contains a user ... ok

Test user log in

To test whether it is possible to log in using the inserted card

1. Run the vastool smartcard test login command.

   For example:

   # vastool smartcard test login
   Testing user user@vas.example
   Testing certificate validity ... ok
   Testing if PIN is required ... ok
   Enter PIN for user@vas.example:
   Performing login to card ... ok
   Creating ID for client with UPN 'user@vas.example' ... ok
   Establish initial credentials using PKCS#11 ... ok

   This command uses the inserted card to perform a log in to Active Directory. It displays a warning if the user is not Unix enabled, and displays an error if the log in fails. This command is useful when troubleshooting Safeguard Authentication Services for Smart Cards log in problems.

Troubleshooting

To help you troubleshoot your Safeguard Authentication Services for Smart Cards installation, One Identity recommends the following resolutions to some of the common problems you might encounter.

Steps to diagnose problems

Safeguard Authentication Services for Smart Cards provides a number of tools and options to diagnose problems.

1. Check the smart card reader
2. Check the PKCS#11 library
3. Check the card
4. Check login
5. Enable debugging for smart card login with PAM
6. Enable debugging for the Safeguard Authentication Services daemon
7. Enable debugging for the PKCS#11 library