Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure properties for customer-supplied key

Review the system properties for the ephemeral public wrapping key that your instance uses to unwrap customer-supplied keys.

Before you begin

Role required: sn_kmf.admin or sn_kmf.cryptographic manager

About this task

You must wrap your symmetric data encryption key with a ServiceNow ephemeral public wrapping key before you can upload it to your instance.

When your key is uploaded to your instance, the instance unwraps it using the private side of the public key.

You can use system properties on your instance to define key padding, ephemeral key pair size, and a key validity period for this ephemeral public key.

System PropertyDescriptionDefault value
glide.kmf.ephemeral\_key.key\_paddingKey padding scheme for the ephemeral key.`OAEPWithSHA256AndMGF1Padding`OAEP SHA256, but SHA1 is supported.
glide.kmf.ephemeral.key\_sizeKey size of the ephemeral key pair.`4096`4096 bits, but 2048 bits are also supported.
Glide.kmf.ephemeral\_key.key\_validity\_periodPeriod for which the ephemeral key pair is valid.`02:00:00`2 Hours

Procedure

  1. Contact ServiceNow Support if you need to change any of these properties.

    Note: These system properties are not visible to admins, and do not appear in the System properties [sys_properties] list. Use the table above to see their default values.

What to do next

Once your properties are configured to your needs, proceed to Wrap your customer-supplied key.

Parent Topic:Configure Customer-supplied keys for Field Encryption Enterprise