Workflow Definitions

The Workflow A workflow is a series of steps necessary to complete a process. In the context of Keyfactor Command, it refers to the workflow builder, which allows you automate event-driven tasks when a certificate is requested or revoked. Definitions component of the Keyfactor API A set of functions to allow creation of applications. Keyfactor offers the Keyfactor API, which allows third-party software to integrate with the advanced certificate enrollment and management features of Keyfactor Command. includes methods necessary to programmatically create, edit, retrieve, and test workflow definitions. There are two types of workflow definition:

• Global

  The global workflow definitions are built into the product and cannot be deleted, though they can be modified to add workflow steps, if desired. Global workflow definitions do not have a specific associated key—in the case of the currently available workflows, this is a certificate template—and apply to all requests of the workflow's type (e.g. enrollment Certificate enrollment refers to the process by which a user requests a digital certificate. The user must submit the request to a certificate authority (CA).) that are not otherwise handled by a custom workflow specifying a key.

• Custom

  Custom workflow definitions are any additional workflow definitions you define beyond the built-in ones. Custom workflows are associated with a specific key (certificate template A certificate template defines the policies and rules that a CA uses when a request for a certificate is received. or certificate collection The certificate search function allows you to query the Keyfactor Command database for certificates from any available source based on any criteria of the certificates and save the results as a collection that will be availble in other places in the Management Portal (e.g. expiration alerts and certain reports).) and each workflow only applies to requests made using that key.

All enrollment, certificate renewal, and revocation requests go through workflow even if you haven't created any workflow steps or added any custom workflow definitions. In the absence of customization, the global workflow definitions are used. The addition and removal of certificates from certificate collections can be configured to flow through workflow as well, but there are no global workflows for these.

For more information about workflows, see Workflow Definitions in the Keyfactor Command Reference Guide.

Table 635: Workflow Definitions Endpoints

Endpoint	Method	Description	Link
/Steps/{extensionName}	GET	Returns information about the structure of the workflow definition step with the specified name.	GET Workflow Definitions Steps Extension Name
/{definitionId}	DELETE	Deletes the workflow definition with the specified GUID.	DELETE Workflow Definitions Definition ID
/{definitionId}	GET	Returns details of the workflow definition, including steps, for the workflow with the specified GUID.	GET Workflow Definitions Definition ID
/{definitionId}	PUT	Updates the name and description of the workflow definition with the specified GUID.	PUT Workflow Definitions Definition ID
/	GET	Returns a list of workflow definitions, without steps.	GET Workflow Definitions
/	POST	Creates a new workflow definition, without steps.	POST Workflow Definitions
/Steps	GET	Returns information about the structure of the workflow definitions.	GET Workflow Definitions Steps
/Types	GET	Returns a list of the defined workflow definition types.	GET Workflow Definitions Types
/{definitionId}/Steps	PUT	Updates the workflow definition with the specified GUID to add new steps or modify existing steps.	PUT Workflow Definitions Definition ID Steps
/{definitionId}/Publish	POST	Publishes the workflow definition with the specified GUID to activate it for use.	POST Workflow Definitions Definition ID Publish