You can modify information about a device such as a tape drive in the IBM Security Guardium Key Lifecycle Manager database. For example, you can update the
specification for a partner certificate that the drive uses, or specify an alternate device group
within the same device family.
About this task
Before you begin, create the certificates that you need to associate with the devices that you
are about to modify. If you use the REST interface, obtain the value of the uuid for the device that
you intend to update. Also, obtain the alias of any certificate that is associated with the
drive.
You can use the Modify Tape Drive dialog or the Device
Update REST Service to update a device, or specify an alternate device group within the
same device family. Your role must have permissions to the modify action and to
the appropriate device group.
Procedure
- Using graphical user interface
- Log in to the graphical user interface.
- In the Key and Device Management section on the
Welcome page, select 3592.
- Click . Alternatively, right-click 3592 and select
Manage keys and devices.
- On the management page for
3592
, select a drive in the
Tape Drives column.
- Click Modify.
- Alternatively, right-click a drive and then select Modify, or
double-click a drive entry.
- In the Modify Tape Drive dialog, type the required and optional
information. Then, click Modify Tape Drive.
- Using REST interface
- Open the Swagger UI. For more information, see Using Swagger UI.
- Authenticate and authorize to access the REST APIs. For more information, see Authentication process for REST services.
- Use the Device List REST Service to locate a device and
Device Update REST Service to update a device. For example, you can send the
following HTTP requests:
GET https://localhost:port/SKLM/rest/v1/devices?type=3592
Content-Type: application/json
Accept : application/json
Authorization : SKLMAuth userAuthId=37ea1939-1374-4db7-84cd-14e399be2d20
Accept-Language : en
PUT https://localhost:port/SKLM/rest/v1/devices
Content-Type: application/json
Accept : application/json
Authorization: SKLMAuth authId=139aeh34567m
{"uuid":"DEVICE-64c588ad-5ed8-4934-8c84-64cb9e11d990","attributes":
"aliasTwo myPartner99"}
What to do next
Next, verify that the changes are made. For optional fields, such as the description,
you might want to run the Device List REST Service to determine whether the
value is changed. Alternatively, reopen the Modify Tape Drive dialog.