Skip to main content
POST
/
connections
/
{id}
/
keys
Create connection keys
curl --request POST \
  --url https://{tenantDomain}/api/v2/connections/{id}/keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "signing_alg": "RS256"
}
'
[
  {
    "kid": "<string>",
    "cert": "-----BEGIN CERTIFICATE-----\r\nMIIDDTCCA...YiA0TQhAt8=\r\n-----END CERTIFICATE-----",
    "fingerprint": "CC:FB:DD:D8:9A:B5:DE:1B:F0:CC:36:D2:99:59:21:12:03:DD:A8:25",
    "thumbprint": "CCFBDDD89AB5DE1BF0CC36D29959211203DDA825",
    "pkcs": "-----BEGIN PKCS7-----\r\nMIIDPA....t8xAA==\r\n-----END PKCS7-----",
    "current": true,
    "next": true,
    "current_since": "<string>",
    "algorithm": "<string>",
    "key_use": "encryption",
    "subject_dn": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

ID of the connection

Body

​
signing_alg
enum<string>

Selected Signing Algorithm

Available options:
RS256,
RS384,
RS512,
PS256,
PS384,
ES256,
ES384

Response

Connection keys successfully created.

​
kid
string
required

The key id of the signing key

Maximum string length: 255
​
cert
string
default:-----BEGIN CERTIFICATE----- MIIDDTCCA...YiA0TQhAt8= -----END CERTIFICATE-----
required

The public certificate of the signing key

Maximum string length: 4096
​
fingerprint
string
default:CC:FB:DD:D8:9A:B5:DE:1B:F0:CC:36:D2:99:59:21:12:03:DD:A8:25
required

The cert fingerprint

​
thumbprint
string
default:CCFBDDD89AB5DE1BF0CC36D29959211203DDA825
required

The cert thumbprint

Maximum string length: 255
​
pkcs
string
default:-----BEGIN PKCS7----- MIIDPA....t8xAA== -----END PKCS7-----

The public certificate of the signing key in pkcs7 format

Maximum string length: 4096
​
current
boolean
default:true

True if the key is the current key

​
next
boolean

True if the key is the next key

​
current_since
string

The date and time when the key became the current key

​
algorithm
string

Signing key algorithm

​
key_use
enum<string>

Signing key use, whether for encryption or signing

Available options:
encryption,
signing
​
subject_dn
string
Maximum string length: 132