HomeUse CasesConceptsConfig GuidesDeveloper GuidesAPI Reference
API Reference

Import or generate a personal certificate.

post
https://{tenanturl}/v1.0/personalcert

Imports or generates a personal certificate for this tenant. The imported or generated personal certificate will be added to the tenant's keystore.

For more details on the required parameters for importing or generating a personal certificate, check the model that is described in the payload.

Entitlements required: manageCerts.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests

LoadingLoading

Body Params

Import payload

string
required

The alias or friendly name that is used to uniquely identify the personal certificate. Required for generating a personal certificate. Optional for importing a personal certificate. Overrides the alias provided in the certificate if provided.

string
required

Distinguished name. The person or entity to whom the certificate is being issued. This field can also include the certificate recipient's organization (O), organization unit (OU), locality (L), state or province (ST), and country/region (C). Only required for generating a personal certificate.

int32
required

The validity period, in days, for the new certificate. Default value is 3650 Only required for generating a personal certificate.

int32
enum
required

The size of the new key pair to be created. Valid values are 1024, 2048 or 4096. Default value is 2048. Only required for generating a personal certificate.

Allowed:
string
required

The algorithm to use to generate the self signed certificate. Default is "SHA256WithRSA". Only required for generating a personal certificate.

boolean

Flag to specify whether the certificate to be imported or generated should be the default one. There can only be one default certificate per tenant, so if this flag is set to true, the certificate overwrites the previous existing default cert. Use this flag with caution. Changing a default certificate may have an impact on the existing applications set up for single sign-on. If not specified, this flag defaults to false. Optional for both importing or generating a personal certificate.

string
required

Base64 encoded bytes of a valid .p12 file. The example shown has been truncated for readability. Only required for importing a personal certificate. For generating a personal certificate, do not provide any value for this parameter.

string
required

Password to unlock the .p12 file. Only required for importing a personal certificate.

Headers
string
required

Authorization Header

Responses
201

Created

Updated over 2 years ago

Language
URL
LoadingLoading

Response
Choose an example:
*/*

Updated over 2 years ago