- URL:https://<root>/security/certificates/identity/import(POST only)
- Required Capability:Default administrator role | Security and infrastructure
- Version Introduced:10.9
Description
The import operation imports an existing identity certificate in PKCS #12 format (.pfx file) into the keystore. An imported certificate can be assigned to the ingress controller by setting the certificate name in the identityCertificateName property of the update operation.
Request parameters
Parameter | Details |
---|---|
certificateName (Required) | A unique, easily identifiable, public-facing name for the certificate. |
certificatePassword (Required) | The password used to unlock the file containing the certificate. |
certificatePfxFile (Required) | The PKCS #12 certificate file (.pfx). |
f | The response format. The default format is html. Values: html | json | pjson |
Example usage
The following is a sample POST request for the import operation:
POST /context/admin/security/certificates/identity/import HTTP/1.1
Host: organization.domain.com
Content-Type: multipart/form-data; boundary=----boundary
------boundary
Content-Disposition: form-data; name="certificateName"
IdentityCert
------boundary
Content-Disposition: form-data; name="certificatePassword"
sampleCertPassword
------boundary
Content-Disposition: form-data; name="certificatePfxFile"; filename=""
Content-Type: application/octet-stream
my_identityCert.pfx
------boundary
Content-Disposition: form-data; name="f"
pjson
------boundary
Content-Disposition: form-data; name="token"
1Qnjkn_G1Fcgc0CtuIW4cywdKl2PnKH2t_hzngmO8irdflstsIxCUAQ_W8lPkENcmYVm18AEX45ef2XRLUNcjAQSdILD7Lu7mPAAx6K4OPwpV4IDbwDRNH2CLkU042HVslLXO3fNrMQKiL9lJ9ddih84fBDDrF_F_Y_CYZK2wnwO4W7P-WcPBIqaLNHLKmFVjzSks94Ke8ZDvY7FWlCDKFKlv4fy040gQn4QSMOzFMWOWlfOID-f8y2Y8mKcB6Ir
------boundary--
JSON Response example
{"status": "success"}