Activating CardContact Developer Network (CDN)

The CDN is a service offering for CardContact customers, providing access to latest versions of our software and documentation. The CDN is the central hub for sharing information on our projects and to obtain help using our products.

Access to the CDN is protected using a SSL client certificate stored on a SmartCard-HSM. Your personal certificate will be issued during the activation procedure.

Prerequisite

To access the CDN you will need

  1. a SmartCard-HSM (can be purchased at cardomatic)
  2. a PC with Internet connection and a recent web browser installed (We recommend Mozilla Firefox for this purpose),
  3. at least version 0.13 of the OpenSC middleware or the SmartCard-HSM PKCS#11 module installed,
  4. access to your e-mail account,
  5. a SmartCard-HSM, either as USB stick or as card with reader and
  6. a recent version (>=3.12.x) of the Smart Card Shell installed.

The Smart Card Shell is required for obtaining your personal SSL certificate. Once you have obtained your certificate, you will only need a browser with the OpenSC middleware installed.

Installation Instruction

For installing OpenSC in Firefox follow the instructions at OpenSC. If you are using a different web browser, then follow the browser specific steps for installing a PKCS#11 module.

For installing the Smart Card Shell follow the instructions at OpenSCDP.

Obtaining your SSL Certificate

You can obtain your SSL client certificate for accessing the CDN using the SmartCard-HSM Key Manager, which is part of the Smart Card Shell. Open the Key Manager by pressing CTRL-M (or "File" / "Key Manager") once the Smart Card Shell is started.

The left part of the screen shows an outline with "SmartCard-HSM ()" as the top node. You can open the context menu with right-click and select "Request CDN Certificate". If your SmartCard-HSM has not been initialized yet, you need to select "Initialize Device" first. Select all the preset options if you are unsure what the initialization options means.

The "Request CDN Certificate" function will generate a new key pair on the SmartCard-HSM and submit a certificate signing request to the CardContact Developer Network CA. The CA will then send an activation code via e-mail, which you will need to present during the activation procedure. The certificate returned from the CA will be stored on the SmartCard-HSM.

During the procedure you will be asked to provide your name or pseudonym and a valid e-mail address. Please make sure, that the e-mail address is the same e-mail address you want to use for receiving notifications from the CDN. The provided name and e-mail address will be incorporated into your personal SSL certificate.

Please close your browser during the certificate request to make sure that the PKCS#11 module does not interfere with the procedure.

After receiving your certificate you should be able to access the CardContact Developer Network.

Register your User Account

Customer with a valid support contract should register a user account in the CDN to access non-public information. Please follow the "Register" link on the upper right corner.

Getting Help

If you experience problems with the activation, please don't hesitate to contact us.