---
updatedAt: 2026-06-15T13:51:20.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/llms.txt
---

# Parse the certificate to get details about certificate type and keys needed to upload certificate file


Parse the certificate to get details about certificate type and keys needed to upload certificate file.

> 📋 **Required privilege:** Update SSO Settings

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Jamf Pro API",
    "termsOfService": "https://www.jamf.com/developer-resources/api-license-agreement",
    "version": "11.33.0"
  },
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/api"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false
  },
  "security": [
    {
      "Bearer": []
    },
    {
      "ApiClient": []
    },
    {
      "BasicAuth": [
        "/v1/auth/token"
      ]
    }
  ],
  "paths": {
    "/v2/sso/cert/parse": {
      "post": {
        "tags": [
          "sso-certificate"
        ],
        "summary": "Parse the certificate to get details about certificate type and keys needed to upload certificate file\n",
        "description": "Parse the certificate to get details about certificate type and keys needed to upload certificate file.\n\n> 📋 **Required privilege:** Update SSO Settings",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SsoKeystoreParse"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successfully parsed the certificate.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SsoKeystoreCertParseResponse"
                }
              }
            }
          },
          "400": {
            "description": "One or more parameters were invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiError"
                }
              }
            }
          }
        },
        "x-action": true,
        "x-required-privileges": [
          "Update SSO Settings"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ApiError": {
        "type": "object",
        "properties": {
          "httpStatus": {
            "type": "integer",
            "description": "HTTP status of the response",
            "example": 400
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiErrorCause"
            }
          }
        }
      },
      "ApiErrorCause": {
        "required": [
          "field"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error-specific code that can be used to identify localization string, etc.",
            "example": "8675309"
          },
          "field": {
            "type": "string",
            "description": "Name of the field that caused the error.",
            "example": "Name"
          },
          "description": {
            "type": "string",
            "description": "A general description of error for troubleshooting/debugging. Generally this text should not be displayed to a user; instead refer to errorCode and it's localized text",
            "example": "I've just picked up a fault in the AE35 unit. It's going to go 100% failure in 72 hours"
          },
          "id": {
            "type": "string",
            "description": "id of object with error. Optional.",
            "nullable": true,
            "example": "3"
          }
        }
      },
      "CertificateKey": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "1"
          },
          "valid": {
            "type": "boolean",
            "example": true
          }
        }
      },
      "SsoKeystore": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SsoKeystoreParse"
          },
          {
            "required": [
              "key",
              "password",
              "type"
            ],
            "type": "object",
            "properties": {
              "keys": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CertificateKey"
                }
              },
              "key": {
                "type": "string",
                "default": " "
              },
              "password": {
                "type": "string",
                "format": "password",
                "writeOnly": true,
                "example": "***"
              },
              "type": {
                "type": "string",
                "example": "PKCS12",
                "enum": [
                  "PKCS12",
                  "JKS",
                  "NONE"
                ]
              },
              "keystoreSetupType": {
                "type": "string",
                "example": "UPLOADED",
                "enum": [
                  "NONE",
                  "UPLOADED",
                  "GENERATED"
                ]
              }
            }
          }
        ]
      },
      "SsoKeystoreCertParseResponse": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "default": " "
          },
          "keys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CertificateKey"
            }
          },
          "type": {
            "type": "string",
            "example": "PKCS12",
            "enum": [
              "PKCS12",
              "JKS",
              "NONE"
            ]
          },
          "keystoreSetupType": {
            "type": "string",
            "example": "UPLOADED",
            "enum": [
              "NONE",
              "UPLOADED",
              "GENERATED"
            ]
          },
          "keystoreFile": {
            "type": "array",
            "example": "ZXhhbXBsZSBvZiBhIGJhc2U2NCBlbmNvZGVkIHZhbGlkIHAxMi4ga2V5c3RvcmUgZmlsZQ==",
            "items": {
              "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$",
              "type": "string",
              "format": "byte"
            }
          },
          "keystoreFileName": {
            "type": "string",
            "example": "keystore.p12"
          }
        }
      },
      "SsoKeystoreParse": {
        "required": [
          "keystoreFile",
          "keystoreFileName",
          "keystorePassword"
        ],
        "type": "object",
        "properties": {
          "keystorePassword": {
            "type": "string",
            "format": "password",
            "writeOnly": true,
            "example": "***"
          },
          "keystoreFile": {
            "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$",
            "type": "string",
            "format": "byte",
            "example": "WlhoaGJYQnNaU0J2WmlCaElHSmhjMlUyTkNCbGJtTnZaR1ZrSUhaaGJHbGtJSEF4TWk0Z2EyVjVjM1J2Y21VZ1ptbHNaUT09"
          },
          "keystoreFileName": {
            "type": "string",
            "example": "keystore.p12"
          }
        },
        "discriminator": {
          "propertyName": "certType"
        }
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "BasicAuth": {
        "type": "http",
        "description": "Basic auth is used only for obtaining bearer tokens from the /v1/auth/token endpoint",
        "scheme": "basic"
      },
      "ApiClient": {
        "type": "oauth2",
        "description": "Jamf Pro API Roles and Clients provide a client ID and secret for obtaining access tokens using the OAuth2 client_credentials grant type",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "/api/v1/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  }
}
```