Oracle Cloud Infrastructure Documentation

Enabling and Updating Auto Key Rotation

Learn about enabling automatic key rotation, and about updating automatic rotation settings for keys that already have this feature enabled.

Note

This feature is available only for virtual private vaults.

You can update automatic key rotation settings to do the following:

  • Enable automatic rotation for keys that don't have this feature enabled
  • Update the date on which the next rotation happens
  • Update the rotation interval (the number of days, between 60 and 365, that pass before a key is rotated)

Manual Key Rotation

See Rotating a Key for information on manually rotating an encryption key. See Key Versions & Rotations in the the Key and Secret Management Concepts topic for an overview of key rotation.

    1. On the Master Encryption Keys list page, find the key that you want to work with. If you need help finding the list page, see Listing Keys.
    2. In the Key Information tab, select Actions, then select Edit auto-rotation settings.
    3. In the Edit auto-rotation settings page, update the following as needed:
      • Auto rotation: Select this checkbox to enable auto rotation.
      • Start date: Use this field to select the date that auto rotation begins for your key.
      • Rotation interval: Specify the number of days between rotations. You can enter a value between 60 and 365 days.
    4. Select Update.

  • Use the oci kms management key update command and required parameters to edit the auto rotation settings of keys in virtual private vaults.

    oci kms management key update --key-id <key_ocid> --is-auto-rotation-enabled <true | false> --auto-key-rotation-details <key_rotation_details_json> --endpoint <kmsmanagement_control_plane_URL>

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Use the UpdateKey API with the Management Endpoint to update automatic key rotation settings for a virtual private vault key.

    Note

    The Management Endpoint is used for management operations including Create, Update, List, Get, and Delete. The Management Endpoint is also called the control plane URL or the KMSMANAGEMENT endpoint.

    The Cryptographic Endpoint is used for cryptographic operations including Encrypt, Decrypt, Generate Data Encryption Key, Sign, and Verify. The Cryptographic Endpoint is also called the data plane URL or the KMSCRYPTO endpoint.

    You can find the management and cryptographic endpoints in a vault's details metadata. See Getting a Vault's Details for instructions.

    For regional endpoints for the Key Management, Secret Management, and Secret Retrieval APIs, see API Reference and Endpoints.

    For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.