The page has been translated by Gen AI.

How-to guides

The user can enter the essential information of the Key Management Service service and create the service by selecting detailed options through the Samsung Cloud Platform Console.

Key Management Service creation

You can create and use the Key Management Service on the Samsung Cloud Platform Console.

To create a Key Management Service, follow the following procedure.

  1. All services > Security > Key Management Service menu is clicked. It moves to the Service Home page of Key Management Service.
  2. Service Home page, click the Key Management Service creation button. It moves to the Key Management Service creation page.
  3. Key Management Service creation page, enter the information required for service creation and add additional information.
  • Service Information Input area, please enter or select the required information.
    Classification
    Mandatory
    Detailed Description
    Key NameRequiredEnter Key Name
    Public Certification AlgorithmOptionSelect whether to use the public certification algorithm
    • The public certification algorithm option is only available in SCP Sovereign
    • The public certification algorithm provides the Aria algorithm that has completed security verification by the National Intelligence Service
    PurposeRequiredSelect the purpose and encryption method of the key
    Automatic RotationOptionSelect whether to use automatic rotation of the key
    • Use is selected, the internal algorithm of the generated key is converted to a different value and applied for each set rotation cycle
    Auto Rotation > Rotation PeriodRequiredEnter the rotation period of the key
    • The rotation period can enter a value between 1~730 days. If the rotation period is not entered, it is automatically set to 90 days
    DescriptionOptionsEnter additional information for the key
    Table. Key Management Service service information input items
  • Additional Information Input area, please enter or select the required information.
    Classification
    Mandatory
    Detailed Description
    TagSelectionAdd Tag
    • Up to 50 can be added per resource
    • Click the Add Tag button and enter or select Key, Value
    Table. Key Management Service Additional Information Input Items
  1. Summary panel, review the detailed information generated and the estimated billing amount, and click the Complete button.
  • Once creation is complete, check the created resource on the Key Management Service list page.

Key Management Service detailed information check

Key Management Service can check and modify the entire resource list and detailed information. The Key Management Service details page consists of details, tags, and operation history tabs.

Key Management Service detailed information to confirm, please follow the next procedure.

  1. All services > Security > Key Management Service menu is clicked. It moves to the Service Home page of Key Management Service.
  2. Service Home page, click the Key Management Service menu. It moves to the Key Management Service list page.
  3. Key Management Service list page, click the resource to check the detailed information. It moves to the Key Management Service details page.
  • Key Management Service details page top displays the status information and additional features description.
    ClassificationDetailed Description
    StatusIndicates the status of Key Management Service
    • Active: Available/Activated
    • Stop: Stopped/Deactivated
    • To be Terminated: Scheduled for Deletion
    • Creating: Being Created/Creation Error (Only immediate deletion is possible for retrying creation)
    Key RotationA button that can manually rotate the generated key
    Key Deactivationa button that can deactivate the generated key
    Service CancellationButton to cancel the service
    Table. Key Management Service Status Information and Additional Features

Detailed Information

Key Management Service list page where you can check the detailed information of the selected resource and modify the information if necessary.

Classification
Detailed Description
ServiceService Name
Resource TypeResource Type
SRNUnique resource ID in Samsung Cloud Platform
Resource NameResource Title
Resource IDUnique resource ID in the service
CreatorThe user who created the service
Creation TimeThe time when the service was created
Key NameName of the generated key
Public Certification AlgorithmCryptographic algorithm verified through the Korea Cryptographic Module Validation Program
  • When selected, it is possible to generate an encryption key that meets the public encryption standards
  • The public certification algorithm option is only available on SCP Sovereign
PurposePurpose of the key such as encryption/decryption and signing/verification and encryption method
Automatic RotationWhether to use automatic rotation of the key
Rotation PeriodSet the rotation period when using auto-rotation
Next rotation dateDisplay of the next rotation date of the key according to the rotation cycle
  • Automatically execute key rotation on the corresponding date
usage countthe number of times the key is used to call the encryption/decryption function
DescriptionDisplay additional description for the key
Table. Key Management Service detailed information tab items

Tag

Key Management Service list page where you can check the tag information of the selected resource, and add, change or delete it.

ClassificationDetailed Description
Tag ListTag list
  • Check Key, Value information of the tag
  • Up to 50 tags can be added per resource
  • Search and select from existing Key and Value lists when entering tags
Table. Key Management Service tags tab items

Work History

Key Management Service list page where you can check the operation history of the selected resource.

ClassificationDetailed Description
Work HistoryWork Performance Contents
  • Encryption, Decryption, Signing, Verification, Data Key Generation, Rewrap API Log Item Display
Work TimeWork Performance Time
Resource TypeResource Type
Resource NameResource Title
Task ResultTask Execution Result(Success/Failure)
Worker InformationInformation of the user who performed the task
Table. Key Management Service job history tab detailed information items

Key Management Service management

You can create a new version of the registered key or change its usage status.

KMS Key Rotation Settings

Key rotation is a function that converts the internal algorithm of the generated key into another value.

Note
  • When rotating the key, only the master key value is changed, and the ciphertext and plaintext values of the data key created previously are not changed.
  • Even if the key rotation is performed, the master key has the previous version of the data, so there is no effect on the decryption performed through the master key, and the value of the data key being used is also not changed.
  • However, if you wrap (decrypt and re-encrypt) with a changed master key, calling the rewrapData API will execute the key rotation function.

To create a new version of the created Key Management Service (key rotation), follow these steps.

  1. All services > Security > Key Management Service menu is clicked. It moves to the Service Home page of Key Management Service.
  2. Service Home page, click the Key Management Service menu. It moves to the Key Management Service list page.
  3. Key Management Service list page, click on the resource to check the detailed information. It moves to the Key Management Service details page.
  4. Key Management Service details page, click the key rotation button. It moves to the key rotation popup window.
  5. Key Rotation popup window, check the message and click the Confirm button.

KMS Key Activation Settings

You can set whether to use the selected key.

Reference
If you change the key to an inactive state, users who use the key can no longer use the key.

To set whether to enable or disable the created Key Management Service, follow the next procedure.

  1. All services > Security > Key Management Service menu is clicked. It moves to the Service Home page of Key Management Service.
  2. Service Home page, click the Key Management Service menu. It moves to the Key Management Service list page.
  3. Key Management Service list page, click on the resource to check the detailed information. It moves to the Key Management Service details page.
  4. Key Management Service details page, click the key activation/key deactivation button. Move to the key activation/key deactivation popup window.
  5. Key Activation/Key Deactivation popup window, check the message and click the Confirm button.

Key Management Service utilizing keys for encryption cases

The procedure example for storing important data of the user Application by issuing a data key from KMS and encrypting it is as follows.

  1. Application startup, when KMS master key information is used to issue a data key, and then the data key in plain text form is used on the client-side to perform secure data encryption and storage.
  2. The data key is stored in the database in the form encrypted with the master key.
  3. When performing security data decryption, it requests decryption with KMS master key information by querying the data key stored in the database.

Key Management Service uses the key for encryption/decryption procedures, which are explained in the following concept diagram.

Encryption

Encryption procedure example
Figure. KMS encryption procedure example

Decryption

Decryption procedure example
Figure. KMS decryption procedure example

Key Management Service Cancellation

You can cancel the Key Management Service that is not being used.

Caution
If the key is revoked, all requests and functions of the Key Management Service will be unavailable, and it will be permanently deleted immediately or 72 hours later through scheduled revocation.

To cancel the Key Management Service, follow the following procedure.

  1. All services > Security > Key Management Service menu, click. It moves to the Service Home page of Key Management Service.
  2. Service Home page, click the Key Management Service menu. It moves to the Key Management Service list page.
  3. Key Management Service list page, click the resource to check the detailed information. It moves to the Key Management Service details page.
  4. Key Management Service details page, click the service cancellation button. It moves to the service cancellation pop-up window.
  5. Service Cancellation popup window, select Immediate Cancellation/Reserved Cancellation and confirm the contents, then click the Confirm button.
  6. Once the cancellation is complete, check if the resource has been cancelled on the Key Management Service list page.
  • Key deletion notification will be sent to both the user who created the key and the user who deleted it when the key deletion is completed.
Reference
  • You can also deactivate the selected key by clicking the Cancel Service button in the More Menu button at the far right of the generated KMS list.
  • To cancel the cancellation of a reserved service, click the Cancel Cancellation button on the KMS list page or detail page.
  • Service Cancellation Cancellation In the popup window, if you click Confirm, the selected key will be restored to an inactive state without being deleted.
  • To reuse the key, click the Key Activation button on the Key Management Service details page.
Overview
Key Management Service Encryption example using keys