Update encryption key

Changes the status of the specified encryption key from AVAILABLE to REVOKED.

A VPN encryption key defines a shared secret between a tenant and the Intelligent Risk Platform. The VPN encryption key enables on-premise SQL Server instances on the tenant's network to connect to the tenant's Data Bridge cluster via a VPN connection.

The VPN encryption key consists of a string of between 8 and 256 characters that is shared between the tenant and the Intelligent Risk Platform.

At any point in time an encryption key is defined by one of three statuses: AVAILABLE, IN-USE, or REVOKED.

StatusDescription
AVAILABLEThe key is unassigned or assigned to a VPN connection with an off VPN status.
IN-USEThe key is assigned to a VPN connection with an on VPN status.
REVOKEDThe encrypton key has been revoked. Once revoked, the encryption key cannot be assigned to a VPN connection.

This operation enables the client application to change the status of the specified encryption key from AVAILABLE to REVOKED. The status of an encryption key cannot be updated while it is IN-USE.

To perform this operation, the client must belong to a group that has been assigned the Admin or Data Bridge Admin role.

🪰

Entitlements

IC-VPN

Path Params
int64
required

ID of encryption key.

Curent status of encryption key must be AVAILABLE. Keys with status of IN-USE cannot be revoked.

Body Params
string
enum
required

Updated status of encryption key.

Allowed:
Responses
200

Success

REVOKED status.

Language
Credentials
URL
LoadingLoading…
Response
Choose an example:
application/json