Deleting Security Objects

1.0 Overview

Before deleting a security object, make sure that you have a backup of the security object or do not need the security object anymore. If a security object has the Export operation enabled, it can be backed up by wrapping it and storing it outside of Fortanix-Data-Security-Manager (DSM).

WARNING

Deleting a Security-object cannot be undone.

2.0 Prerequisites

Deleting security objects (keys) requires a Fortanix DSM account, a group, and a user or application consfigured in that group. You must also have a security object to delete. See the Fortanix Data Security Manager Getting Started Guide for more details.

3.0 Authorization and Configuration

You must first authenticate and optionally configure a default API client as described in Configure API Client and Client Authentication. You may authenticate as a user or as an application. The user or application must be a member of the group that the security object belongs to in order to delete it.

4.0 Create a SecurityObjectsApi Client Object

Deleting security objects is performed with a SecurityObjectsApi object.

import com.fortanix.sdkms.v1.SecurityObjectsApi;

SecurityObjectsApi sobjectsApi = new SecurityObjectsApi();

5.0 Make the Delete Call

Deleting is performed with the deleteSecurityObject() method of the SecurityObjectsApi object. The UUID of the key to be deleted is passed to the method.

sobjectsApi.deleteSecurityObject(<UUID of key to be deleted>);sobjectsApi.deleteSecurityObject();