What is the Calypso Basic Legacy SAM Personalization Tool?
The Calypso Basic Legacy SAM Personalization Tool is a desktop application designed to create a SAM CPP specifically dedicated to the personalization of Calypso Basic cards by injecting the necessary keys.
Key Features:
- SAM Dump: Displays the SAM parameters and keys settings.
- SAM Personalization: Enables the transfer of keys and configurations from an origin SAM SP to a blank SAM CPP.
- Dual Reader Setup: Requires a Target SAM Reader for the blank SAM and an Origin SAM Reader containing the SAM SP with desired settings and keys.
Why use the Calypso Basic Legacy SAM Personalization Tool?
This tool helps for operators who need to prepare SAM CPP for field deployment of Calypso Basic card personalized with the basic-card-personalizer tool.
This user guide explains how to personalize a SAM CPP needed for Calypso Basic card keys injection.
Hardware Requirements
This tool requires two PC/SC contact readers:
- Target SAM Reader: this reader holds the blank SAM CPP you want to personalize.
- Origin SAM Reader: this reader contains the SAM SP with the desired keys and settings.
Installation
- The software is available in a GitHub repository. Go to
the releases page to download it. (Note:
the GitHub repository is private. Please request access from CNA). Choose the installation
file that matches your operating system:
- Windows:
.msi
package - macOS:
.dmg
package (available in both arm64 version for Apple Silicon Macs and x64 version for Intel Macs) - Linux:
.deb
package
- Windows:
- Windows: double-click the
.msi
package to start the installation. - macOS:
- Open the
.dmg
file and drag the application to the Applications folder - Since the application is not signed with an Apple developer certificate, you’ll need to authorize it:
- When first launching the app, you may see a security warning
- Go to System Settings > Privacy & Security
- Scroll down to find the message about the blocked application
- Click “Open Anyway” to authorize the application
- Open the
- Linux: use your distribution’s package manager to install the
.deb
package. - Important note: the installer does not automatically create a shortcut in the Start Menu (Windows) or
Applications menu (macOS). You need to create one manually.
Launch the Tool
- After installation, find the executable in the installation directory:
- Windows:
C:\Program Files\cna-tool-basic-legacysam-perso-app\
- macOS:
/Applications/cna-tool-basic-legacysam-perso-app/
- Linux:
/opt/cna-tool-basic-legacysam-perso-app/
(or your user’s home directory)
- Windows:
- Double-click the executable to launch the Calypso Basic Legacy SAM Personalization Tool.
Application UI
The application window has a top menu and three tabs:
Settings Menu
- Click the Settings menu.
- Select the Target SAM Reader name. This is where you will insert your blank SAM.
- Select the Origin SAM Reader name. This SAM contains the data you want to transfer to the target SAM.
- Enter the Origin SAM Unlock Value if required.
Tabs
- SAM Dump: shows the detailed information and parameters of the SAM inserted in the target SAM reader.
- SAM Personalization: configure and execute the personalization process.
- Application Info: view logs and events related to the application and SAM readers. Useful for troubleshooting.
Personalize a SAM CPP
- Select the SAM Personalization tab.
- Insert a blank SAM in the target SAM reader.
- Insert the SAM SP in the origin SAM reader.
- Set the parameters:
- Parameter version and owner data (informative)
- System keys KVC
- Work keys KIF and KVC
- Lock parameters
- Click Execute to personalize your SAM.
Refresh Reader Detection
If you connect or disconnect SAM readers while the application is running, you might need to switch between the tabs (SAM Dump, SAM Personalization, Application Info) for the application to recognize the changes.
Screenshots
Installation
Settings
SAM dump
SAM personalization
Application info
Disclaimer
This tool is provided by CNA for its members. Only active CNA members are authorized to use this tool. A member is not authorized to distribute this tool to other parties.
User Requirements and Responsibilities
- Target Audience: users familiar with SAM personalization and the Calypso system.
- Prerequisites: necessary hardware (SAM readers) and software (drivers) installed and configured correctly.
- Responsibilities: ensure the correct selection of target and origin SAMs, and the proper handling of unlock values and other sensitive information.
- Usage: authorized personnel only. Misuse or unauthorized distribution is strictly prohibited.