Cloud - Quickstart

SKA

If you new to develop applications with an Securosys-HSM's, you can get a developer account with Securosys for free. With this account you will receive your own partition on a Primus X-Series HSM and the necessary login credentials. This access is for development purposes only.

For more information please contact info@securosys.ch to get a developer account.

Initial Connection

The following HTTP request returns the current software version of the REST-API.

CURL

Replace <REPLACE_WITH_YOUR_JWT_TOKEN>.

You may replace the API-Endpoint https://primusdev.cloudshsm.com/ in the following by a TSBaaS - Connectivity Details for accurate API-Endpoint URI.

curl -X "GET" "https://primusdev.cloudshsm.com/v1/versionInfo" -H "accept: application/json" -H "Authorization: Bearer <REPLACE_WITH_YOUR_JWT_TOKEN>"

Response:

{"Version":"1.17.1.20231211T114600"}

Browser (Swagger-UI)

You may replace the API-Endpoint https://primusdev.cloudshsm.com/ in the following by a TSBaaS - Connectivity Details for accurate API-Endpoint URI.

1. To interact with the Rest-API in your browser navigate to the following URL: https://primusdev.cloudshsm.com/swagger-ui/index.html

2. Please consider checking you support-ticket for credentials, to get the correct URL and JWT-Token.

3. To authenticate against the HSM via Rest-API and to access your HSM-Partition, follow the below steps:

4. Click Authorize
   
   

5. Enter the JWT-Token
   
   

6. Click Authorize and then Close

7. Navigate to the API-Section Service Information

8. Click on /v1/versionInfo, Try-Out and Execute

Response

{
  "Version": "1.17.1.20231211T114600"
}

---

What's next?

• Follow the instructions to Create a Key and use it to encrypt and decrypt a payload
• File Encryption Sample
• Sign and Verify a payload Sample
• More Tutorials