Palo Alto Networks Issuer Configurations API
APIs for Issuer Configurations.
APIs for Issuer Configurations.
openapi: 3.2.0
info:
title: TLS Protect Cloud API for Strata Cloud Manager Issuer Configurations API
description: Use the TLS Protect Cloud APIs to manage certificates, certificate requests, applications, machine identities, users, teams, event logs, and more. This Open API spec file was created on June 04, 2026. © 2026 Palo Alto Networks, Inc. Palo Alto Networks is a registered trademark of Palo Alto Networks. A list of our trademarks can be found at https://www.paloaltonetworks.com/company/trademarks.html. All other marks mentioned herein may be trademarks of their respective companies.
version: 1.0.0
license:
name: MIT
url: https://opensource.org/license/mit
servers:
- url: https://api.strata.paloaltonetworks.com/ngts
description: Strata Cloud Manager API
security:
- scmToken: []
tags:
- name: Issuer Configurations
description: APIs for Issuer Configurations.
paths:
/v1/distributedissuers/configurations:
post:
description: Adds a new Issuer Configuration, which links the following together - Sub CA Provider, Policies used to determine which certificates can be issued, and the IdP (Identity Provider) the Issuer should trust when receiving signed JWTs from its clients.
operationId: configurations_create
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConfigurationCreateRequest'
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/ExtendedConfigurationInformation'
description: Issuer configuration successfully created; details in response body.
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
'412':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
summary: Create a new Issuer configuration
tags:
- Issuer Configurations
get:
description: Retrieves a list of all Issuer Configurations. Configurations link together Sub CA Providers, Workload Issuance Policies and Identity Provider information. Together these allow an instance of an Issuer to obtain a Sub CA certificate and use it to issue certificates.
operationId: configurations_getAll
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ConfigurationResponse'
description: All Issuer configurations.
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
'412':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
summary: Get the details of all Issuer
tags:
- Issuer Configurations
/v1/distributedissuers/configurations/{id}:
get:
description: Retrieves the details of the existing Issuer configuration for the specified `id`.
operationId: configurations_getById
parameters:
- description: Issuer configuration UUID
in: path
name: id
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ExtendedConfigurationInformation'
description: Specified Issuer configuration found; details in response body.
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Specified Issuer configuration was not found.
'412':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
summary: Get configurations details for a specific
tags:
- Issuer Configurations
patch:
description: Updates (replaces) fields on an Issuer configuration that has the specified `id`. Only fields specified in the request will be updated. Fields not specified in the request are not modified.
operationId: configurations_update
parameters:
- description: Issuer configuration UUID
in: path
name: id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConfigurationUpdateRequest'
description: Issuer configuration's details to update.
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ExtendedConfigurationInformation'
description: Specified Issuer configuration updated; details in response body.
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Specified Issuer configuration was not found.
'412':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
summary: Update an Issuer configuration details
tags:
- Issuer Configurations
delete:
description: Deletes the Issuer configuration for the specified `id`. Before deleting a configuration, be sure no Issuer instances use that configuration, or they will no longer function.
operationId: configurations_delete
parameters:
- description: Issuer configuration UUID
in: path
name: id
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ConfigurationDeleteResponse'
description: Specified Issuer configuration was deleted.
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Issuer configuration was not found.
'412':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse7'
description: Incomplete or malformed request.
summary: Remove an Issuer configuration
tags:
- Issuer Configurations
components:
schemas:
JwtStandardClaimsAuthenticationInformation:
allOf:
- $ref: '#/components/schemas/ClientAuthenticationInformation'
- properties:
audience:
description: Recipients that the JWT is intended for
example: Client1
maxLength: 256
type: string
clients:
description: List with clients, identified by processing JWTs that include standard/registered claims
items:
$ref: '#/components/schemas/JwtClientInformation'
minItems: 1
type: array
type: object
required:
- audience
- clients
type: object
ConfigurationDeleteResponse:
properties:
id:
description: UUID of the configuration
example: 7268d820-a08d-11ed-bbc0-252385d6d389
format: uuid
type: string
name:
description: Name of the configuration
example: Some configuration
type: string
type: object
ConfigurationCreateRequest:
properties:
advancedSettings:
$ref: '#/components/schemas/AdvancedSettingsInformation'
clientAuthentication:
$ref: '#/components/schemas/ClientAuthenticationInformation'
clientAuthorization:
$ref: '#/components/schemas/ClientAuthorizationInformation'
cloudProviders:
$ref: '#/components/schemas/CloudProvidersInformation'
minTlsVersion:
description: Minimum required TLS protocol version
enum:
- TLS12
- TLS13
type: string
name:
description: Name of the configuration
example: Some configuration
maxLength: 64
type: string
policyIds:
description: Array of UUIDs of policies to associate with the new configuration
example:
- 8ae92800-b1e0-11ed-859d-b39255f965ee
format: uuid
items:
format: uuid
type: string
minItems: 1
type: array
serviceAccountIds:
items:
format: uuid
type: string
type: array
subCaProviderId:
description: UUID of Sub CA provider to associate with the new configuration
example: 2f3c6030-b1e0-11ed-a3ed-e3dbaf56a746
format: uuid
type: string
required:
- name
- policyIds
- subCaProviderId
type: object
AnyValue7:
description: Can be any value - string, number, boolean, array or object.
JwtStandardClaimsAuthenticationOpenApi:
allOf:
- $ref: '#/components/schemas/ClientAuthenticationOpenApi'
- properties:
audience:
description: Recipients that the JWT is intended for
example: Client1
type: string
clients:
description: List with clients, identified by processing JWTs that include standard/registered claims
items:
$ref: '#/components/schemas/JwtClient'
type: array
type: object
type: object
ErrorInformation7:
properties:
args:
items:
$ref: '#/components/schemas/AnyValue7'
type: array
code:
format: int32
type: integer
message:
type: string
type: object
ClientAuthorizationInformation:
properties:
customClaimsAliases:
$ref: '#/components/schemas/CustomClaimsAliasesInformation'
type: object
JwtJwksAuthenticationOpenApi:
allOf:
- $ref: '#/components/schemas/ClientAuthenticationOpenApi'
- properties:
urls:
description: Array of JWT JWKS urls
example:
- https://jwks.example.com
items:
type: string
type: array
type: object
type: object
JwtOidcAuthenticationOpenApi:
allOf:
- $ref: '#/components/schemas/ClientAuthenticationOpenApi'
- properties:
audience:
description: OpenId audience
example: Alpha testers
type: string
baseUrl:
description: JWT OpenId base URL
example: https://oidc.example.com/
type: string
type: object
type: object
ConfigurationResponse:
properties:
configurations:
items:
$ref: '#/components/schemas/ExtendedConfigurationInformation'
type: array
type: object
PropertyInformation:
properties:
allowedValues:
items:
type: string
type: array
defaultValues:
items:
type: string
type: array
maxOccurrences:
format: int32
type: integer
minOccurrences:
format: int32
type: integer
type:
enum:
- IGNORED
- FORBIDDEN
- OPTIONAL
- REQUIRED
- LOCKED
type: string
type: object
AwsCloudProviderInformation:
properties:
accountIds:
description: Array of AWS account IDs each of which should be a 12-digit identifier
example:
- '123456789012'
items:
type: string
minItems: 1
type: array
regions:
description: Array of AWS regions
example:
- us-west-1
items:
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- af-south-1
- ap-east-1
- ap-south-2
- ap-southeast-3
- ap-southeast-4
- ap-south-1
- ap-northeast-3
- ap-northeast-2
- ap-southeast-1
- ap-southeast-2
- ap-northeast-1
- ca-central-1
- eu-central-1
- eu-west-1
- eu-west-2
- eu-south-1
- eu-west-3
- eu-south-2
- eu-north-1
- eu-central-2
- me-south-1
- me-central-1
- sa-east-1
- us-gov-east-1
- us-gov-west-1
type: string
type: array
required:
- accountIds
- regions
type: object
GoogleCloudProviderInformation:
properties:
projectIdentifiers:
description: Array of Google project identifiers each of which should be a string with int64 number or 6 to 30 lowercase letters, digits, or hyphens, should start with a letter and not contain trailing hyphens
example:
- '415104041262'
- tokyo-rain-123
items:
type: string
minItems: 1
type: array
regions:
description: Array of Google regions
example:
- us-west1
items:
enum:
- asia-east1
- asia-east2
- asia-northeast1
- asia-northeast2
- asia-northeast3
- asia-south1
- asia-south2
- asia-southeast1
- asia-southeast2
- australia-southeast1
- australia-southeast2
- europe-central2
- europe-north1
- europe-southwest1
- europe-west1
- europe-west12
- europe-west2
- europe-west3
- europe-west4
- europe-west6
- europe-west8
- europe-west9
- me-central1
- me-west1
- northamerica-northeast1
- northamerica-northeast2
- southamerica-east1
- southamerica-west1
- us-central1
- us-east1
- us-east4
- us-east5
- us-south1
- us-west1
- us-west2
- us-west3
- us-west4
type: string
type: array
required:
- projectIdentifiers
- regions
type: object
SubjectAttributesInformation:
description: Subject attributes
properties:
commonName:
$ref: '#/components/schemas/PropertyInformation'
country:
$ref: '#/components/schemas/PropertyInformation'
locality:
$ref: '#/components/schemas/PropertyInformation'
organization:
$ref: '#/components/schemas/PropertyInformation'
organizationalUnit:
$ref: '#/components/schemas/PropertyInformation'
stateOrProvince:
$ref: '#/components/schemas/PropertyInformation'
type: object
ExtendedConfigurationInformation:
properties:
advancedSettings:
$ref: '#/components/schemas/AdvancedSettingsInformation'
clientAuthentication:
$ref: '#/components/schemas/ClientAuthenticationInformation'
clientAuthorization:
$ref: '#/components/schemas/ClientAuthorizationInformation'
cloudProviders:
$ref: '#/components/schemas/CloudProvidersInformation'
companyId:
description: UUID specific to your company
example: 03eb6e61-9806-11ed-84f2-c747fb71e467
format: uuid
type: string
controllerAllowedPolicyIds:
description: Array of UUIDs of policies that the kubernetes controller is permitted to use
example:
- 8ae92800-b1e0-11ed-859d-b39255f965ee
format: uuid
items:
format: uuid
type: string
type: array
creationDate:
description: When the configuration was initially created
example: '2022-10-10T14:50:41.710+00:00'
type: string
id:
description: UUID of the configuration
example: 7268d820-a08d-11ed-bbc0-252385d6d389
format: uuid
type: string
longLivedCertCount:
description: Number of long lived certificates
example: 2
format: int64
type: integer
minTlsVersion:
description: Minimum required TLS protocol version
enum:
- TLS12
- TLS13
type: string
modificationDate:
description: When the configuration was last modified
example: '2023-12-12T20:00:10.500+00:00'
type: string
name:
description: Name of the configuration
example: Some configuration
type: string
policies:
items:
$ref: '#/components/schemas/PolicyInformation'
type: array
policyDefinitions:
items:
$ref: '#/components/schemas/PolicyInformation'
type: array
policyIds:
description: Array of UUIDs of policies to associate with the configuration
example:
- 8ae92800-b1e0-11ed-859d-b39255f965ee
format: uuid
items:
format: uuid
type: string
type: array
serviceAccountIds:
items:
format: uuid
type: string
type: array
shortLivedCertCount:
description: Number of short lived certificates
example: 20
format: int64
type: integer
subCaProvider:
$ref: '#/components/schemas/SubCaProviderInformation'
subTsgId:
description: Sub-TSG ID that owns this configuration (null for Primary TSG)
example: a007d406bf
type: string
ultraShortLivedCertCount:
description: Number of ultra short lived certificates
example: 200
format: int64
type: integer
unixSocketAllowedPolicyIds:
description: Array of UUIDs of policies that are permitted to be used when using the unix socket
example:
- 8ae92800-b1e0-11ed-859d-b39255f965ee
format: uuid
items:
format: uuid
type: string
type: array
type: object
SubCaProviderPkcs11ConfigurationInformation:
properties:
allowedClientLibraries:
description: A collection of strings each of which represents SHA256 hash of an allowed HSM client library
example:
- c34d199f2e30bb679cd9b8533b99975465aefe8b023be1b37972f1ab43ab7b2d
items:
type: string
type: array
partitionLabel:
description: HSM Partition Label
example: workload-identity-manager-hsm-partition
type: string
partitionSerialNumber:
description: HSM Partition Serial Number
example: '1444210958933'
pattern: ^[A-Fa-fx0-9]{0,18}$
type: string
pin:
description: HSM PIN
example: '1234'
type: string
writeOnly: true
signingEnabled:
description: Indicates whether HSM signing is enabled or not
example: true
type: boolean
type: object
JwtClient:
properties:
allowedPolicyIds:
description: Array of UUIDs of policies that the client is permitted to use
example:
- 8ae92800-b1e0-11ed-859d-b39255f965ee
format: uuid
items:
format: uuid
type: string
type: array
issuer:
description: Issuer of the JWT
example: https://kubernetes.default.svc
type: string
jwksUri:
description: URL used to pull the trusted singing keys used for validation
example: https://www.example.com:6443/jwks
type: string
name:
description: Name of the client
example: Some client
type: string
subjects:
description: Array of subjects of the JWT
example:
- system:serviceaccount:venafi:application-team-1
items:
type: string
type: array
type: object
ClientAuthenticationRequestOpenApi:
properties:
clientAuthentication:
oneOf:
- $ref: '#/components/schemas/JwtStandardClaimsAuthenticationOpenApi'
- $ref: '#/components/schemas/JwtJwksAuthenticationOpenApi'
- $ref: '#/components/schemas/JwtOidcAuthenticationOpenApi'
type: object
type: object
SansInformation:
description: Subject alternative names
properties:
dnsNames:
$ref: '#/components/schemas/PropertyInformation'
ipAddresses:
$ref: '#/components/schemas/PropertyInformation'
rfc822Names:
$ref: '#/components/schemas/PropertyInformation'
uniformResourceIdentifiers:
$ref: '#/components/schemas/PropertyInformation'
type: object
AzureCloudProviderInformation:
properties:
subscriptionIds:
description: Array of Azure subscription IDs each of which should be UUID
example:
- 8d10da13-8125-4ba9-a717-bf7490507b3d
items:
format: uuid
type: string
minItems: 1
type: array
required:
- subscriptionIds
type: object
CloudProvidersInformation:
properties:
aws:
$ref: '#/components/schemas/AwsCloudProviderInformation'
azure:
$ref: '#/components/schemas/AzureCloudProviderInformation'
google:
$ref: '#/components/schemas/GoogleCloudProviderInformation'
type: object
ClientAuthenticationOpenApi:
discriminator:
mapping:
JWT_JWKS: '#/components/schemas/JwtJwksAuthenticationOpenApi'
JWT_OIDC: '#/components/schemas/JwtOidcAuthenticationOpenApi'
JWT_STANDARD_CLAIMS: '#/components/schemas/JwtStandardClaimsAuthenticationOpenApi'
propertyName: type
properties:
type:
type: string
type: object
KeyAlgorithmInformation:
description: Key algorithm
properties:
allowedValues:
description: Key algorithm allowed values
items:
enum:
- RSA_2048
- RSA_3072
- RSA_4096
- EC_P256
- EC_P384
- EC_P521
- EC_ED25519
type: string
minItems: 1
type: array
defaultValue:
description: Key algorithm default value
enum:
- RSA_2048
- RSA_3072
- RSA_4096
- EC_P256
- EC_P384
- EC_P521
- EC_ED25519
example: RSA_4096
type: string
required:
- allowedValues
- defaultValue
type: object
ErrorResponse7:
properties:
errors:
items:
$ref: '#/components/schemas/ErrorInformation7'
type: array
type: object
PolicyInformation:
properties:
companyId:
description: UUID specific to your company
example: 03eb6e61-9806-11ed-84f2-c747fb71e467
format: uuid
type: string
creationDate:
description: When the policy was initially created
example: '2022-10-10T14:50:41.710+00:00'
type: string
extendedKeyUsages:
description: Extended key usages
example:
- CLIENT_AUTH
- SERVER_AUTH
items:
enum:
- ANY
- SERVER_AUTH
- CLIENT_AUTH
- CODE_SIGNING
- EMAIL_PROTECTION
- IPSEC_ENDSYSTEM
- IPSEC_TUNNEL
- IPSEC_USER
- TIME_STAMPING
- OCSP_SIGNING
- DVCS
- SBGP_CERT_AA_SERVER_AUTH
- SCVP_RESPONDER
- EAP_OVER_PPP
- EAP_OVER_LAN
- SCVP_SERVER
- SCVP_CLIENT
- IPSEC_IKE
- CAPWAP_AC
- CAPWAP_WTP
- IPSEC_IKE_INTERMEDIATE
- SMARTCARD_LOGON
type: string
type: array
id:
description: UUID of the policy
example: 8ae92800-b1e0-11ed-859d-b39255f965ee
format: uuid
type: string
keyAlgorithm:
$ref: '#/components/schemas/KeyAlgorithmInformation'
keyUsages:
description: Key usages
example:
- keyEncipherment
- digitalSignature
items:
enum:
- digitalSignature
- nonRepudiation
- keyEncipherment
- dataEncipherment
- keyAgreement
- keyCertSign
- cRLSign
- encipherOnly
- decipherOnly
type: string
type: array
modificationDate:
description: When the policy was last modified
example: '2023-12-12T20:00:10.500+00:00'
type: string
name:
description: Name of the policy
example: Some policy
type: string
sans:
$ref: '#/components/schemas/SansInformation'
shareWithAll:
description: Shared with all sub-TSGs
example: false
type: boolean
sharedWithSubTsgIds:
items:
description: Sub-TSG IDs this policy is shared with
type: string
type: array
uniqueItems: true
subject:
$ref: '#/components/schemas/SubjectAttributesInformation'
validityPeriod:
description: ISO8601 Period Format
example: P30D
format: PnYnMnDTnHnMnS
type: string
type: object
ConfigurationUpdateRequest:
properties:
advancedSettings:
$ref: '#/components/schemas/AdvancedSettingsInformation'
clientAuthentication:
$ref: '#/components/schemas/ClientAuthenticationRequestOpenApi'
clientAuthorization:
$ref: '#/components/schemas/ClientAuthorizationInformation'
cloudProviders:
$ref: '#/components/schemas/CloudProvidersInformation'
minTlsVersion:
description: Minimum required TLS protocol version
enum:
- TLS12
- TLS13
type: string
name:
description: Name of the configuration
example: Some configuration
maxLength: 64
type: string
policyIds:
description: Array of UUIDs of policies to associate with the configuration
example:
- 8ae92800-b1e0-11ed-859d-b39255f965ee
format: uuid
items:
format: uuid
type: string
type: array
serviceAccountIds:
items:
format: uuid
type: string
type: array
subCaProviderId:
description: UUID of Sub CA provider to associate with the configuration
example: 2f3c6030-b1e0-11ed-a3ed-e3dbaf56a746
format: uuid
type: string
type: object
ClientAuthenticationInformation:
discriminator:
propertyName: type
oneOf:
- $ref: '#/components/schemas/JwtStandardClaimsAuthenticationInformation'
- $ref: '#/components/schemas/JwtJwksAuthenticationInformation'
- $ref: '#/components/schemas/JwtOidcAuthenticationInformation'
properties:
type:
type: string
required:
- type
type: object
JwtOidcAuthenticationInformation:
allOf:
- $ref: '#/components/schemas/ClientAuthenticationInformation'
- properties:
audience:
description: OpenId audience
example: Client1
maxLength: 256
type: string
baseUrl:
description: JWT OpenId base URL
example: https://openid.example.com
maxLength: 2048
type: string
type: object
required:
- audience
- baseUrl
type: object
SubCaProviderInformation:
properties:
caAccountId:
description: UUID of the CA account used by this Sub CA provider
example: 4ece3180-b1e0-11ed-862d-ad36b18e787a
format: uuid
type: string
caProductOptionId:
description: UUID of the CA product option used by this Sub CA provider
example: 6b3d8d20-b1e0-11ed-9c2f-953e35982bbd
format: uuid
type: string
caType:
description: Type of CA this Sub CA provider works with
enum:
- MOCKCA
- DIGICERT
- GLOBALSIGN
- BUILTIN
- ENTRUST
- MICROSOFT
- ACME
- ZTPKI
- GLOBALSIGNMSSL
- TPP
example: BUILTIN
type: string
commonName:
description: Common name
example: example.com
type: string
companyId:
description: UUID specific to your company
example: 03eb6e61-9806-11ed-84f2-c747fb71e467
format: uuid
type: string
country:
description: Country
example: US
type: string
creationDate:
description: When the Sub CA provider was initially created
example: '2022-10-10T14:50:41.710+00:00'
type: string
id:
description: UUID of the Sub CA provider
example: 2f3c6030-b1e0-11ed-a3ed-e3dbaf56a746
format: uuid
type: string
keyAlgorithm:
description: Key algorithm type
enum:
- RSA_2048
- RSA_3072
- RSA_4096
- EC_P256
- EC_P384
- EC_P521
- EC_ED25519
example: EC_P256
type: string
locality:
description: Locality
example: San Antonio
type: string
modificationDate:
description: When the Sub CA provider was last modified
example: '2023-12-12T20:00:10.500+00:00'
type: string
name:
description: Name of the Sub CA provider
example: Some Sub CA provider
type: string
organization:
description: Organization
example: Some organization
type: string
organizationalUnit:
description: Organizational unit
example: Some organizational unit
type: string
pkcs11:
$ref: '#/components/schemas/SubCaProviderPkcs11ConfigurationInformation'
shareWithAll:
description: Shared with all sub-TSGs
example: false
type: boolean
sharedWithSubTsgIds:
items:
description: Sub-TSG IDs this SubCA provider is shared with
type: string
type: array
uniqueItems: true
stateOrProvince:
description: State or province
example: Texas
type: string
validityPeriod:
description: ISO8601 Period For
# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/palo-alto-networks/refs/heads/main/openapi/palo-alto-networks-issuer-configurations-api-openapi.yml