Upload Profile Secret

# Upload Profile Secret

# Overview

Upload a secret key for eSIM profile protection. This API allows you to manage encryption keys used for securing profile data.

# API Information

  • Environment: Production
  • Base URL: https://rsp.simlessly.com/api/v1
  • Endpoint: POST /secret/upload
  • Content-Type: application/json

# Request

# Request Parameters

Parameter Type Required Description Validation Rules Example
secret String Yes Secret key value Hexadecimal string C0190BEBE6FA3168222B89B9B92856ABD6D7A95DA017FA49
algorithm String Yes Encryption algorithm Enum: ["DES", "AES", "DESede"] AES
size Integer Yes Key size in bits Enum: [64, 128, 192, 256] 192
mode String Yes Operation mode Enum: ["NONE", "ECB", "CBC", "OFB", "GCM", "CCM"] ECB
padding String Yes Padding scheme Enum: ["NoPadding", "PKCS1Padding", "PKCS5Padding", "PKCS7Padding"] NoPadding

# Example Request

{
  "secret": "C0190BEBE6FA3168222B89B9B92856ABD6D7A95DA017FA49",
  "algorithm": "AES",
  "size": 192,
  "mode": "ECB",
  "padding": "NoPadding"
}

# Response

# Response Parameters

Parameter Type Required Description Example
success Boolean Yes Operation result status true
code String Yes Response status code "00000"
msg String Yes Response message ""
obj Object Yes Response data object See below
obj.keyIndex String Yes Generated key index "d5d8252d-32d0-44d8-8d4e-10fd45edf61a"

# Success Response Example

{
  "success": true,
  "code": "00000",
  "msg": "",
  "obj": {
    "keyIndex": "d5d8252d-32d0-44d8-8d4e-10fd45edf61a"
  }
}

# Error Response Example

{
  "success": false,
  "code": "E0001",
  "msg": "Invalid secret format",
  "obj": null
}

# Algorithm Support Matrix

Algorithm Supported Sizes Supported Modes Supported Padding
AES 128, 192, 256 ECB, CBC, OFB, GCM, CCM NoPadding, PKCS5Padding, PKCS7Padding
DES 64 ECB, CBC, OFB NoPadding, PKCS5Padding
DESede 192 ECB, CBC NoPadding, PKCS5Padding