Difference between revisions of "Common Access Card"

From ArchWiki
Jump to: navigation, search
m (changed wording/punctuation in Chromium section to be more precise)
 
(35 intermediate revisions by 13 users not shown)
Line 1: Line 1:
 
[[Category:Other hardware]]
 
[[Category:Other hardware]]
This page explains how to setup Arch to use a US Department of Defense [http://en.wikipedia.org/wiki/Common_Access_Card Common Access Card] (CAC).  It was tested with an SCR331 USB card reader which is a very common one. Others may work...or not.
+
This page explains how to setup Arch to use a US Department of Defense [[wikipedia:Common_Access_Card|Common Access Card]] (CAC).  It was tested with a Dell Smart Card Reader Keyboard and a SCM SCR3310. Others may not work.
  
==Software Installation==
+
== Installation ==
# Install {{Pkg|pcsclite}} and {{Pkg|ccid}} from [community] and install {{AUR|coolkey}} from [[AUR]].
+
# Add {{Ic|pcscd}} to the daemons array in [[rc.conf]].
+
Install {{Pkg|ccid}} and {{Pkg|opensc}} from [[official repositories]].
# Reboot -or- type {{Ic|pcscd}} in a terminal to enable the smart card reader.
+
# Plug in the card reader without a card inserted.  The SCR331's light should turn on (not flashing).
+
# Put a CAC into the reader and make sure (at least on the SCR331) that the light starts flashing.  If it does, it's set up correctly.
+
  
==Configuring Firefox==
+
There are two places in {{ic|/etc/opensc.conf}} that comment out {{ic|enable_pinpad = false}}. If your card reader does not have a pin pad, uncomment these lines.
  
===Enabling Firefox to use the CAC Reader===
+
== Enable pcscd ==
  
Insert CAC into reader - the green light should flash on the SCR331.
+
[[Start]] and enable {{ic|pcscd.service}}.
  
Add ''CAC Reader'' to Firefox as a Security Device
+
== Configure browser ==
# Go to Edit->Preferences on the toolbar.
+
# Click on ''Advanced''
+
# Click on the ''Encryption'' Tab
+
# Click on the ''Security Devices'' Button
+
# Click on the ''Load'' Button
+
# Enter ''CAC Reader'' as the module name, and browse to {{ic|/usr/lib/pkcs11/libcoolkeypk11.so}} then click ''Open''.
+
  
===Importing the DoD Certificates===
+
=== Firefox ===
  
If you're using a branded version of [[Firefox]] you should be able to go to http://dodpki.c3pki.chamb.disa.mil/rootca.html and click on the high-level certificates to install them and be done.
+
==== Load security device ====
  
If you're using Namoroka this site will not recognize it as Firefox and simply clicking on the link above will not get you into the site.  You can work around this problem (which affects some other websites too) by changing Namoroka's configuration a little.
+
Navigate to Edit -> Preference -> Advanced -> Certificates -> Security Devices and load a module using {{ic|/usr/lib/opensc-pkcs11.so}}.
#Open a new tab in Namoroka
+
#Type ''about:config'' in the address bar and press enter
+
#Type 'useragent' in the search box
+
#Double-click on the value where you see "Namoroka"
+
#Change "Namoroka" to "Firefox"
+
#Close the tab
+
  
Once you get into the site, you can download the certificates by following the directions on the page.
+
==== Import the DoD Certificates ====
 +
 
 +
If you're using a branded version of [[Firefox]] you should be able to go to http://dodpki.c3pki.chamb.disa.mil/rootca.html and click on the high-level certificates to install them and be done.
  
 
The primary root certificate used has a CN of "DoD Root CA 2": this certificate can be converted to PEM format for use in other browsers:
 
The primary root certificate used has a CN of "DoD Root CA 2": this certificate can be converted to PEM format for use in other browsers:
Line 41: Line 28:
 
# Extract the root certificate into a PEM-formatted file.  
 
# Extract the root certificate into a PEM-formatted file.  
 
{{ic|<nowiki>$ openssl pkcs7 -inform DER -in rel3_dodroot_2048.p7b -print_certs | sed -n '/subject=.*CN=DoD Root CA 2/,${/^$/q;P;D}' > DoD_Root_CA_2.pem</nowiki>}}
 
{{ic|<nowiki>$ openssl pkcs7 -inform DER -in rel3_dodroot_2048.p7b -print_certs | sed -n '/subject=.*CN=DoD Root CA 2/,${/^$/q;P;D}' > DoD_Root_CA_2.pem</nowiki>}}
 +
 +
=== Chromium/Google Chrome ===
 +
1. Ensure CAC is connected, [[Chromium]] is closed and enter the following in a terminal:
 +
{{ic|<nowiki>$ modutil -dbdir sql:.pki/nssdb/ -add "CAC Module" -libfile /usr/lib/opensc-pkcs11.so</nowiki>}}
 +
 +
2. Go to: http://iase.disa.mil/pki-pke/Pages/tools.aspx
 +
 +
3. Download certs: "Trust Store" -> "PKI CA Certificate Bundles: PKCS#7" -> "For DoD PKI Only - Version 5.0" (ZIP Download)
 +
 +
4. Unzip the DoD PKI zip, change directory to the new folder, and install:
 +
 +
  for n in (ls * | grep Chrome); do certutil -d sql:$HOME/.pki/nssdb -A -t TC -n $n -i $n; done
  
 
==Testing==
 
==Testing==
  
 
Visit your favorite CAC secured web page and you should be asked for the ''Master Password'' for your certificate.  Enter it and if you get in, you know it's working.
 
Visit your favorite CAC secured web page and you should be asked for the ''Master Password'' for your certificate.  Enter it and if you get in, you know it's working.
 +
 +
== Debugging ==
 +
 +
The {{Pkg|pcsc-tools}} package is also availabe in '''[community]'''. The program {{ic|pcsc_scan}} may be helpful
 +
 +
[cceleri@ender ~]$ pcsc_scan
 +
PC/SC device scanner
 +
V 1.4.21 (c) 2001-2011, Ludovic Rousseau <ludovic.rousseau@free.fr>
 +
Compiled with PC/SC lite version: 1.8.6
 +
Using reader plug'n play mechanism
 +
Scanning present readers...
 +
0: Dell Dell Smart Card Reader Keyboard 00 00
 +
 +
Thu Sep  5 10:41:53 2013
 +
Reader 0: Dell Dell Smart Card Reader Keyboard 00 00
 +
  Card state: Card removed,
 +
 +
Thu Sep  5 10:41:58 2013
 +
Reader 0: Dell Dell Smart Card Reader Keyboard 00 00
 +
  Card state: Card inserted,
 +
  ATR: 3B DB 96 00 80 1F 03 00 31 C0 64 B0 F3 10 00 07 90 00 80
 +
 +
ATR: 3B DB 96 00 80 1F 03 00 31 C0 64 B0 F3 10 00 07 90 00 80
 +
+ TS = 3B --> Direct Convention
 +
+ T0 = DB, Y(1): 1101, K: 11 (historical bytes)
 +
  TA(1) = 96 --> Fi=512, Di=32, 16 cycles/ETU
 +
    250000 bits/s at 4 MHz, fMax for Fi = 5 MHz => 312500 bits/s
 +
  TC(1) = 00 --> Extra guard time: 0
 +
  TD(1) = 80 --> Y(i+1) = 1000, Protocol T = 0
 +
-----
 +
  TD(2) = 1F --> Y(i+1) = 0001, Protocol T = 15 - Global interface bytes following
 +
-----
 +
  TA(3) = 03 --> Clock stop: not supported - Class accepted by the card: (3G) A 5V B 3V
 +
+ Historical bytes: 00 31 C0 64 B0 F3 10 00 07 90 00
 +
  Category indicator byte: 00 (compact TLV data object)
 +
    Tag: 3, len: 1 (card service data byte)
 +
      Card service data byte: C0
 +
        - Application selection: by full DF name
 +
        - Application selection: by partial DF name
 +
        - EF.DIR and EF.ATR access services: by GET RECORD(s) command
 +
        - Card with MF
 +
    Tag: 6, len: 4 (pre-issuing data)
 +
      Data: B0 F3 10 00
 +
    Mandatory status indicator (3 last bytes)
 +
      LCS (life card cycle): 07 (Operational state (activated))
 +
      SW: 9000 (Normal processing.)
 +
+ TCK = 80 (correct checksum)
 +
 +
Possibly identified card (using /usr/share/pcsc/smartcard_list.txt):
 +
3B DB 96 00 80 1F 03 00 31 C0 64 B0 F3 10 00 07 90 00 80
 +
DoD CAC, Oberthur ID One 128 v5.5 Dual

Latest revision as of 19:32, 18 August 2016

This page explains how to setup Arch to use a US Department of Defense Common Access Card (CAC). It was tested with a Dell Smart Card Reader Keyboard and a SCM SCR3310. Others may not work.

Installation

Install ccid and opensc from official repositories.

There are two places in /etc/opensc.conf that comment out enable_pinpad = false. If your card reader does not have a pin pad, uncomment these lines.

Enable pcscd

Start and enable pcscd.service.

Configure browser

Firefox

Load security device

Navigate to Edit -> Preference -> Advanced -> Certificates -> Security Devices and load a module using /usr/lib/opensc-pkcs11.so.

Import the DoD Certificates

If you're using a branded version of Firefox you should be able to go to http://dodpki.c3pki.chamb.disa.mil/rootca.html and click on the high-level certificates to install them and be done.

The primary root certificate used has a CN of "DoD Root CA 2": this certificate can be converted to PEM format for use in other browsers:

  1. Download the CA bundle. This includes approximately 36 certificates. $ curl -O http://dodpki.c3pki.chamb.disa.mil/rel3_dodroot_2048.p7b
  2. Extract the root certificate into a PEM-formatted file.

$ openssl pkcs7 -inform DER -in rel3_dodroot_2048.p7b -print_certs | sed -n '/subject=.*CN=DoD Root CA 2/,${/^$/q;P;D}' > DoD_Root_CA_2.pem

Chromium/Google Chrome

1. Ensure CAC is connected, Chromium is closed and enter the following in a terminal: $ modutil -dbdir sql:.pki/nssdb/ -add "CAC Module" -libfile /usr/lib/opensc-pkcs11.so

2. Go to: http://iase.disa.mil/pki-pke/Pages/tools.aspx

3. Download certs: "Trust Store" -> "PKI CA Certificate Bundles: PKCS#7" -> "For DoD PKI Only - Version 5.0" (ZIP Download)

4. Unzip the DoD PKI zip, change directory to the new folder, and install:

 for n in (ls * | grep Chrome); do certutil -d sql:$HOME/.pki/nssdb -A -t TC -n $n -i $n; done

Testing

Visit your favorite CAC secured web page and you should be asked for the Master Password for your certificate. Enter it and if you get in, you know it's working.

Debugging

The pcsc-tools package is also availabe in [community]. The program pcsc_scan may be helpful

[cceleri@ender ~]$ pcsc_scan 
PC/SC device scanner
V 1.4.21 (c) 2001-2011, Ludovic Rousseau <ludovic.rousseau@free.fr>
Compiled with PC/SC lite version: 1.8.6
Using reader plug'n play mechanism
Scanning present readers...
0: Dell Dell Smart Card Reader Keyboard 00 00
Thu Sep  5 10:41:53 2013
Reader 0: Dell Dell Smart Card Reader Keyboard 00 00
  Card state: Card removed, 
Thu Sep  5 10:41:58 2013
Reader 0: Dell Dell Smart Card Reader Keyboard 00 00
  Card state: Card inserted, 
  ATR: 3B DB 96 00 80 1F 03 00 31 C0 64 B0 F3 10 00 07 90 00 80
ATR: 3B DB 96 00 80 1F 03 00 31 C0 64 B0 F3 10 00 07 90 00 80
+ TS = 3B --> Direct Convention
+ T0 = DB, Y(1): 1101, K: 11 (historical bytes)
  TA(1) = 96 --> Fi=512, Di=32, 16 cycles/ETU
    250000 bits/s at 4 MHz, fMax for Fi = 5 MHz => 312500 bits/s
  TC(1) = 00 --> Extra guard time: 0
  TD(1) = 80 --> Y(i+1) = 1000, Protocol T = 0 
-----
  TD(2) = 1F --> Y(i+1) = 0001, Protocol T = 15 - Global interface bytes following 
-----
  TA(3) = 03 --> Clock stop: not supported - Class accepted by the card: (3G) A 5V B 3V 
+ Historical bytes: 00 31 C0 64 B0 F3 10 00 07 90 00
  Category indicator byte: 00 (compact TLV data object)
    Tag: 3, len: 1 (card service data byte)
      Card service data byte: C0
        - Application selection: by full DF name
        - Application selection: by partial DF name
        - EF.DIR and EF.ATR access services: by GET RECORD(s) command
        - Card with MF
    Tag: 6, len: 4 (pre-issuing data)
     Data: B0 F3 10 00
    Mandatory status indicator (3 last bytes)
      LCS (life card cycle): 07 (Operational state (activated))
      SW: 9000 (Normal processing.)
+ TCK = 80 (correct checksum)
Possibly identified card (using /usr/share/pcsc/smartcard_list.txt):
3B DB 96 00 80 1F 03 00 31 C0 64 B0 F3 10 00 07 90 00 80
	DoD CAC, Oberthur ID One 128 v5.5 Dual