SSLKeyAndCertificate

Description

API


    POST /api/sslkeyandcertificate
	Query Params: SSLKeyAndCertificateDisplayFilter
    PUT /api/sslkeyandcertificate/<key>
	Query Params: SSLKeyAndCertificateDisplayFilter
    DELETE /api/sslkeyandcertificate/<key>
	Query Params: SSLKeyAndCertificateDisplayFilter
    GET /api/sslkeyandcertificate
	Query Params: SSLKeyAndCertificateDisplayFilter
    GET /api/sslkeyandcertificate/<key>
	Query Params: SSLKeyAndCertificateDisplayFilter

CLI


    configure sslkeyandcertificate <key> filter [export_key]
    show sslkeyandcertificate <key> filter [export_key]

Examples

To generate a self-signed certificate

 POST /api/sslkeyandcertificate/generatecertificate

{
    "self_signed": true, 
    "name": "mycert", 
    "locality": "Sunnyvale", 
    "country": "US", 
    "key_params": {
        "rsa_params": {
            "key_size": "SSL_KEY_1024_BITS"
        }, 
        "algorithm": "SSL_KEY_ALGORITHM_RSA"
    }, 
    "state": "CA", 
    "common_name": "ACME Company", 
    "organization": "ACME Company"
}
 

To generate a CA-signed certificate use the following sample. This will provide a Certificate Signing Request that you will have to use to get a CA-siged certificate

 POST /api/sslkeyandcertificate/generatecertificate

{
    "name": "mycert2", 
    "locality": "Sunnyvale", 
    "country": "US", 
    "key_params": {
        "rsa_params": {
            "key_size": "SSL_KEY_1024_BITS"
        }, 
        "algorithm": "SSL_KEY_ALGORITHM_RSA"
    }, 
    "state": "CA", 
    "common_name": "ACME Company", 
    "organization": "ACME Company"
}
 

To import a CA-signed certificate

 POST /api/sslkeyandcertificate/sslkeyandcertificate-285dc373-cdb9-41b4-973c-1eddd97c0a68/importcertificate

{
    "certificate": "\n-----BEGIN CERTIFICATE-----\nMIICmTCCAgKgAwIBAgIJAKfrg8i8iZZqMA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNV\nBAYTAlVTMQswCQYDVQQIDAJDQTEVMBMGA1UECgwMQWNtZSBDb21wYW55MR0wGwYD\nVQQDDBRTeXN0ZW0gQWRtaW5pc3RyYXRvcjAeFw0xNTAxMTkwNzEyNThaFw0xNjAx\nMTkwNzEyNThaMFAxCzAJBgNVBAYTAlVTMQswCQYDVQQIDAJDQTEVMBMGA1UECgwM\nQWNtZSBDb21wYW55MR0wGwYDVQQDDBRTeXN0ZW0gQWRtaW5pc3RyYXRvcjCBnzAN\nBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAtT9psNKi/4oImbB4aIJLjJDPwTIAIrQP\nLoC4R/GHrBCByRYVfoyxFrHJU9WSg9KTqxc6Ph6/zK2hoR+MchQStMP+K5W+4HcR\nSW+1MJdMwRhm+egxH7hYwnrfsaQoo0GBPVb48deBB/yKTLj7trdGqWTD5oyZqr/B\nk+kR0kXGzx8CAwEAAaN7MHkwCQYDVR0TBAIwADAsBglghkgBhvhCAQ0EHxYdT3Bl\nblNTTCBHZW5lcmF0ZWQgQ2VydGlmaWNhdGUwHQYDVR0OBBYEFNhre4joManxHL+F\nDWzYSVblWVdlMB8GA1UdIwQYMBaAFNhre4joManxHL+FDWzYSVblWVdlMA0GCSqG\nSIb3DQEBCwUAA4GBAINlLdqGJW2Enow2ft+FRMZdo2qwOovuF4smNIFoXmSoywhW\n7dyeAkeCyUjZrbqFRNsCf969aUSIE8pARjSnT9P4otOvIMCaIN215F0nzKKZbsIL\nK4pA6A0h5GSd+aqol6P2vAWzLNE+kUbrE/PcZu9pozWp0GdoiAEu+BnqwWrC\n-----END CERTIFICATE-----\n"
}
 

To import both key and certificate, use the following sample.

 POST /api/sslkeyandcertificate/importkeyandcertificate

{
    "key_passphrase": "avi123", 
    "certificate": "\n-----BEGIN CERTIFICATE-----\nMIIE+DCCAuCgAwIBAgICEAAwDQYJKoZIhvcNAQELBQAwQTELMAkGA1UEBhMCVVMx\nEzARBgNVBAgMCkNhbGlmb3JuaWExHTAbBgNVBAMMFEdyZWcgSW50ZXJtZWRpYXRl\nIENBMB4XDTE2MDIxMTE2MjYyNFoXDTE3MDIyMDE2MjYyNFowPDELMAkGA1UEBhMC\nVVMxEzARBgNVBAgMCkNhbGlmb3JuaWExGDAWBgNVBAMMD3d3dy5leGFtcGxlLmNv\nbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAM47ljnydqleK3Yapr//\nAEqEdPuduGiqgEcY1qjx1vPwO/TU3iqNIJEUEcu/uvHxXqOmsXGUG9+/xMfsV/Lx\nQAqhneXA2fxZtODmnCWq0SldPQi0mD63ir3jFqI+slS+n9ao20krBBYKpgqjstxh\nbSez59h6Aoup8vM226gieMfw9Fac7govovJFQZ+lYywGbe2hzP3vftEoyO8itwdB\novxXk/fmQSDfDPRGSJ4eSve2o8lP9xRRiyqkRKoNQ3UaJRK9L9JSvzdjbvVmUD5S\n4le7sa6N7VgT73OiUFdwndCQNHN95+BMhGibNury7IXVg+yC94WUmp5L1UX8PixZ\nv78CAwEAAaOB/jCB+zAJBgNVHRMEAjAAMBEGCWCGSAGG+EIBAQQEAwIGQDAzBglg\nhkgBhvhCAQ0EJhYkT3BlblNTTCBHZW5lcmF0ZWQgU2VydmVyIENlcnRpZmljYXRl\nMB0GA1UdDgQWBBSqF2GsfFBj6SkSpRjG9oK1cqvm2jBiBgNVHSMEWzBZgBQGr+y3\nQMSnVEKwnT9quMhAYExFEaE9pDswOTELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNh\nbGlmb3JuaWExFTATBgNVBAMMDEdyZWcgUm9vdCBDQYICEAAwDgYDVR0PAQH/BAQD\nAgWgMBMGA1UdJQQMMAoGCCsGAQUFBwMBMA0GCSqGSIb3DQEBCwUAA4ICAQAudoCP\nRNq/keBcTcL19UYo8X4tRwm350U5ccKwiKb8caEE2Crh3dyNyKDN3+ZKl8i8OwWN\nx9PpTJANlmWYuOvhjLtvnkGidcxhCmVEpEms2h3+zrRIXijIENqhWpKzcQus7R6F\nmMxW/KPt0rY80rfrZ2ReCkuhBEZzgL5udYL+AEYkvf7oGD/W18nDCUKEsm8T45jI\ndBVs7PeFaEJSAlDW8T3OekV8CETvafwBx4UK9kHo7+mfZSHCiGhzodF3WGzPnLFs\nB4OptAHfXUjIAEZ9pxdr8C/tXU9dVyQVdHjISKQdtWUBoHSwmZnIuEtWADfRjMi8\ne2Le1qiC0IBMc7JAVZXZ1lbs7A5mKgsUy+1rRUVEkVgmgDfr1BcsstOeXpNcQS4K\nebKterF/ZDmVYJdUD6o91xfAAy1onn1mzKhIfqMeCZEcz4nvuaLM2h5HsIOJPgLL\n5LnaQxl+6cNx1u3+X1crPv0k1hs9yqn72LmD65ZqBpamiwJudSpu1RCPCAdNzzcO\n9v2I8JlXhl0IKRXoAZX+VK1PJmZJ8giRTI+92XOWJlryyknm9Znp1djibZAbLnpI\nrorY/feSmoZFEKUv74n7XrgbveEWjMbkZQHrNNPW0VZ3uXM30E81Wt6fCyyX5GO3\ndTPtEDPf9zp/r0AHZKU+4Bg2ZAkrNMltCAjXSg==\n-----END CERTIFICATE-----\n", 
    "name": "mycert3", 
    "key": "\n-----BEGIN RSA PRIVATE KEY-----\nProc-Type: 4,ENCRYPTED\nDEK-Info: AES-256-CBC,23E2D6132285630DB8D67E25E465F0A6\n\n9sM1JGQHgo+rwuZ5L9piE7EGpp2fvY9QC8GgxEcdfw9OHfcj7CHRCCfXAUsxfBOe\nTh1aGNH9mCmZ72LdrA9cnS/fwISClUoQe0tmVWRTagQptOZfW20HvHI37HGaZ2s1\nMsqvOaqfQ1ZHa0U6WtzBw5/6PqL9LgDUGoQFSEtMHD06nuYoaynpfDk3eoftFwrx\n0U3u0O5lc0a0VqwSvJynSYO1yaxoTzTEDZws4Cf1scLi/Wx5aBQHb5I3k6Dr1Ipm\n59NCpKxjUI+XFUVMszVyQM6+dUUZ0rRU17f2toZFsGTdQ9M1vJLS1J7Ya2pAhlmm\nX7fzy1NywL5kk+jRPWXRNrSKZg+qnutPSPD1689oDNqu4fwycbC+jZ7zJYXB/vio\nagS3/UI8d2Lxs69IPFxwP0lhYuUiSEGfLwDwqEuRZNbvaZpwtp2kC6sf7xlKbQF7\n24lz/LiL5t7xFsLuruOyWfb1fUwLjTZm4O6y8SI9JTSixPm4NCLGclcaTh33harN\nQhsTf0+qMbovgAUv6myfnI4ajPCcu+Kwn2jMjUjWEFf3oj9A1NUfiT4SqiLcZ4AU\nsvR8kHs0+rUVDiZ8kFXH0HQ+LI7itVCRoCooq3uqpqeZ5J8L+hZEeILjGCVNQluU\nlTcEbAry3WibKzsk2bWARe0v+7i/r09EuwSzJ8+H2BOkrxmTr+WgC2RKBMKV+gLc\nu3rxjeddL6hc0qgo2EN/Hp38FrVBwFLrDYHsBVRwdN6OsDW0OP67EJXikMD+qe2+\nuUcXr00Sno+Wcgbm17m9SghESxXBj1N5eok6MSUZxbNlFNhxu4qbpiBDKZOrJ2e/\nn8rxlg9XmJAQPfhY1EKbX7WFiaSa0y4tvbD2tWZfw8Yt97PRSVxumRWg5pbqRr1i\nl7QTNWfIwk25xtIW5q4WnHjuVynurnREYdlTVd/vBsQcrgV0vaPVYEq+iFzkZBOy\na0Z0001SHqsQE6ThC2+7ap855EKPpU7HxXqOAEas9z4C9HGgPogSFKT9H5MrDY2C\nynuoU44hQ/qmR5TAfjO8OnBeLlAlPk0VpEAaOX5V7t8PWhhkAz3QRbQAPbDQ5BQx\naGnBmi4/12h4EywHUdacj4/9uvUPVd1E476mxePfsDr+E3wtYqUWBzgHtoDxJ9Qn\nSAL5hU3GrL3mEQQ1RK8kITANVXmlFa56XZXqGuYKxUfGGDGhLTE/VYh13I37hVZH\nQ825Y+WqZRiRsRvV9W/Wq8H5I2+QU1flB1+kqpoVTxDhzJ15dOetZDTYXqjs6gMS\nQpr/dYub0yR0zwmV1EKpuqchoYcwHpG4gsX42NRCfcdYoIxoa1Drr/xX4L0si40z\npY00CT/YuCAJFxbhpzlqKnZz3okj8vzPocT8mjFZcajnyOtaWyILnrBKO/93tkEF\nYednFMpQ2xdlq5bebhrZhYkf6XS21N8t1ETropoOX19Eh33yJUHh/rJ67I1ccRvZ\neSI1LDB18B6+k2BdYCfjEhc33WgqUmoHEjxLYEdN0N0qr4ZG2JznQ9R7h/SQusGo\nwG1rwolI5lxqX/M53KXoBoH1UcZp1yg/8qG2e8Ntx41a6j79oPh7YkXvJYHDh/xt\n-----END RSA PRIVATE KEY-----\n"
}
 

Data

SSLKeyAndCertificate

uuid

Type
string
Category
required
Description

name

Type
string
Category
required
Description

type

Type
enum
Category
optional
Description
Default
SSL_CERTIFICATE_TYPE_VIRTUALSERVICE
Choices
SSL_CERTIFICATE_TYPE_VIRTUALSERVICE, SSL_CERTIFICATE_TYPE_SYSTEM, SSL_CERTIFICATE_TYPE_CA

certificate

Type
SSLCertificate
Category
required
Description

key_params

Type
SSLKeyParams
Category
optional
Description

key

Type
string
Category
optional
Description
Private key

status

Type
enum
Category
optional
Description
Default
SSL_CERTIFICATE_FINISHED
Choices
SSL_CERTIFICATE_FINISHED, SSL_CERTIFICATE_PENDING

ca_certs

Type
CertificateAuthority
Category
repeated
Description
CA certificates in certificate chain

enckey_base64

Type
string
Category
optional
Description
Encrypted private key corresponding to the private key (e.g. those generated by an HSM such as Thales nShield)

enckey_name

Type
string
Category
optional
Description
Name of the encrypted private key (e.g. those generated by an HSM such as Thales nShield)

hardwaresecuritymodulegroup_ref

Type
Reference to HardwareSecurityModuleGroup
Category
optional
Description

tenant_ref

Type
Reference to Tenant
Category
required
Description

certificate_management_profile_ref

Type
Reference to CertificateManagementProfile
Category
optional
Description

dynamic_params

Type
CustomParams
Category
repeated
Description
Dynamic parameters needed for certificate management profile

created_by

Type
string
Category
optional
Description
Creator name

SSLCertificate

version

Type
string
Category
optional
Description

serial_number

Type
string
Category
optional
Description

self_signed

Type
bool
Category
optional
Description

issuer

Type
SSLCertificateDescription
Category
optional
Description

subject

Type
SSLCertificateDescription
Category
optional
Description

key_params

Type
SSLKeyParams
Category
optional
Description

public_key

Type
string
Category
optional
Description

signature_algorithm

Type
string
Category
optional
Description

signature

Type
string
Category
optional
Description

not_before

Type
string
Category
optional
Description

not_after

Type
string
Category
optional
Description

certificate

Type
string
Category
optional
Description

certificate_signing_request

Type
string
Category
optional
Description

text

Type
string
Category
optional
Description

fingerprint

Type
string
Category
optional
Description

expiry_status

Type
enum
Category
optional
Description
Default
SSL_CERTIFICATE_GOOD
Choices
SSL_CERTIFICATE_GOOD, SSL_CERTIFICATE_EXPIRY_WARNING, SSL_CERTIFICATE_EXPIRED

chain_verified

Type
bool
Category
optional
Description

subject_alt_names

Type
string
Category
repeated
Description
subjectAltName that provides additional subject identities

days_until_expire

Type
int32
Category
optional
Description
Default
365

SSLCertificateDescription

common_name

Type
string
Category
optional
Description

email_address

Type
string
Category
optional
Description

organization_unit

Type
string
Category
optional
Description

organization

Type
string
Category
optional
Description

locality

Type
string
Category
optional
Description

state

Type
string
Category
optional
Description

country

Type
string
Category
optional
Description

distinguished_name

Type
string
Category
optional
Description

SSLKeyParams

algorithm

Type
enum
Category
required
Description
Default
SSL_KEY_ALGORITHM_RSA
Choices
SSL_KEY_ALGORITHM_RSA, SSL_KEY_ALGORITHM_EC

rsa_params

Type
SSLKeyRSAParams
Category
optional
Description

ec_params

Type
SSLKeyECParams
Category
optional
Description

SSLKeyRSAParams

key_size

Type
enum
Category
optional
Description
Default
SSL_KEY_2048_BITS
Choices
SSL_KEY_1024_BITS, SSL_KEY_2048_BITS, SSL_KEY_3072_BITS, SSL_KEY_4096_BITS

exponent

Type
uint32
Category
optional
Description
Default
65537

SSLKeyECParams

curve

Type
enum
Category
optional
Description
Default
SSL_KEY_EC_CURVE_SECP256R1
Choices
SSL_KEY_EC_CURVE_SECP256R1, SSL_KEY_EC_CURVE_SECP384R1, SSL_KEY_EC_CURVE_SECP521R1

CertificateAuthority

name

Type
string
Category
optional
Description

ca_ref

Type
Reference to SSLKeyAndCertificate
Category
optional
Description

CustomParams

name

Type
string
Category
required
Description

value

Type
string
Category
optional
Description

is_sensitive

Type
bool
Category
optional
Description
Default
False

is_dynamic

Type
bool
Category
optional
Description
Default
False

References

CertificateManagementProfile HardwareSecurityModuleGroup Tenant SSLKeyAndCertificate

Sub Objects

Filters

SSLKeyAndCertificateDisplayFilter

export_key

Type
bool
Category
optional
Description
Set export_key to export the private key. By default, the private key is not exported