Changes between Version 1 and Version 2 of APACHE_sharing_iplanet_cert


Ignore:
Timestamp:
12/03/14 15:13:50 (10 years ago)
Author:
lttoth@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • APACHE_sharing_iplanet_cert

    v1 v2  
    33 
    44== Overview == 
    5 Handling of certificates is managed different on the legacy systems, E boxes, than that of the IDMP-''x'' cluster.  The discussion is divided into two groups,  
     5Handling of certificates is managed differently on the legacy systems, E boxes, than that of the IDMP-''x'' cluster.  This document focuses only on certificate management for the legacy E Box system. 
     6 
    67Apache and iPlanet share the certificate file requested by, and installed under, iPlanet. 
    78The crt and key file names/locations are indicated in the httpd.conf file: 
     
    1011         * SSLCertificateKeyFile:  /usr/local/Apache/ssl-certs/<''E Box''>_private.key 
    1112 
    12 == Extracting CRT and Key Components from the iPlanet Certificate == 
     13== Extracting CRT and Key Components from the E Box iPlanet Certificate == 
    1314What follows is an example of the process for extracting the crt and key components from the 
    1415iPlanet certificate.  The appropriate response to all password prompts is the token value 
     
    1718         <''E Box''>:~iplanet/.ssl.pass   
    1819 
    19 The entire listing of passwords used by the user, iplanet on the E Box servers is:IDMP-'xx' servers  
    20 The IDMP-x cluster servers have set up access based on functionality in a different way.  On those machines 
    21 ''Note:''  the output file name (./junk) in the commands below is arbitrary. 
    22 Note:  the 'pk12util' command below is wrapped with <backslash-newline> on first line. 
     20In the example below, the output file name (./junk) in the commands is arbitrary.  Also be aware that the ''pk12util'' command below is wrapped with <backslash-newline> on first line. The following options are used: 
    2321 
     22        * '-d /e01/iplanet/servers/alias/' references the location of cert/key database files. 
     23        * '-P slapd-<E box>-' references the prefix associated with a particular directory. 
     24        * '-n server-cert' references the nickname of a particular certificate in the cert/key database. 
     25 
     26{{{ 
    2427iplanet@eklutna> /e01/iplanet/servers/shared/bin/pk12util -o ./junk \ 
    25                  -d /e01/iplanet/servers/alias/ -n server-cert -P slapd-eklutna- 
     28                 -d /e01/iplanet/servers/alias/ -n server-cert -P slapd-<E box>- 
    2629 
    2730Enter Password or Pin for "NSS Certificate DB":  *XXYYZZ* 
     
    2932Re-enter password:  *XXYYZZ* 
    3033pk12util: PKCS12 EXPORT SUCCESSFUL 
     34}}} 
    3135 
    32 ++++++++++++++++++++++++++++++= 
    33 In the above example: (see also: pkcs12 --help) 
     36In additional option may be used: 
     37      * '[-w p12filepwfile | -W p12filepw]' allows a direct reference to the password file rather than entering it via prompts. 
    3438 
    35         '-d /e01/iplanet/servers/alias/' references the location of cert/key database files. 
    36         '-P slapd-eklutna-' references the prefix associated with a particular directory. 
    37         '-n server-cert' references the nickname of a particular certificate in the cert/key database. 
     39In the above example: (see also: [[https://www.openssl.org/docs/apps/pkcs12.html|pkcs12 - PKCS#12 file utility - OpenSSL]]) 
    3840 
    39 Each nickname corresponds to a particular cert.  The nickname server-cert is the default nickname 
    40 proposed by iPlanet.  That nickname is what we associated with the server name based certs (e.g.  
    41 the eklutna, elias, egegik and edgar certs are all associated with the server-cert nickname). 
    42 More recently, certs requested under iPlanet are given more explicit nicknames like 'edirtest'. 
     41== Certificate Nicknames == 
     42Each nickname referenced by the ''-n'' option corresponds to a particular cert.  The nickname, server-cert, is the default nickname proposed by iPlanet.  That nickname is what we associated with the server name based certs.  In other words, the eklutna, elias, egegik and edgar certs are all associated with the server-cert nickname.  More recently, certs requested under iPlanet are given more explicit nicknames like ''dirtiest''. 
    4343 
    4444To obtain a list of nicknames from a specific key database: 
    45  
     45{{{ 
    4646iplanet@eklutna> /e01/iplanet/servers/shared/bin/certutil -K -d /e01/iplanet/servers/alias -P slapd-eklutna-     
    4747Enter Password or Pin for "NSS Certificate DB": 
    4848<0>  
    4949<1> server-cert 
    50 ++++++++++++++++++++++++++++++= 
    5150 
    5251iplanet@eklutna> ls -al ./junk 
    5352-rw-------   1 iplanet  iplanet     2772 Oct 27 16:01 ./junk 
    54  
    5553iplanet@eklutna> /usr/local/bin/openssl pkcs12 -clcerts -nokeys -in ./junk -out ./eklutna.crt 
    5654Enter Import Password:  *XXYYZZ* 
     
    5957iplanet@eklutna> ls -lrt ./eklutna.crt 
    6058-rw-r--r--   1 iplanet  iplanet     1245 Oct 27 16:02 ./eklutna.crt 
    61  
    6259iplanet@eklutna> /usr/local/bin/openssl pkcs12 -nocerts -in ./junk -out ./eklutna_private.pem 
    6360Enter Import Password:  *XXYYZZ* 
     
    6865iplanet@eklutna> ls -lrt ./eklutna_private.pem 
    6966-rw-r--r--   1 iplanet  iplanet     1105 Oct 27 16:05 ./eklutna_private.pem 
     67}}} 
    7068 
    71  
    72 Create key without a pass phrase. 
    73  
     69To create key without a pass phrase. 
     70{{ 
    7471iplanet@eklutna> /usr/local/bin/openssl rsa -in ./eklutna_private.pem -out ./eklutna_private.key 
    7572Enter pass phrase for eklutna_private.key: <CR>  (null response) 
     
    7875iplanet@eklutna> ls -lrt ./eklutna_private.key 
    7976-rw-r--r--   1 iplanet  iplanet      887 Oct 27 16:06 ./eklutna_private.key 
    80  
     77}}} 
    8178 
    8279Now tell 'root' user to move files from "~iplanet" to "/usr/local/Apache/ssl-certs/". 
    8380 
    84 Sample httpd.conf file usage: 
     81== HTTPD Configuration == 
     82Originally the httpd.conf located at /usr/local/Apache/httpd.conf, included references shown below that corresponded to the certificate file locations listed above: 
     83 
     84/usr/local/Apache/httpd.conf: 
    8585 
    8686SSLCertificateFile /usr/local/Apache/ssl-certs/eklutna.crt 
    8787SSLCertificateKeyFile /usr/local/Apache/ssl-certs/eklutna_private.key 
    8888 
     89The file no longer contains these references.  The excerpts contains the current httpd.conf directives.  Only those options used (i.e., not all included in the original template) are copied here. 
     90 
     91 
     92}}} 
    8993########################################################[[br]] 
    9094LEGACY CHANGE HISTORY - NOTE: All subsequent changes are recorded in TracWiki[[br]]