Skip to content

Cryhod

The Cosmian KMS can be used to unlock Prim’x CRYHOD partitions

Configuring Prim’X CRYHOD

If you get the following popup when trying to encrypt a disk

Need additional Configuration
Figure 1: Need additional Configuration

Additional configuration is required.

Launch the CRYHOD policies application.

CRYHOD policies app
Figure 2: CRYHOD policies app

Configure the P131 policy:

CRYHOD_P131
Figure 3: CRYHOD_P131

For testing you can set the value to th.

Configure the P821 policy:

CRYHOD_P821
Figure 4: CRYHOD_P821

For testing you can keep the default values.

Configuring the location of the PKCS#11 provider using the policy P296

CRYHOD_p296
Figure 5: CRYHOD_p296

Enter the full path of the ckms_pkcs11.dll as value name and leave the value empty.

Note: if you change the value, kill all CRYHOD processes or restart for the change to be taken into effect

Encrypting a partition

Launch Computer Encryption Center

CRYHOD_cyc
Figure 6: CRYHOD_cyc

And select the partition to encrypt.

Then select Key stored in a smart card or USB device (PKCS#11)

CRYHOD_pkcs11
Figure 7: CRYHOD_pkcs11

Click next; the Comsian KMS should appear in the list

CRYHOD_cosmian_kms
Figure 8: CRYHOD_cosmian_kms

Click next

Adjusting the KMS location and authentication

The configuration file is located in the User home .cosmian sub-directory, in the kms.json file.

See Authenticating users to the KMS to learn how to configure the KMS to use Open ID connect or certificate authentication (please note that the KMS can also manage the machines certificates).

Here is an example configuration file for the PKCS#11 provider library accessing the KMS using a PKCS#12 file for authentication.

{
  "server_url": "https://kms.acme.com:9999",
  "ssl_client_pkcs12_path": "./certificates/machine123.acme.p12",
  "ssl_client_pkcs12_password": "machine123_pkcs12_password"
}

Viewing the logs

By default, the logs are available in the User home .cosmian sub-directory.

Get-Content -path C:\<USER HOME>\.cosmian\ckms-pkcs11.log -wait

The log level can be adjusted using the COSMIAN_PKCS11_LOGGING_LEVEL environment variable.

setx COSMIAN_PKCS11_LOGGING_LEVEL "debug"

Creating a RSA private key and Certificate to use with CRYHOD

Create an RSA key with 2048 bits and the disk-encryption tag. This tag is the default tag searched. The value can be changed by setting the COSMIAN_PKCS11_DISK_ENCRYPTION_TAG environment value.

ckms.exe rsa keys create -s 2048 -t disk-encryption
          Public key unique identifier: ec572e57-eab0-481c-9393-805a11c12ac0
          Private key unique identifier: e70509f9-77ae-4310-bd15-8f6049372426

© Copyright 2018-2024 Cosmian. All rights reserved.