Change the status of an AWS KMS Key

task brazil Updated Sep 10, 2026 4 min read ekms-change-status-aws-kms-key.md
Raw file servicenow.com

Modify the status of your Amazon Web Services Key Management System (AWS KMS) key and synchronize the status with your ServiceNow instance.

Before you begin

Roles required: admin, security_admin, and sn_kmf.cryptographic_manager

Verify that you have:

  • Configured an External Key Management Service (EKMS) in ServiceNow
  • Permissions to modify key status in AWS

About this task

AWS KMS keys can have different statuses that control whether they can be used for encryption and decryption operations. Changing a key's status in AWS affects your ability to encrypt new data and decrypt existing data in External Key Management Service (EKMS). A background synchronization job updates EKMS with the current AWS key status every 30 minutes.

Important: Key status changes have immediate security and operational impacts. Coordinate all key status changes with your ServiceNow administrators and application teams before making changes.

Procedure

  1. Access AWS Key Management Service.

    1. Log in to AWS through your Okta profile.

    2. Navigate to AWS Key Management Service (KMS).

    3. Locate the key that is configured in your ServiceNow EKMS setup.

      Reference your EKMS configuration in ServiceNow to identify the correct key by its external key identifier or key region.

  2. Review the current key status.

    AWS KMS keys can have the following statuses:

    • Enabled - Key is active and can be used for all encryption and decryption operations.
    • Disabled - Key can't be used for encryption or decryption until re-enabled.
    • Pending deletion - Key is scheduled for deletion and can't be used.
    • Deleted - Key has been permanently deleted (appears after minimum 7-day waiting period).
  3. Change the key status based on your requirements.

    • To enable a disabled key: Select the key, select Key actions, and choose Enable.
    • To disable an enabled key: Select the key, select Key actions, and choose Disable.
    • To cancel a scheduled deletion: Select the key, select Key actions, and choose Cancel key deletion.
    • To schedule a key for deletion: Select the key, select Key actions, choose Schedule key deletion, and specify the waiting period (7 to 30 days). Warning: Disabling or deleting a key will prevent ServiceNow from encrypting new data and decrypting existing data. Verify that you have a plan for data migration or key recovery before disabling or scheduling deletion.
  4. Wait for the scheduled synchronization job to process the key status change.

    EKMS automatically synchronizes AWS key status every 30 minutes through a background job. The job will detect and update the key status change in your instance within 30 minutes.

  5. Verify the key status updated in EKMS.

    See Check External Key Management Service key status.

    The AWS key status is synchronized with EKMS.

Result

The new status is reflected in your EKMS configuration, and encryption and decryption operations behave according to the new key status.

When you disable a key in AWS, ServiceNow provides multiple notifications to alert administrators:

  • The External Key Status field changes to "Disabled" on the EKMS Configuration page.
  • A high-priority security task is automatically created in Security Center notifying administrators that the EKMS key was disabled. To view notifications, navigate to All > Security Center > Overview. See Security Center.

While the key is disabled, you can't encrypt or decrypt data in encrypted fields. You can still create records if the encrypted field isn't a required field, and you can update non-encrypted fields in existing records. All cryptographic operations are blocked until the key is re-enabled in AWS.

What to do next

Important considerations after changing key status:

  • If you disabled the key: New data cannot be encrypted, and existing encrypted data cannot be decrypted until the key is re-enabled. Plan for how encrypted fields should be handled during this time.
  • If you enabled a previously disabled key: Encryption and decryption operations resume once the synchronization job updates the key status in EKMS (within 30 minutes). Test your EKMS Configuration by clicking the Test button. Then verify that all encrypted fields are accessible.
  • If you scheduled the key for deletion: You have 7 to 30 days (depending on your deletion schedule) to cancel the deletion before the key is permanently deleted. After permanent deletion, encrypted data can't be recovered.
  • If you canceled a scheduled deletion: Remember to enable the key if it was disabled. Canceling deletion does not automatically enable the key.

Important: The automatic synchronization job runs every 30 minutes. EKMS automatically detects status changes within 30 minutes of when they occur in AWS.

AWS requires a minimum 7-day waiting period for key deletion. During this period, the key status shows as "Pending deletion" in both AWS and EKMS. Keys can't be used while pending deletion. After seven days, the key is permanently deleted and can't be recovered. All data encrypted with a deleted key becomes permanently inaccessible.

Parent Topic:Using External Key Management Service

Related topics

External Key Management Service

Configure an external key definition

Check External Key Management Service Key Status

Search documentation
Search document titles and file paths on the brazil branch