Step 4: Configuring the key management service

To set up the sending and receiving of AS4 messages in NoSpamProxy, you must first enter the service address of the key management service and optionally add a hardware security module (HSM) in NoSpamProxy.

NOTE: The key management service is used for the secure storage of private keys. For maximum security, we still recommend the use of an HSM. See below, Who needs to use an HSM?

Configuring the service address

  1. The service address is the address at which the Intranet Role connects to the key management service.
  2. In the NoSpamProxy Command Centre, go to NoSpamProxy components > Key management service and click Modify.
  3. Enter the service address under Connection.

    NOTE: The default address is https://localhost:6064. In any case, make sure that HTTPS traffic is permitted on port 6064.

  4. Under Credentials, enter the administrative user information for the service.
  5. Click Finish.

(Optional) Adding an HSM

If you also want to use an HSM to store your private keys, add it here.

  1. In the NoSpamProxy Command Centre, go to Configuration > NoSpamProxy components > Key management service.
  2. Under Key storage, click Modify.
  3. Tick the Additionally use a Hardware Security Module (HSM) [...] box.
  4. Enter the path to the HSM DLL file.
  5. Click Save and close.

The Configured tokens area now appears under Key management service.

NOTE:

The following requirements must be met before you can use an HSM to store your private keys:

  • The HSM must support the PKCS #11 standard.
  • The HSM must use the Elliptic Curve Brainpool P256r1 standard for key generation (CKM_EC_KEY_PAIR_GEN).
  • The HSM must use the key derivation function SP-800 (CKD_SHA256_KDF_SP800) for key derivation (CKM_ECDH1_DERIVE).

(Optional) Configuring a token

If you are using an HSM and have added it, you can access the tokens of the HSM and configure the desired token.

  1. Under Configured tokens, click Modify.
  2. Under Token, select the desired token from the drop-down menu.
  3. Enter the corresponding PIN under User PIN.
  4. Click Save and close.

The HSM is now connected.

Frequently asked questions

Next steps

Step 5: Configuring your market partner account