Search for OpenSSH certificates
Search for openssh certificates using a certificate search query
The certificate search query
query
string | null
A SSHSCQL query to filter the certificates |
|||
fields
array of string | null
The fields that must be present in the response |
|||
sortedBy
array of objects | null (Sort By)
How to sort the results |
|||
Array [
] |
|||
pageIndex
integer | null
Request the page at defined index |
|||
pageSize
integer | null
The number of results per request |
|||
withCount
boolean | null
Add the number of results to the search results |
-
200 The certificate search results
application/jsonresultsarray of objects (OpenSSH Certificate Search Result) requiredThe list of certificates
Array [
idstring (Internal ID) requiredObject internal ID
castring requiredName of the OpenSSH Certificate Authority the certificate is enrolled on
templatestring requiredName of the Template the certificate is enrolled on
certificatestring (OpensshCertificate) requiredtypestring (SSHCertificateType) requiredThe Type of OpenSSH certificate
EnumUSER
HOST
serialstring requiredThe serial number of the certificate
principalsarray of string requiredHostnames covered by the certificate
validAfterstring requiredThe start of the validity period of the certificate
validBeforestring requiredThe end of the validity period of the certificate
publicKeyThumbprintstring requiredThe thumbprint of the public key of the certificate
revokedboolean requiredIf true, the certificate is revoked
keyIdstring requiredpermissionsobject | null (Permissions)The user's permissions on this certificate
revokeboolean requiredIs the user allowed to revoke the certificate or not
revocationDatestring | nullThe revocation date of the certificate
]
pageIndexinteger requiredThe current page index
pageSizeinteger requiredThe current page size
hasMoreboolean requiredtrue while the page is not the last, else false
countinteger | nullThe total number of results. Only available if withCount was requested
-
400 Bad Request
application/problem+jsonerrorstring requiredThe error code of the problem
ValueSSH-CERT-002
messagestring requiredA short, human-readable summary of the problem type
ValueInvalid search query
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInvalid search query
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSTREAMQL-001
messagestring requiredA short, human-readable summary of the problem type
ValueInvalid StreamQL Query
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInvalid StreamQL Query
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
-
401 Unauthorized request
application/problem+jsonerrorstring requiredThe error code of the problem
ValueSEC-AUTH-001
messagestring requiredA short, human-readable summary of the problem type
ValueUnexpected error
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueUnexpected error
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-002
messagestring requiredA short, human-readable summary of the problem type
ValueInvalid credentials or principal does not exist
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInvalid credentials or principal does not exist
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-009
messagestring requiredA short, human-readable summary of the problem type
ValueAuthentication expired
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueAuthentication expired
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-010
messagestring requiredA short, human-readable summary of the problem type
ValuePrincipal not authenticated or authentication expired
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValuePrincipal not authenticated or authentication expired
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
-
403 Forbidden action
application/problem+jsonerrorstring requiredThe error code of the problem
ValueLIC-001
messagestring requiredA short, human-readable summary of the problem type
ValueInvalid License
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInvalid License
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueLIC-002
messagestring requiredA short, human-readable summary of the problem type
ValueExpired License
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueExpired License
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueLIC-003
messagestring requiredA short, human-readable summary of the problem type
ValueModule is not entitled
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueModule is not entitled
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
-
500 Internal Server error
application/problem+jsonerrorstring requiredThe error code of the problem
ValueSSH-CERT-001
messagestring requiredA short, human-readable summary of the problem type
ValueUnexpected Error
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueUnexpected Error
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-001
messagestring requiredA short, human-readable summary of the problem type
ValueUnexpected error
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueUnexpected error
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807