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

Manage Quorum Control

After a withdrawal operation workflow is triggered, quorum actions can be managed from the Key Management Operations page. The key withdrawal operation is blocked until the quorum is met.

Before you begin

Role required: sn_kmf.admin or sn_kmf.cryptographic_manager

When the quorum has been either approved or rejected, the requestor of the key withdrawal will receive an email notating if quorum was achieved or denied.

Procedure

  1. Perform the steps to withdraw a customer managed key found in Key management operations.

  2. View the Quorum Control Requests and Quorum Control Approvers tabs that activated.

Image omitted: key-def-table.png
Shows the quorum control tabs.
  1. Open the Quorum Control Requests tab to view the actual request that is created.

    • State:
      • Open: The key withdrawal action is pending the quorum being met.
      • Closed Complete: The quorum has been met and can be no further action on this particular quorum request.
    • Approval:
      • Requested: Approval emails have been sent and the workflow has been triggered to reach quorum.
      • Approved: The key will be withdrawn and the instance will be shut down.
      • Denied: The quorum request is canceled and no further action is taken with this request. A new withdrawal request will be required to withdraw the key.
    • Open the Quorum Control Approvers tab to view the list of approvers and the state of the approval request.
Image omitted: quorum-ctrl-approvers.png
Displays entries for the quorum control approvers.
State:

-   Requested: The approver has not yet taken action on the approval request.
-   Approved: The request has been approved either from the email or the approvals page.
  1. Select the Key Management Transactions tab to view the progress of the request step for the key withdrawal.

    • Step 0 - Quorum Request: The actual quorum request. The quorum request must be completed in order to trigger the key withdrawal steps.
    • Step 1 - Key Withdrawal: The key withdrawal step. This is composed of steps two through seven.
    • Step 2 - Request_preparation: Creates a request to trigger and the wrapping and rotation.
    • Step 3 - request_integrity_check: Validates that the request is legitimate and secure.
    • Step 4 - request_validation: Validates that there is a request in progress, only one rotate request can process at a time.
    • Step 5 - hsm_key_delete: Makes the call to KeySecure to delete the active key.
    • Step 6 - key_metadata_withdraw: Converts the active key metadata lifecycle state to "destroyed."
    • Step 7 - post_withdraw: Makes a call to shut down the instance.
  2. Approve or deny a quorum control request
    Approve or deny a quorum control request from Key Management Transactions.

  3. Approve or deny a quorum request
    When a quorum request has been created, the minimum number of approvals is required by the members. After a withdrawal operation workflow is triggered, quorum actions can be managed using several methods. The users can grant approvals from the Key Management Operations page, My Approvals in the Instance, or directly from the request email. The key withdrawal operation is blocked until the quorum is met.

Parent Topic:Quorum Control Policy