Compartir por

Cloud PKI Management (Preview)

  • Reference

Take back control of your Microsoft Public Key Infrastructure (ADCS) with the Microsoft Power Platform and Cloud PKI Management from 509 Solutions.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
URL https://support.509.solutions
Connector Metadata
Publisher 509 Solutions Pty Ltd
Website https://support.509.solutions
Privacy policy http://www.509.solutions/about/privacy

An easy to navigate yet powerful interface to the Cloud PKI Management API https://api.cloudpki.management

To leverage the Cloud PKI Management connector, you must have an active Cloud PKI Management Deployment and be a master user or have been granted a Cloud PKI Management Role by your Identity Management administrators.

Note. Although the connector will show all actions and triggers, you may only perform actions that your Cloud PKI Management role permits. Visit the API Documentation for full details of the actions that each role can perform.

To confirm your assigned roles, you can use the "Get-Authentication" action to fetch your login details. The roles claim if present will detail the Cloud PKI Management roles that have been assigned to you. It is valid to be assigned multiple roles.

If you require support or wish to provide feedback or new ideas for the connector, please visit our support site to get in touch or if required raise a support ticket.

All Triggers and Actions require a valid Region ID and Deployment ID to execute correctly. For your convenience, these items will be populated for you to make a selection from. If you have multiple deployments, you may need to contact support to have the additional deployments added to your list. These options can always be manually overriden in all Triggers and Actions.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Delete Hook

Delete a hook subscribed to this deployment by its ID
Get Actions

Retrieve upcoming required actions for this PKI
Get Authentication Details

Gets the Azure Authentication Details for the Current Session
Get Certificate

Get a Certificate by its SHA1 Thumbprint
Get Certificate Revocation List (CRL)

Get a Certificate Revocation List from this deployment by its CRL ID
Get Connector Action

Get a Connector Action by its Action ID
Get Hook

Get a hook subscribed to this deployment by its HookID
Get Published Certificate

Download Issued Certificates for Submitters and Owners
Get Published Templates

Gets Published Templates for Certificate Requests
Get Request

Retrieve a Certificate Signing Request (CSR)
Get Template

Fetch a certificate template configuration
Get User Deployments

Retrieves the users configured deployments
New Hook

Add a new hook to this Cloud PKI Deployment
New Request

New Certificate Request
Query Certificate Revocation Lists (CRLs)

Queries for CRLs based on selected criteria
Query Certificate Templates

Search for certificate templates
Query Certificates

Query Certificates Issued by this Cloud PKI deployment
Query Hooks

Query all hooks in this Cloud PKI Deployment
Query Requests

Query Certificate Signing Requests
Update Certificate

Change the status or metadata of a certificate
Update Request

Approve, Deny or Update an existing Certificate Request
Update Template

Change the status or metadata of a Template

Delete Hook

Operation ID:
Delete-Hook

Delete a hook subscribed to this deployment by its ID

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Hook ID
 hookid True string

Cloud PKI Hook ID. It is a SHA1 Thumbprint of the Callback URL/Email Address

Returns

response
string

Get Actions

Operation ID:
Get-Actions

Retrieve upcoming required actions for this PKI

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
array of object
Thumbprint
 thumbprint string

Certificate Thumbprint
Valid To
 validto string

Certificate Expiry Date
Valid To (Epoch)
 validtoepoch integer

Certificate Expiry Date as Epoch Timestamp
Renewal Status
 renewalstatus string

Current Renewal Status
Expires In / Since Requested
 days integer

Days Until Certificate Expiry or Days Since Request Submitted
Type
 objecttype string

Object Type (Certificate, or Request)
Status
 objectstatus string

Current Status. Renewing, Expiring or Pending
Phase
 phase string

Certificate Life-cycle phase
Request ID
 requestid string

CloudPKI Request ID
Request Source
 requestsource string

Request Source (Cloud PKI or Issuing CA)
When Submitted
 submittedwhen string

When a Request Was Submitted
When Submitted
 submittedwhenepoch string

When a Request Was Submitted Epoch Time
Submitted By
 submitteremail string

Request Submitter Email
Display Subject
 displaysubject string

A Rationalised Subject Name for Easy Identification.

Get Authentication Details

Operation ID:
Get-Authentication

Gets the Azure Authentication Details for the Current Session

Returns

response
string

Get Certificate

Operation ID:
Get-Certificate

Get a Certificate by its SHA1 Thumbprint

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Thumbprint
 thumbprint True string

Certificate SHA1 Thumbprint

Returns

Name Path Type Description
Thumbprint
 thumbprint string

Certificate SHA1 Thumbprint
Serial Number
 serialnumber string

Serial Number
Valid From
 validfrom string

Certificate Start Date
Valid To
 validto string

Certificate Expiry Date
Valid From (Epoch)
 validfromepoch integer

Certificate Start Date as Epoch timestamp
Valid To (Epoch)
 validtoepoch integer

Certificate Expiry Date as Epoch Timestamp
Signing Algorithm
 signaturealgorithm string

signaturealgorithm
Subject Key Identifier
 subjectkeyidentifier string

The Subject Key Identifier of the certificate.
Authority Key Identifier
 authoritykeyidentifier string

The Authority Key Identifier of the certificate.
Template OID
 templateoid string

Template Object ID - Unique per Microsoft Entra ID Forest
Template Name
 templatename string

Template Short Name
Key Type
 keytype string

The Asymmetric KeyType. (RSA or ECC)
Key Length
 keysize integer

The Asymmetric key length
Basic Key Usage
 keyusage array of string

Basic Key Usages
Enhanced Key Usage
 enhancedkeyusage array of string

The Enhanced Key Usages
Issuing CA
 issuername string

The Issuers Common CA Name
Subject
 subject array of string

The subject of the certificate
SAN
 subjectalternativename array of string

Subject Alternate Names for the Certificate
Display Subject
 displaysubject string

A rationalised subject name for easier identification.
CDP
 cdp array of string

CRL Distribution Points
AIA
 aia array of string

Authority Information Access
Constraints
 basicconstraints array of string

Basic Certificate Constraints
Status
 status string

Certificate Status (Issued or Revoked)
Public Key
 publickey string

Public Key of the Certificate
Template ID
 cloudpki.templateid string

Cloud PKI Template ID
Cloud PKI Request ID
 cloudpki.requestid string

Cloud PKI Request ID if requested through Cloud PKI Management
Life-cycle Phase
 cloudpki.phase string

Current Certificate Life-cycle Phase
Important
 cloudpki.important string

Certificate Marked As Important
Comment
 cloudpki.comment string

Comment
Reference
 cloudpki.reference string

Reference
Owner Email Addresses
 cloudpki.owneremail array of string

owneremail
Owner Email Addresses String
 cloudpki.owneremailstring string

Owner Email Addresses String
Renewal Status
 cloudpki.renewalstatus string

Current Renewal Status
Renewal Last Modified Timestamp
 cloudpki.renewallastmodified string

Renewal Status Last Modified Timestamp
Renewal Last Modified Epoch Timestamp
 cloudpki.renewallastmodifiedepoch integer

Renewal Status Last Modified Epoch Timestamp
Renewal Last Modified ID
 cloudpki.renewallastmodifiedid string

Renewal Status Last Modified ID
Renewal Last Modified Email
 cloudpki.renewallastmodifiedemail string

Renewal Status Last Modified Email
Last Modified Epoch Timestamp
 cloudpki.lastmodified string

Last Modified Epoch Timestamp
lastmodifiedepoch
 cloudpki.lastmodifiedepoch integer

lastmodifiedepoch
Last Modified By ID
 cloudpki.lastmodifiedid string

Last Modified By ID
Last Modified By Email
 cloudpki.lastmodifiedemail string

Last Modified By Email
Last Modified Event
 cloudpki.lastmodifiedevent string

Last Modified Event
Revocation Status
 cloudpki.revocationstatus string

Revocation Status
Last Revocation
 cloudpki.revocationlastmodified string

Last Revocation Timestamp
Last Revocation Epoch
 cloudpki.revocationlastmodifiedepoch string

Last Revocation Epoch Timestamp
Last Revoker ID
 cloudpki.revocationlastmodifiedid string

Last Revoker ID
Last Revoker Email
 cloudpki.revocationlastmodifiedemail string

Last Revoker Email
CA Request ID
 requestdetails.carequestid integer

Request ID from Issuing CA
CA Request Details - Status Message
 requestdetails.statusmessage string

Status Message from Certificate Request Submission to Issuing CA
CA Request Details - Submitted When
 requestdetails.submittedwhen string

Submitted When
Resolved When
 requestdetails.resolvedwhen string

Resolved When from Issuing CA
Revoked When
 requestdetails.revokedwhen string

Revoked When
Revocation Effective When
 requestdetails.revokedeffectivewhen string

Revocation Effective When
Revocation Reason
 requestdetails.revokedreason integer

Revocation Reason
Requester Name
 requestdetails.requestername string

Requester Name from Issuing CA
Caller Name
 requestdetails.callername string

Caller Name from Issuing CA
CA Request Details - OS Version
 requestdetails.requestosversion string

requestosversion
CA Request Details - CSP Provider
 requestdetails.requestcspprovider string

CSP Provider / KSP Provider Name

Get Certificate Revocation List (CRL)

Operation ID:
Get-CRL

Get a Certificate Revocation List from this deployment by its CRL ID

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
CRL ID
 crlid True string

Certificate Revocation List in the form of -

Returns

Name Path Type Description
Valid From
 validfrom string

CRL Start Date
Valid To
 validto string

CRL Expiry Date
Valid From (Epoch)
 validfromepoch integer

CRL Start Date as Epoch timestamp
Valid To (Epoch)
 validtoepoch integer

CRL Expiry Date as Epoch Timestamp
Issuing CA
 issuer string

Issuing CA Common Name
Signature Algorithm
 signaturealgorithm string

Signature Algorithm
Signature Hash Algorithm
 signaturehashalgorithm string

Signature Hash Algorithm
CA Version
 caversion string

CA Version of the Associated CA Certificate
AKI
 aki string

Authority Key Identifier
CRL Number
 crlnumber string

CRL Number in Hex
CRL Number Decimal
 crlnumberdecimal integer

CRL Number Decimal
Next Publish Date
 nextpublish date-time

Next Publish Date
Next Publish Timestamp
 nextpublishepoch integer

Next Publish Epoch Timestamp
CRL ID
 crlid string

ID of the CRL
crlentries
 crlentries array of string

crlentries

Get Connector Action

Operation ID:
Get-ConnectorAction

Get a Connector Action by its Action ID

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Connector Action ID
 connectoractionid True string

Connector Action ID

Returns

Name Path Type Description
Connector Action Event
 event string

The Event being executed by the Connector Action
Connector Action Asset ID
 assetid string

The Asset ID being updated by the Connector Action
Connector Action Asset Type
 assettype string

The Asset Type being updated by the Connector Action
Connector Action Created Timestamp
 createdwhen string

Connector Action Created Timestamp
Connector Action Resolved Timestamp
 resolvedwhen string

Connector Action Resolved Timestamp
Connector Action Submitted Timestamp
 submittedwhen string

Connector Action Submitted to CA Timestamp
Connector Action Message
 message string

The Message returned from the Connector Action
Connector Action ID
 connectoractionid string

Connector Action ID
Connector Action Status
 status string

The Status of the Connector Action

Get Hook

Operation ID:
Get-Hook

Get a hook subscribed to this deployment by its HookID

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Hook ID
 hookid True string

Cloud PKI Hook ID. It is a SHA1 Thumbprint of the Callback URL/Email Address

Returns

Name Path Type Description
Hook ID
 hookid string

Unique Identifier of Hook (SHA1 of Email Address or CallbackURL)
Events
 events string

Events this hook is triggered by
Call Back URL
 callbackurl string

The URL the hook will notify of subscribed events
Type
 type string

Hook Type (Web, Email or PowerBI)
Object URI
 objecturi string

Object URI of the Hook
Creator ID
 creatorid string

Username of Admin Who Created the Hook
Creator Email
 creatoremail string

Email Address of Admin Who Created the Hook
Status
 status string

Hook Status (Enabled or Disabled)
When Changed
 whenchanged date-time

When Changed Timestamp
When Changed Epoch
 whenchangedepoch integer

When Changed Epoch Timestamp
User Agent
 useragent string

Useragent Header of Hook Creation Call
Workflow - Name
 workflowdetails.workflowname string

Workflow Name of the Logic Apps or Flow Workflow
Workflow - Operation Name
 workflowdetails.workflowoperationname string

Operation Name of the Logic Apps or Flow Workflow
Workflow - ID
 workflowdetails.workflowid string

ID of the Logic Apps or Flow Workflow
Workflow - Version
 workflowdetails.workflowversion string

Version of the Logic Apps or Flow Workflow
Workflow - Subscription ID
 workflowdetails.workflowsubscriptionid string

Subscription ID of the Logic Apps or Flow Workflow
Workflow - Location
 workflowdetails.workflowlocation string

Location of the Logic Apps or Flow Workflow

Get Published Certificate

Operation ID:
Get-PublishedCertificate

Download Issued Certificates for Submitters and Owners

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Thumbprint
 thumbprint True string

Certificate SHA1 Thumbprint to Download

Returns

response
string

Get Published Templates

Operation ID:
Get-PublishedTemplates

Gets Published Templates for Certificate Requests

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
array of object
Template ID
 templateid string

Cloud PKI Template ID
Template Name
 templatename string

Template Short Name
Template OID
 templateoid string

Template Object ID
Template Microsoft Entra ID Forest
 templateforestrootfqdn string

Template Microsoft Entra ID Forest DNS Name
Template Display Name
 templatedisplayname string

Template Display Name

Get Request

Operation ID:
Get-Request

Retrieve a Certificate Signing Request (CSR)

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Request ID
 requestid True string

Cloud PKI Request ID

Returns

Name Path Type Description
Request Source
 requestsource string

Source of Request (Cloud PKI or Issuing CA Name)
Status
 status string

Request Status (Pending, Approved, Denied, Failed, Issued)
Public Key
 publickey string

Public Key of Request
Key Type
 keytype string

Key Type (RSA or ECC)
Key Length
 keylength integer

Key Length
subject
 subject array of string

subject
subjectalternativename
 subjectalternativename array of string

subjectalternativename
Request Hash Algorithm
 requesthash string

Hashing Algorithm Used to Sign the Request
Signature Algorithm
 signaturealgorithm string

Signature Algorithm
alternatesignaturealgorithm
 alternatesignaturealgorithm boolean

alternatesignaturealgorithm
Template OID
 templateoid string

Template Object ID
Template ID
 templateid string

Template ID
Template Name
 templatename string

Template Name
criticalextensions
 criticalextensions array of string

criticalextensions
enhancedkeyusage
 enhancedkeyusage array of string

enhancedkeyusage
keyusage
 keyusage array of string

keyusage
applicationpolicies
 applicationpolicies array of string

applicationpolicies
SKI
 subjectkeyidentifier string

Subject Key Identifier
Display Subject
 displaysubject string

Display Subject
Cloud PKI Request ID
 requestid string

Cloud PKI Request ID (Always different to the CA Request ID)
CA Request Details - CA Request ID
 requestdetails.carequestid integer

Request ID from the Issuing CA
CA Request Details - Status Message
 requestdetails.statusmessage string

Status Message from CA when Request Submitted
CA Request Details - Submitted When
 requestdetails.submittedwhen string

Timestamp When Submitted to the Issuing CA
resolvedwhen
 requestdetails.resolvedwhen string

resolvedwhen
CA Request Details - When Revoked
 requestdetails.revokedwhen string

When the Issuing CA Revoked the Certificate
CA Request Details - Revocation Effective When
 requestdetails.revokedeffectivewhen string

When the Certificate Revocation should apply. Signatures post this date should be considered invalid.
CA Request Details - Revocation Reason
 requestdetails.revokedreason string

Why the Certificate was Revoked
requestername
 requestdetails.requestername string

requestername
callername
 requestdetails.callername string

callername
CA Request Details - OS Version
 requestdetails.requestosversion string

Operation System Version of the Request
requestcspprovider
 requestdetails.requestcspprovider string

requestcspprovider
cdc
 requestdetails.cdc string

cdc
rmd
 requestdetails.rmd string

rmd
ccm
 requestdetails.ccm string

ccm
cloudpkirequestid
 cloudpki.cloudpkirequestid string

cloudpkirequestid
Reference
 cloudpki.reference string

Reference
Comment
 cloudpki.comment string

Comment
Urgent Flag
 cloudpki.urgent string

Urgent Flag
Important Flag
 cloudpki.important string

Important Flag
Owner Email Addresses
 cloudpki.owneremail array of string

owneremail
Owner Email Addresses String
 cloudpki.owneremailstring string

owneremail
Certificate Signing Request
 cloudpki.submittedcsr string

Certificate Signing Request Text
Submitted Template ID
 cloudpki.submittedtemplateid string

Submitted Template ID
Submitted Reference
 cloudpki.submittedreference string

Refernce From Request Submitter
Submitted Comment
 cloudpki.submittedcomment string

Submitted Comment
Submitted Urgent Flag
 cloudpki.submittedurgent string

Submitted Urgent Flag
Submitted Important Flag
 cloudpki.submittedimportant string

Submitted Important Flag
Submitted Owner Email
 cloudpki.submittedowneremail array of string

submittedowneremail
Submitted When
 cloudpki.submittedwhen string

Timestamp of Request Submission
Submitted When Epoch
 cloudpki.submittedwhenepoch integer

Submitted When Epoch Timestamp
Submitter ID
 cloudpki.submitterid string

Username of Request Submitter
Submitter Email Address
 cloudpki.submitteremail string

Submitter Email Address
approvedstatus
 cloudpki.approvedstatus string

approvedstatus
Approver Comments
 cloudpki.approvedcomment string

Comment from Request Approver
approvedreference
 cloudpki.approvedreference string

approvedreference
Important Flag
 cloudpki.approvedimportant string

Important Status from Request Approver
approvedwhen
 cloudpki.approvedwhen string

approvedwhen
approvedwhenepoch
 cloudpki.approvedwhenepoch integer

approvedwhenepoch
approverid
 cloudpki.approverid string

approverid
approveremail
 cloudpki.approveremail string

approveremail

Get Template

Operation ID:
Get-Template

Fetch a certificate template configuration

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Template ID
 templateid True string

Template Identifier

Returns

Name Path Type Description
Template ID
 templateid string

Template ID
Template Name
 name string

Template Short Name
Template Display Name
 displayname string

Template Display Name
Template DN
 distinguishedname string

Microsoft Entra ID Forest Distinguished Name of Template
Microsoft Entra ID Object GUID
 objectguid string

Microsoft Entra ID Object GUID of Template
Forest Root DN
 forestrootdn string

Microsoft Entra ID Forest Root Distinguished Name
Forest Root DNS Name
 forestrootfqdn string

Microsoft Entra ID Forest Root DNS Name
When Created
 whencreated date-time

Creation Date of Template Microsoft Entra ID Object
When Changed
 whenchanged date-time

Last Modified Date of Template Microsoft Entra ID Object
Status
 status string

Current Template Status (Published or Unpublished)
publishedby
 publishedby array of string

publishedby
Template OID
 templateoid string

Template OID
Template Version
 templateversion integer

Template Version - 1,2,3,4 (2000, 2003 Ent, 2008, 2012)
Major Version
 majorversion integer

Template Major Version
Minor Version
 minorversion integer

Template Minor Version
Template Type
 templatetype string

Template Type (User or Computer)
Validity Period
 validityperiod integer

Certificate Validity Period in Days
renewalperiod
 renewalperiod integer

renewalperiod
defaultkeyspec
 defaultkeyspec integer

defaultkeyspec
defaultkeyspecdecoded
 defaultkeyspecdecoded string

defaultkeyspecdecoded
Basic Key Usages
 basickeyusage integer

Basic Key Usages
Basic Key Usage - Key Encipherment
 basickeyusagedecoded.KEYENCIPHERMENT string

Basic Key Usage - Key Encipherment
Basic Key Usage - Non-Repudiation
 basickeyusagedecoded.NONREPUDIATION string

Basic Key Usage - Non-Repudiation
Basic Key Usage - Key Agreement
 basickeyusagedecoded.KEYAGREEMENT string

Basic Key Usage - Key Agreement
Basic Key Usage - Digital Signature
 basickeyusagedecoded.DIGITALSIGNATURE string

Basic Key Usage - Digital Signature
Basic Key Usage - Data Encipherment
 basickeyusagedecoded.DATAENCIPHERMENT string

Basic Key Usage - Data Encipherment
Basic Key Usage - Key Certificate Signing
 basickeyusagedecoded.KEYCERTSIGN string

Basic Key Usage - Key Certificate Signing
Basic Key Usage - CRL Signing
 basickeyusagedecoded.CRLSIGN string

Basic Key Usage - CRL Signing
enhancedkeyusage
 enhancedkeyusage array of string

enhancedkeyusage
criticalextensions
 criticalextensions array of string

criticalextensions
Minimum Key Size
 minimumkeysize integer

Minimum Key Size
defaultcsps
 defaultcsps array of string

defaultcsps
maxdepth
 maxdepth integer

maxdepth
supersededtemplates
 supersededtemplates array of string

supersededtemplates
issuancepolicy
 issuancepolicy array of string

issuancepolicy
applicationpolicy
 applicationpolicy array of string

applicationpolicy
rasignaturecount
 rasignaturecount integer

rasignaturecount
rasignatureissuancepolicies
 rasignatureissuancepolicies array of string

rasignatureissuancepolicies
templateflags integer

templateflags
Private Key Exportable
 templateflagsdecoded.PRIVATEKEYEXPORTABLE string

Is The Private Key Exportable
ENABLEAUTOENROLLMENT
 templateflagsdecoded.ENABLEAUTOENROLLMENT string

ENABLEAUTOENROLLMENT
ISCOMPUTERCERT
 templateflagsdecoded.ISCOMPUTERCERT string

ISCOMPUTERCERT
ISCROSSCA
 templateflagsdecoded.ISCROSSCA string

ISCROSSCA
ISCA
 templateflagsdecoded.ISCA string

ISCA
templateflagsdecoded.PUBLISHTOREQUESTERUSEROBJECT string

PUBLISHTOREQUESTERUSEROBJECT
templateflagsdecoded.ISEDITABLE string

ISEDITABLE
templateflagsdecoded.DONOTPERSISTINDB string

DONOTPERSISTINDB
templateflagsdecoded.ADDDETAILSTOCERT string

ADDDETAILSTOCERT
templateflagsdecoded.ADDEMAIL string

ADDEMAIL
templateflagsdecoded.ISDEFAULT string

ISDEFAULT
enrollmentflags integer

enrollmentflags
enrollmentflagsdecoded.ENABLEKEYREUSEONNTTOKENKEYSETSTORAGEFULL string

ENABLEKEYREUSEONNTTOKENKEYSETSTORAGEFULL
enrollmentflagsdecoded.EXCLUDECRLDETAILSINCERT string

EXCLUDECRLDETAILSINCERT
enrollmentflagsdecoded.PREVIOUSAPPROVALVALIDATEREENROLLMENT string

PREVIOUSAPPROVALVALIDATEREENROLLMENT
enrollmentflagsdecoded.AUTOENROLLMENTCHECKUSERDSCERTIFICATE string

AUTOENROLLMENTCHECKUSERDSCERTIFICATE
enrollmentflagsdecoded.INCLUDEBASICCONSTRAINTSFOREECERTS string

INCLUDEBASICCONSTRAINTSFOREECERTS
enrollmentflagsdecoded.REMOVEINVALIDCERTIFICATEFROMPERSONALSTORE string

REMOVEINVALIDCERTIFICATEFROMPERSONALSTORE
enrollmentflagsdecoded.EXCLUDEOCSPDETAILSINCERT string

EXCLUDEOCSPDETAILSINCERT
enrollmentflagsdecoded.ALLOWISSUANCEPOLICIESFROMREQUEST string

ALLOWISSUANCEPOLICIESFROMREQUEST
enrollmentflagsdecoded.AUTOENROLLMENT string

AUTOENROLLMENT
enrollmentflagsdecoded.PUBLISHTODS string

PUBLISHTODS
enrollmentflagsdecoded.ALLOWENROLLONBEHALFOF string

ALLOWENROLLONBEHALFOF
enrollmentflagsdecoded.ALLOWKEYBASEDRENEWAL string

ALLOWKEYBASEDRENEWAL
enrollmentflagsdecoded.PUBLISHTOKRACONTAINER string

PUBLISHTOKRACONTAINER
enrollmentflagsdecoded.USERINTERACTIONREQUIRED string

USERINTERACTIONREQUIRED
enrollmentflagsdecoded.CERTMGRAPPROVALREQUIRED string

CERTMGRAPPROVALREQUIRED
enrollmentflagsdecoded.INCLUDESYMETRICALGORITHMS string

INCLUDESYMETRICALGORITHMS
certificatenameflags integer

certificatenameflags
certificatenameflagsdecoded.SUBJECTREQUIREDNSASCN string

SUBJECTREQUIREDNSASCN
certificatenameflagsdecoded.SUBJECTALTREQUIREEMAIL string

SUBJECTALTREQUIREEMAIL
certificatenameflagsdecoded.SUBJECTREQUIREEMAIL string

SUBJECTREQUIREEMAIL
certificatenameflagsdecoded.SUBJECTALTREQUIREDNS string

SUBJECTALTREQUIREDNS
certificatenameflagsdecoded.SUBJECTALTREQUIREDOMAINDNS string

SUBJECTALTREQUIREDOMAINDNS
certificatenameflagsdecoded.ENROLEESUPLIESSUBJECTALTNAME string

ENROLEESUPLIESSUBJECTALTNAME
certificatenameflagsdecoded.OLDCERTSUPPLIESSUBJECTANDALTNAME string

OLDCERTSUPPLIESSUBJECTANDALTNAME
certificatenameflagsdecoded.SUBJECTALTREQUIREUPN string

SUBJECTALTREQUIREUPN
certificatenameflagsdecoded.SUBJECTALTREQUIREDIRECTORYGUID string

SUBJECTALTREQUIREDIRECTORYGUID
certificatenameflagsdecoded.SUBJECTREQUIRECOMMONNAME string

SUBJECTREQUIRECOMMONNAME
certificatenameflagsdecoded.SUBJECTALTREQUIRESPN string

SUBJECTALTREQUIRESPN
certificatenameflagsdecoded.ENROLEESUPLIESSUBJECT string

ENROLEESUPLIESSUBJECT
certificatenameflagsdecoded.SUBJECTREQUIREDIRECTORYPATH string

SUBJECTREQUIREDIRECTORYPATH
privatekeyflags integer

privatekeyflags
privatekeyflagsdecoded.REQUIREALTERNATESIGNATUREALGORITHM string

REQUIREALTERNATESIGNATUREALGORITHM
privatekeyflagsdecoded.EXPORTABLEKEY string

EXPORTABLEKEY
privatekeyflagsdecoded.REQUIRESAMEKEYRENEWAL string

REQUIRESAMEKEYRENEWAL
privatekeyflagsdecoded.EKVALIDATECERT string

EKVALIDATECERT
privatekeyflagsdecoded.EKVALIDATEKEY string

EKVALIDATEKEY
privatekeyflagsdecoded.STRONGKEYPROTECTIONREQUIRED string

STRONGKEYPROTECTIONREQUIRED
privatekeyflagsdecoded.ATTESTATIONWITHOUTPOLICY string

ATTESTATIONWITHOUTPOLICY
privatekeyflagsdecoded.EKTRUSTONUSE string

EKTRUSTONUSE
privatekeyflagsdecoded.ATTESTREQUIRED string

ATTESTREQUIRED
privatekeyflagsdecoded.USELEGACYPROVIDER string

USELEGACYPROVIDER
privatekeyflagsdecoded.ATTESTPREFERRED string

ATTESTPREFERRED
privatekeyflagsdecoded.REQUIREPRIVATEKEYARCHIVAL string

REQUIREPRIVATEKEYARCHIVAL
privatekeyflagsdecoded.ATTESTNONE string

ATTESTNONE
rasignatureapplicationpolicy string

rasignatureapplicationpolicy
keytype string

keytype
Important
 cloudpki.important string

Imported Certificates from this template will be marked as important
Owner Email Addresses
 cloudpki.owneremail array of string

owneremail
Owner Emails String
 cloudpki.owneremailstring string

owneremailstring
Owner Email Addresses
 cloudpki.autoapproveid array of string

owneremail
Auto Approved IDs String
 cloudpki.autoapproveidstring string

autoapproveidstring
Template Hidden
 cloudpki.hidden string

Certificate Template hidden from certificate requesters.
Renewal Status
 cloudpki.renewalstatus string

Imported certificates will have this renewal status
Last Modified Epoch Timestamp
 cloudpki.lastmodified string

Last Modified Epoch Timestamp
lastmodifiedepoch
 cloudpki.lastmodifiedepoch integer

lastmodifiedepoch
Last Modified By ID
 cloudpki.lastmodifiedid string

Last Modified By ID
Last Modified By Email
 cloudpki.lastmodifiedemail string

Last Modified By Email
Last Modified Event
 cloudpki.lastmodifiedevent string

Last Modified Event

Get User Deployments

Operation ID:
Get-UserDeployments

Retrieves the users configured deployments

Returns

Name Path Type Description
array of object
default
 default string

default
regionid
 regionid string

regionid
deploymentid
 deploymentid string

deploymentid
friendlyname
 friendlyname string

friendlyname

New Hook

Operation ID:
New-Hook

Add a new hook to this Cloud PKI Deployment

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Are You PowerApps?
 powerapps True string

Set to false unless calling from PowerApps
Email
 email string

Email Address to be notified when Event is triggered.
CallBack URL
 callbackurl string

The URL to be called when an Event is triggered
Hook Type
 type True string

Select Hook Type - Web, Email or PowerBI
events
 events True array of string

events

Returns

Name Path Type Description
status
 status string

status
objecturi
 objecturi string

objecturi
hookid
 hookid string

hookid

New Request

Operation ID:
New-Request

New Certificate Request

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Are You PowerApps?
 powerapps True string

Set to false unless calling from PowerApps
Certificate Signing Request
 csr True string

Paste your CSR here. It must start with '-----BEGIN NEW CERTIFICATE REQUEST-----'
Template Name
 templateid string

Template Name
Owner Notifications Email Addresses
 owneremail string

Owner Email
Reference
 reference string

RFC ID, CMDB Reference, Ticket Reference or other reference
Request Comment
 comment string

Extra non-critical info for the request approver
Urgent Request
 urgent string

Urgent Request
Important Certificate
 important string

Important Certificate
Renewal Request?
 renewal string

Is this request renewing an existing certificate?
Thumbprint Renewal Certificate
 previouscertificate string

Thumbprint Of Certificate being renewed with this request
Pre-Approve Future Renewal
 renewalstatus string

Pre-Approve Future Renewal of the issued Certificate?

Returns

Name Path Type Description
Submission Status
 status string

Submission Status
Cloud PKI Request ID
 requestid string

Request ID
objecturi
 objecturi string

objecturi
message
 message string

message

Query Certificate Revocation Lists (CRLs)

Operation ID:
Query-CRLs

Queries for CRLs based on selected criteria

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
CRL ID
 crlid string

Cloud PKI Certificate Revocation List ID
CRL Status
 status string

Current CRL Status
Issued in the past # days
 issued integer

Days
CRLS Expiring in the next # days
 expiring integer

Days
CRL Number
 crlnumber string

Hexadecimal CRL number as shown by the OS
CRL Number in Decimal
 crlnumberdecimal string

Decimal representation of the CRL Number
Authority Key Identifier
 aki string

AKI which is the SKI of the CRLs Issuing CA
Contains Serial Number
 serialnumber string

Serial number to search for in certificate revocation lists

Returns

Name Path Type Description
array of object
Valid From
 validfrom string

CRL Start Date
Valid To
 validto string

CRL Expiry Date
Valid From (Epoch)
 validfromepoch integer

CRL Start Date as Epoch timestamp
Valid To (Epoch)
 validtoepoch integer

CRL Expiry Date as Epoch Timestamp
issuer
 issuer string

issuer
signaturealgorithm
 signaturealgorithm string

signaturealgorithm
signaturehashalgorithm
 signaturehashalgorithm string

signaturehashalgorithm
caversion
 caversion string

caversion
aki
 aki string

aki
crlnumber
 crlnumber string

crlnumber
crlnumberdecimal
 crlnumberdecimal integer

crlnumberdecimal
nextpublish
 nextpublish date-time

nextpublish
nextpublishepoch
 nextpublishepoch integer

nextpublishepoch
crlid
 crlid string

crlid
crlentries
 crlentries array of string

crlentries

Query Certificate Templates

Operation ID:
Query-Templates

Search for certificate templates

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Status
 status string

Select Published or Unpublished
Type
 type string

Select User or Computer
Template Version
 version string

Select Version 1 (Server 2000), Version 2 (Server 2003 Enterprise), Version 3 (Server 2008 Standard), Version 4 (Server 2012 Standard)
Template OID
 templateoid string

eg..1.3.6.1.4.1.52136
Key Type
 keytype string

Select RSA or ECC
Smallest Minimum Key Length
 min-minkeylength integer

Minimum key lengths greater than or equal to eg.. 512
Largest Minimum Key Length
 max-minkeylength integer

Minimum key lengths less than or equal to eg.. 4096
Shortest Validity Period
 min-validity integer

Certificates valid for at least "x" days eg.. 180
Longest Validity Period
 max-validity integer

Certificates valid for at most "x" days eg.. 180

Returns

Name Path Type Description
array of object
name
 name string

name
displayname
 displayname string

displayname
distinguishedname
 distinguishedname string

distinguishedname
objectguid
 objectguid string

objectguid
forestrootdn
 forestrootdn string

forestrootdn
forestrootfqdn
 forestrootfqdn string

forestrootfqdn
whencreated
 whencreated string

whencreated
whenchanged
 whenchanged string

whenchanged
status
 status string

status
publishedby
 publishedby array of string

publishedby
templateoid
 templateoid string

templateoid
templateversion
 templateversion integer

templateversion
majorversion
 majorversion integer

majorversion
minorversion
 minorversion integer

minorversion
templateid
 templateid string

templateid
templatetype
 templatetype string

templatetype
validityperiod
 validityperiod integer

validityperiod
renewalperiod
 renewalperiod integer

renewalperiod
defaultkeyspec
 defaultkeyspec integer

defaultkeyspec
basickeyusage
 basickeyusage integer

basickeyusage
KEYENCIPHERMENT
 basickeyusagedecoded.KEYENCIPHERMENT string

KEYENCIPHERMENT
NONREPUDIATION
 basickeyusagedecoded.NONREPUDIATION string

NONREPUDIATION
KEYAGREEMENT
 basickeyusagedecoded.KEYAGREEMENT string

KEYAGREEMENT
DIGITALSIGNATURE
 basickeyusagedecoded.DIGITALSIGNATURE string

DIGITALSIGNATURE
DATAENCIPHERMENT
 basickeyusagedecoded.DATAENCIPHERMENT string

DATAENCIPHERMENT
KEYCERTSIGN
 basickeyusagedecoded.KEYCERTSIGN string

KEYCERTSIGN
CRLSIGN
 basickeyusagedecoded.CRLSIGN string

CRLSIGN
enhancedkeyusage
 enhancedkeyusage array of string

enhancedkeyusage
criticalextensions
 criticalextensions array of string

criticalextensions
minimumkeysize
 minimumkeysize integer

minimumkeysize
defaultcsps
 defaultcsps array of string

defaultcsps
maxdepth
 maxdepth integer

maxdepth
supersededtemplates
 supersededtemplates array of string

supersededtemplates
issuancepolicy
 issuancepolicy array of string

issuancepolicy
applicationpolicy
 applicationpolicy array of string

applicationpolicy
rasignaturecount
 rasignaturecount integer

rasignaturecount
rasignatureissuancepolicies
 rasignatureissuancepolicies array of string

rasignatureissuancepolicies
templateflags
 templateflags integer

templateflags
PRIVATEKEYEXPORTABLE
 templateflagsdecoded.PRIVATEKEYEXPORTABLE string

PRIVATEKEYEXPORTABLE
ENABLEAUTOENROLLMENT
 templateflagsdecoded.ENABLEAUTOENROLLMENT string

ENABLEAUTOENROLLMENT
ISCOMPUTERCERT
 templateflagsdecoded.ISCOMPUTERCERT string

ISCOMPUTERCERT
ISCROSSCA
 templateflagsdecoded.ISCROSSCA string

ISCROSSCA
ISCA
 templateflagsdecoded.ISCA string

ISCA
PUBLISHTOREQUESTERUSEROBJECT
 templateflagsdecoded.PUBLISHTOREQUESTERUSEROBJECT string

PUBLISHTOREQUESTERUSEROBJECT
ISEDITABLE
 templateflagsdecoded.ISEDITABLE string

ISEDITABLE
DONOTPERSISTINDB
 templateflagsdecoded.DONOTPERSISTINDB string

DONOTPERSISTINDB
ADDDETAILSTOCERT
 templateflagsdecoded.ADDDETAILSTOCERT string

ADDDETAILSTOCERT
ADDEMAIL
 templateflagsdecoded.ADDEMAIL string

ADDEMAIL
ISDEFAULT
 templateflagsdecoded.ISDEFAULT string

ISDEFAULT
enrollmentflags
 enrollmentflags integer

enrollmentflags
ENABLEKEYREUSEONNTTOKENKEYSETSTORAGEFULL
 enrollmentflagsdecoded.ENABLEKEYREUSEONNTTOKENKEYSETSTORAGEFULL string

ENABLEKEYREUSEONNTTOKENKEYSETSTORAGEFULL
EXCLUDECRLDETAILSINCERT
 enrollmentflagsdecoded.EXCLUDECRLDETAILSINCERT string

EXCLUDECRLDETAILSINCERT
PREVIOUSAPPROVALVALIDATEREENROLLMENT
 enrollmentflagsdecoded.PREVIOUSAPPROVALVALIDATEREENROLLMENT string

PREVIOUSAPPROVALVALIDATEREENROLLMENT
AUTOENROLLMENTCHECKUSERDSCERTIFICATE
 enrollmentflagsdecoded.AUTOENROLLMENTCHECKUSERDSCERTIFICATE string

AUTOENROLLMENTCHECKUSERDSCERTIFICATE
INCLUDEBASICCONSTRAINTSFOREECERTS
 enrollmentflagsdecoded.INCLUDEBASICCONSTRAINTSFOREECERTS string

INCLUDEBASICCONSTRAINTSFOREECERTS
REMOVEINVALIDCERTIFICATEFROMPERSONALSTORE
 enrollmentflagsdecoded.REMOVEINVALIDCERTIFICATEFROMPERSONALSTORE string

REMOVEINVALIDCERTIFICATEFROMPERSONALSTORE
EXCLUDEOCSPDETAILSINCERT
 enrollmentflagsdecoded.EXCLUDEOCSPDETAILSINCERT string

EXCLUDEOCSPDETAILSINCERT
ALLOWISSUANCEPOLICIESFROMREQUEST
 enrollmentflagsdecoded.ALLOWISSUANCEPOLICIESFROMREQUEST string

ALLOWISSUANCEPOLICIESFROMREQUEST
AUTOENROLLMENT
 enrollmentflagsdecoded.AUTOENROLLMENT string

AUTOENROLLMENT
PUBLISHTODS
 enrollmentflagsdecoded.PUBLISHTODS string

PUBLISHTODS
ALLOWENROLLONBEHALFOF
 enrollmentflagsdecoded.ALLOWENROLLONBEHALFOF string

ALLOWENROLLONBEHALFOF
ALLOWKEYBASEDRENEWAL
 enrollmentflagsdecoded.ALLOWKEYBASEDRENEWAL string

ALLOWKEYBASEDRENEWAL
PUBLISHTOKRACONTAINER
 enrollmentflagsdecoded.PUBLISHTOKRACONTAINER string

PUBLISHTOKRACONTAINER
USERINTERACTIONREQUIRED
 enrollmentflagsdecoded.USERINTERACTIONREQUIRED string

USERINTERACTIONREQUIRED
CERTMGRAPPROVALREQUIRED
 enrollmentflagsdecoded.CERTMGRAPPROVALREQUIRED string

CERTMGRAPPROVALREQUIRED
INCLUDESYMETRICALGORITHMS
 enrollmentflagsdecoded.INCLUDESYMETRICALGORITHMS string

INCLUDESYMETRICALGORITHMS
certificatenameflags
 certificatenameflags integer

certificatenameflags
SUBJECTREQUIREDNSASCN
 certificatenameflagsdecoded.SUBJECTREQUIREDNSASCN string

SUBJECTREQUIREDNSASCN
SUBJECTALTREQUIREEMAIL
 certificatenameflagsdecoded.SUBJECTALTREQUIREEMAIL string

SUBJECTALTREQUIREEMAIL
SUBJECTREQUIREEMAIL
 certificatenameflagsdecoded.SUBJECTREQUIREEMAIL string

SUBJECTREQUIREEMAIL
SUBJECTALTREQUIREDNS
 certificatenameflagsdecoded.SUBJECTALTREQUIREDNS string

SUBJECTALTREQUIREDNS
SUBJECTALTREQUIREDOMAINDNS
 certificatenameflagsdecoded.SUBJECTALTREQUIREDOMAINDNS string

SUBJECTALTREQUIREDOMAINDNS
ENROLEESUPLIESSUBJECTALTNAME
 certificatenameflagsdecoded.ENROLEESUPLIESSUBJECTALTNAME string

ENROLEESUPLIESSUBJECTALTNAME
OLDCERTSUPPLIESSUBJECTANDALTNAME
 certificatenameflagsdecoded.OLDCERTSUPPLIESSUBJECTANDALTNAME string

OLDCERTSUPPLIESSUBJECTANDALTNAME
SUBJECTALTREQUIREUPN
 certificatenameflagsdecoded.SUBJECTALTREQUIREUPN string

SUBJECTALTREQUIREUPN
SUBJECTALTREQUIREDIRECTORYGUID
 certificatenameflagsdecoded.SUBJECTALTREQUIREDIRECTORYGUID string

SUBJECTALTREQUIREDIRECTORYGUID
SUBJECTREQUIRECOMMONNAME
 certificatenameflagsdecoded.SUBJECTREQUIRECOMMONNAME string

SUBJECTREQUIRECOMMONNAME
SUBJECTALTREQUIRESPN
 certificatenameflagsdecoded.SUBJECTALTREQUIRESPN string

SUBJECTALTREQUIRESPN
ENROLEESUPLIESSUBJECT
 certificatenameflagsdecoded.ENROLEESUPLIESSUBJECT string

ENROLEESUPLIESSUBJECT
SUBJECTREQUIREDIRECTORYPATH
 certificatenameflagsdecoded.SUBJECTREQUIREDIRECTORYPATH string

SUBJECTREQUIREDIRECTORYPATH
privatekeyflags
 privatekeyflags integer

privatekeyflags
REQUIREALTERNATESIGNATUREALGORITHM
 privatekeyflagsdecoded.REQUIREALTERNATESIGNATUREALGORITHM string

REQUIREALTERNATESIGNATUREALGORITHM
EXPORTABLEKEY
 privatekeyflagsdecoded.EXPORTABLEKEY string

EXPORTABLEKEY
REQUIRESAMEKEYRENEWAL
 privatekeyflagsdecoded.REQUIRESAMEKEYRENEWAL string

REQUIRESAMEKEYRENEWAL
EKVALIDATECERT
 privatekeyflagsdecoded.EKVALIDATECERT string

EKVALIDATECERT
EKVALIDATEKEY
 privatekeyflagsdecoded.EKVALIDATEKEY string

EKVALIDATEKEY
STRONGKEYPROTECTIONREQUIRED
 privatekeyflagsdecoded.STRONGKEYPROTECTIONREQUIRED string

STRONGKEYPROTECTIONREQUIRED
ATTESTATIONWITHOUTPOLICY
 privatekeyflagsdecoded.ATTESTATIONWITHOUTPOLICY string

ATTESTATIONWITHOUTPOLICY
EKTRUSTONUSE
 privatekeyflagsdecoded.EKTRUSTONUSE string

EKTRUSTONUSE
ATTESTREQUIRED
 privatekeyflagsdecoded.ATTESTREQUIRED string

ATTESTREQUIRED
USELEGACYPROVIDER
 privatekeyflagsdecoded.USELEGACYPROVIDER string

USELEGACYPROVIDER
ATTESTPREFERRED
 privatekeyflagsdecoded.ATTESTPREFERRED string

ATTESTPREFERRED
REQUIREPRIVATEKEYARCHIVAL
 privatekeyflagsdecoded.REQUIREPRIVATEKEYARCHIVAL string

REQUIREPRIVATEKEYARCHIVAL
ATTESTNONE
 privatekeyflagsdecoded.ATTESTNONE string

ATTESTNONE
rasignatureapplicationpolicy
 rasignatureapplicationpolicy string

rasignatureapplicationpolicy
keytype
 keytype string

keytype
defaultkeyspecdecoded
 defaultkeyspecdecoded string

defaultkeyspecdecoded
privatekeyasymmetricalgorithm
 privatekeyasymmetricalgorithm string

privatekeyasymmetricalgorithm
requesthashalgorithm
 requesthashalgorithm string

requesthashalgorithm
privatekeysecuritydescriptor
 privatekeysecuritydescriptor string

privatekeysecuritydescriptor
privatekeyusage
 privatekeyusage string

privatekeyusage
KEYAGREEMENT
 privatekeyusagedecoded.KEYAGREEMENT string

KEYAGREEMENT
SIGNING
 privatekeyusagedecoded.SIGNING string

SIGNING
DECRYPTION
 privatekeyusagedecoded.DECRYPTION string

DECRYPTION
ALLUSAGES
 privatekeyusagedecoded.ALLUSAGES string

ALLUSAGES
keyarchivalsymmetricalgorithm
 keyarchivalsymmetricalgorithm string

keyarchivalsymmetricalgorithm
keyarchivalsymmetrickeylength
 keyarchivalsymmetrickeylength string

keyarchivalsymmetrickeylength
Important
 cloudpki.important string

Imported Certificates from this template will be marked as important
Owner Email Addresses
 cloudpki.owneremail array of string

owneremail
Imported Certificates from this template will have these Owners String
 cloudpki.owneremailstring string

owneremail
Auto Approve Account IDs
 cloudpki.autoapproveid array of string

autoapproveid
Certificate Template Auto Approver Account IDs String
 cloudpki.autoapproveidstring string

autoapproveidstring
Template Hidden
 cloudpki.hidden string

Certificate Template hidden from certificate requesters.
Renewal Status
 cloudpki.renewalstatus string

Imported certificates will have this renewal status
Last Modified Epoch Timestamp
 cloudpki.lastmodified string

Last Modified Epoch Timestamp
lastmodifiedepoch
 cloudpki.lastmodifiedepoch integer

lastmodifiedepoch
Last Modified By ID
 cloudpki.lastmodifiedid string

Last Modified By ID
Last Modified By Email
 cloudpki.lastmodifiedemail string

Last Modified By Email
Last Modified Event
 cloudpki.lastmodifiedevent string

Last Modified Event

Query Certificates

Operation ID:
Query-Certificates

Query Certificates Issued by this Cloud PKI deployment

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Time Valid
 timevalid string

Certificates that are still time valid
Important Certificate
 important string

Certificates that are marked important
Renewal Status
 renewalstatus string

Query by Current renewal status
Expiring in
 expiring integer

Certificates expiring in the next days. (Min=1 Max=180)
Subject
 subject string

Subject name to query for
Status
 status string

Current status of the certificate
Serial Number
 serialnumber string

Serial Number of the certificate to query for
Subject Key Identifier (SKI)
 ski string

Subject Key Identifier of the certificates to query for
Authority Key Identifier
 aki string

Authority Key Identifier of the certificates to query for
Key Type
 keytype string

Public Key Algorithm Type to search for
Key Length
 keylength integer

Public Key Length of the certificates to query for
Owner Email Addresses
 owneremail string

Email Address of Certificate Owners to query certificates for

Returns

Name Path Type Description
array of object
Status
 status string

Certificate Status (Issued or Revoked)
Thumbprint
 thumbprint string

Certificate SHA1 Thumbprint
Serial Number
 serialnumber string

Serial Number
Valid From
 validfrom string

Certificate Start Date
Valid To
 validto string

Certificate Expiry Date
Valid From (Epoch)
 validfromepoch integer

Certificate Start Date as Epoch timestamp
Valid To (Epoch)
 validtoepoch integer

Certificate Expiry Date as Epoch Timestamp
Issuing CA
 issuername string

The Issuers Common CA Name
Subject
 subject array of string

The subject of the certificate
SAN
 subjectalternativename array of string

Subject Alternate Names for the Certificate
Dispaly Subject
 displaysubject string

A rationalised subject name for easier identification.
Template Name
 templatename string

Template Short Name
Template ID
 cloudpki.templateid string

Cloud PKI Template ID
owneremail
 cloudpki.owneremail array of string

owneremail
Renewal Status
 cloudpki.renewalstatus string

Current Renewal Status
Life-cycle Phase
 cloudpki.phase string

Current Certificate Life-cycle Phase
Important
 cloudpki.important string

Certificate Marked As Important

Query Hooks

Operation ID:
Query-Hooks

Query all hooks in this Cloud PKI Deployment

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Status
 status string

Hook Status
Type
 type string

Hook Type
Event
 event string

Event Name

Returns

Name Path Type Description
array of object
Hook ID
 hookid string

Unique Identifier of Hook (SHA1 of Email Address or CallbackURL)
Events
 events string

Events this hook is triggered by
Call Back URL
 callbackurl string

The URL the hook will notify of subscribed events
Type
 type string

Hook Type (Web, Email or PowerBI)
Object URI
 objecturi string

Object URI of the Hook
Creator ID
 creatorid string

Username of Admin Who Created the Hook
Creator Email
 creatoremail string

Email Address of Admin Who Created the Hook
Status
 status string

Hook Status (Enabled or Disabled)
When Changed
 whenchanged date-time

When Changed Timestamp
When Changed Epoch
 whenchangedepoch integer

When Changed Epoch Timestamp
User Agent
 useragent string

Useragent Header of Hook Creation Call
Workflow - Name
 workflowdetails.workflowname string

Workflow Name of the Logic Apps or Flow Workflow
Workflow - Operation Name
 workflowdetails.workflowoperationname string

Operation Name of the Logic Apps or Flow Workflow
Workflow - ID
 workflowdetails.workflowid string

ID of the Logic Apps or Flow Workflow
Workflow - Version
 workflowdetails.workflowversion string

Version of the Logic Apps or Flow Workflow
Workflow - Subscription ID
 workflowdetails.workflowsubscriptionid string

Subscription ID of the Logic Apps or Flow Workflow
Workflow - Location
 workflowdetails.workflowlocation string

Location of the Logic Apps or Flow Workflow

Query Requests

Operation ID:
Query-Requests

Query Certificate Signing Requests

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Request Status
 status string

Current Request Status
Request Source
 source string

"Cloud PKI" or Certificate Authority Common Name eg "Issuing CA 1"
Approver ID
 approverid string

Microsoft Entra ID Approver ID
Approver Email
 approveremail string

Approvers Email Address
Submitter ID
 submitterid string

Microsoft Entra ID Submitter ID
Submitter Email
 submitteremail string

Submitters Email Address
Owner Email Addresses
 owneremail string

Certificate Owner Email Addresses

Returns

Name Path Type Description
array of object
Cloud PKI Request ID
 requestid string

Cloud PKI Request ID
Request Status
 status string

Request Status
Request Source
 requestsource string

Request Source
Display Subject
 displaysubject string

Display Subject
subject
 subject array of string

Subject
Template ID
 templateid string

Template ID
Template Name
 templatename string

Template Name
CA Request Details - CA Request ID
 requestdetails.carequestid integer

Request ID from the Issuing CA
CA Requester Name
 requestdetails.requestername string

CA Requester Name
Reference
 cloudpki.reference string

Reference
Comment
 cloudpki.comment string

Comment
Urgent Flag
 cloudpki.urgent string

Urgent Flag
Important Flag
 cloudpki.important string

Important Flag
Submitter ID
 cloudpki.submitterid string

Submitter ID
Submitter Email
 cloudpki.submitteremail string

Submitter Email
subjectalternativename
 subjectalternativename array of string

subjectalternativename

Update Certificate

Operation ID:
Update-Certificate

Change the status or metadata of a certificate

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Thumbprint
 thumbprint True string

Certificate SHA1 Thumbprint
Are You PowerApps?
 powerapps True string

Set to false unless calling from PowerApps
Important
 important string

Choose if this certificate is Important
Issued Status
 status string

Change the issued status of the certificate
Approved For Renewal
 renewalstatus string

Should this certificate be renewed?
Comment
 comment string

A comment for the Certificate
Reference
 reference string

A reference for the certificate eg Server Name, CMDB URL
Certificate Owners
 owneremail string

Certificate Owner Email Addresses

Returns

Name Path Type Description
Status
 status string

Status
Status Message
 message string

Status Message
Connector Action ID
 connectoractionid string

Connector Action ID
Thumbprint
 thumbprint string

Updated Certificate Thumbprint

Update Request

Operation ID:
Update-Request

Approve, Deny or Update an existing Certificate Request

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Request ID
 requestid True string

Cloud PKI Request ID
Are You PowerApps?
 powerapps True string

Set to false unless calling from PowerApps
Request Status
 status True string

Set the Request Status
Comment
 comment string

Set a comment on the request
Reference
 reference string

Set an RFC ID, CMDB Reference, Ticket Reference or other reference to the request
Urgent
 urgent string

Is this Certificate Request Urgent?
Important Certificate
 important string

Mark the issued Certificate as Important
Approved For Renewal
 renewalstatus string

Should this certificate be renewed?
Template Name
 templateid string

The template name for the Issued Certificate
Certificate Owners
 owneremail string

Email Addresses of Certificate Owners to be Notified of Certificate Life-Cycle Events

Returns

Name Path Type Description
Status
 status string

Status
Status Message
 message string

Status Message
Request ID
 requestid string

Request ID
Connector Action ID
 connectoractionid string

Connector Action ID

Update Template

Operation ID:
Update-Template

Change the status or metadata of a Template

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E
Template ID
 templateid True string

Certificate Template ID
Are You PowerApps?
 powerapps True string

Set to false unless calling from PowerApps
Important
 important string

Choose if certificates issued from this template are Important.
Approved For Renewal
 renewalstatus string

Choose the renewalstatus for certificates issued from this template.
Hidden
 hidden string

Choose if this template should be hidden from certificate requesters.
Certificate Owners
 owneremail string

Certificate Owner Email Addresses
Auto Approval Account IDs
 autoapproveid string

Account IDs of certificate requesters who will have their requests approved automatically

Returns

Name Path Type Description
Status
 status string

Status
Status Message
 message string

Status Message
Updated Template ID
 templateid string

Updated Certificate Template ID

Triggers

Certificate Expired

A certificate has expired.
Certificate Expiring

A certificate is expiring in 60 days
Certificate Issued

A new certificate has been issued by the Certificate Authority
Certificate Renewing

A certificate is available for renewal.
Certificate Revoked

An existing certificate has been revoked by the Certificate Authority
Certificate Updated

An existing certificate's CloudPKI properties have been updated.
Connector Action Added

A new Cloud PKI Connector action has been Added.
Connector Action Completed

An action executed by the Cloud PKI Connector has completed.
Connector Action Failed

An action executed by the Cloud PKI Connector has failed.
Connector Action Stalled

An action executed by the Cloud PKI Connector has stalled.
CRL Issued

A new certificate revocation list (CRL) has been issued by the Certificate Authority
Hook Added

A new hook has been added to this Cloud PKI deployment
Hook Removed

A hook has been removed from this Cloud PKI deployment
Request Approved

A certificate request has been approved for issuance by a Certificate Manager
Request Denied

A certificate request has been denied issuance by a Certificate Manager
Request Failed

A certificate request has failed to be processed by the Certificate Authority
Request Pending Approval

A new certificate request is pending approval from a Certificate Manager
Request Updated

An existing request's CloudPKI properties have been updated.
Template Published

A certificate template has been published by the Certificate Authority
Template Unpublished

A certificate template has been unpublished by the Certificate Authority
Template Updated

A certificate template has been updated.

Certificate Expired

Operation ID:
Expired-Certificate

A certificate has expired.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Expired Certificate Region ID
Deployment ID
 deploymentid string

Expired Certificate Deployment ID
Thumbprint
 thumbprint string

Expired Certificate Thumbprint

Certificate Expiring

Operation ID:
Expiring-Certificate

A certificate is expiring in 60 days

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Expiring Certificate Region ID
Deployment ID
 deploymentid string

Expiring Certificate Deployment ID
Thumbprint
 thumbprint string

Expiring Certificate Thumbprint

Certificate Issued

Operation ID:
Issued-Certificate

A new certificate has been issued by the Certificate Authority

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Issued Certificate Region ID
Deployment ID
 deploymentid string

Issued Certificate Deployment ID
Thumbprint
 thumbprint string

Issued Certificate Thumbprint

Certificate Renewing

Operation ID:
Renewing-Certificate

A certificate is available for renewal.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Renewing Certificate Region ID
Deployment ID
 deploymentid string

Renewing Certificate Deployment ID
Thumbprint
 thumbprint string

Renewing Certificate Thumbprint

Certificate Revoked

Operation ID:
Revoked-Certificate

An existing certificate has been revoked by the Certificate Authority

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Revoked Certificate Region ID
Deployment ID
 deploymentid string

Revoked Certificate Deployment ID
Thumbprint
 thumbprint string

Revoked Certificate Thumbprint

Certificate Updated

Operation ID:
Updated-Certificate

An existing certificate's CloudPKI properties have been updated.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Updated Certificate Region ID
Deployment ID
 deploymentid string

Updated Certificate Deployment ID
Thumbprint
 thumbprint string

Updated Certificate Thumbprint

Connector Action Added

Operation ID:
New-ConnectorAction

A new Cloud PKI Connector action has been Added.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

New Connector Action Region ID
Deployment ID
 deploymentid string

New Connector Action Deployment ID
Connector Action ID
 connectoractionid string

New Connector Action ID

Connector Action Completed

Operation ID:
Completed-ConnectorAction

An action executed by the Cloud PKI Connector has completed.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Completed Connector Action Region ID
Deployment ID
 deploymentid string

Completed Connector Action Deployment ID
Connector Action ID
 connectoractionid string

Completed Connector Action ID

Connector Action Failed

Operation ID:
Failed-ConnectorAction

An action executed by the Cloud PKI Connector has failed.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Failed Connector Action Region ID
Deployment ID
 deploymentid string

Failed Connector Action Deployment ID
Connector Action ID
 connectoractionid string

Failed Connector Action ID

Connector Action Stalled

Operation ID:
Stalled-ConnectorAction

An action executed by the Cloud PKI Connector has stalled.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Stalled Connector Action Region ID
Deployment ID
 deploymentid string

Stalled Connector Action Deployment ID
Action ID
 connectoractionid string

Stalled Connector Action ID

CRL Issued

Operation ID:
Issued-CRL

A new certificate revocation list (CRL) has been issued by the Certificate Authority

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Issued CRL Region ID
Deployment ID
 deploymentid string

Issued CRL Deployment ID
CRL ID
 crlid string

Issued CRL ID

Hook Added

Operation ID:
Added-Hook

A new hook has been added to this Cloud PKI deployment

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Added Hook Region ID
Deployment ID
 deploymentid string

Added Hook Deployment ID
Hook ID
 hookid string

Added Hook ID

Hook Removed

Operation ID:
Removed-Hook

A hook has been removed from this Cloud PKI deployment

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Removed Hook Region ID
Deployment ID
 deploymentid string

Removed Hook Deployment ID
Hook ID
 hookid string

Removed Hook ID

Request Approved

Operation ID:
Approved-Request

A certificate request has been approved for issuance by a Certificate Manager

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Approved Request Region ID
Deployment ID
 deploymentid string

Approved Request Deployment ID
Request ID
 requestid string

Approved Request ID

Request Denied

Operation ID:
Denied-Request

A certificate request has been denied issuance by a Certificate Manager

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Denied Request Region ID
Deployment ID
 deploymentid string

Denied Request Deployment ID
Request ID
 requestid string

Denied Request ID

Request Failed

Operation ID:
Failed-Request

A certificate request has failed to be processed by the Certificate Authority

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Failed Request Region ID
Deployment ID
 deploymentid string

Failed Request Deployment ID
Request ID
 requestid string

Failed Request ID

Request Pending Approval

Operation ID:
Pending-Request

A new certificate request is pending approval from a Certificate Manager

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Pending Request Region ID
Deployment ID
 deploymentid string

Pending Request Deployment ID
Request ID
 requestid string

Pending Request ID

Request Updated

Operation ID:
Updated-Request

An existing request's CloudPKI properties have been updated.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Updated Request Region ID
Deployment ID
 deploymentid string

Updated Request Deployment ID
Request ID
 requestid string

Updated Request ID

Template Published

Operation ID:
Published-Template

A certificate template has been published by the Certificate Authority

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Published Template Region ID
Deployment ID
 deploymentid string

Published Template Deployment ID
Template ID
 templateid string

Published Template ID

Template Unpublished

Operation ID:
Unpublished-Template

A certificate template has been unpublished by the Certificate Authority

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Unpublished Template Region ID
Deployment ID
 deploymentid string

Unpublished Template Deployment ID
Template ID
 templateid string

Unpublished Template ID

Template Updated

Operation ID:
Updated-Template

A certificate template has been updated.

Parameters

Name Key Required Type Description
Region ID
 regionid True string

Cloud PKI Deployment Region
Deployment ID
 deploymentid True string

Cloud PKI Deployment ID eg.. 24F3NU4E

Returns

Name Path Type Description
Region ID
 regionID string

Updated Template Region ID
Deployment ID
 deploymentid string

Updated Template Deployment ID
Template ID
 templateid string

Updated Template ID

Definitions

string

This is the basic data type 'string'.