1.1.1 Example License Request for SAMA5D2 Devices

Old command line (Secure SAM-BA Cipher 3.x)

secure-sam-ba-cipher.py request-license -o request.txt

New command line (Secure SAM-BA Cipher 3.5)

secure-sam-ba-cipher.py request-license -d sama5d2x -o request.txt -pk license_private.pem -pp pass:license_passphrase -n 4096

Parameters:

-d, --device DEVICE (required)

Name of the device family.

-o, --output-file OUTPUT_FILE (optional)

Output filename for the license request. If omitted, the license will be written to standard output.

-pk, --priv-key-file PRIVATE_KEY_FILE (optional)

Specifies the name of the file where the private key will be created. If omitted, the private key is written to "private_key.pem" file.

-pp, --priv-key-pass PRIVATE_KEY_PASSWORD (optional)

Password used to encrypt the private key. The syntax is "pass:XXX" for password XXX, or "file:YYY" to read the password from file YYY. If omitted, the private key will be written in plain format.

-n, --rsa_size RSA_KEY_SIZE (optional)

RSA key size in bits. If omitted, 4096 bits is used as a default value.

Note:
  1. The private key of the license is generated only once at the first use of the request-license command. The same private key can be used to request a license for another device, by providing its file name and passphrase in the request-license command.
  2. Secure SAM-BA Cipher verifies if the private key already exists, otherwise a new one is generated.
  3. Using a passphrase to protect the user’s private key is highly recommended. The user must ensure the security of his own private key.