You are viewing an earlier version of the admin guide. For the latest version, please visit EmpowerID Admin Guide v7.211.0.0.
Integrate EmpowerID Business Requests with ServiceNow Request Ticketing
If your organization has successfully integrated EmpowerID with ServiceNow, you have the ability to automate the creation of Request tickets in ServiceNow whenever a Business Request is initiated in EmpowerID. This allows organizations utilizing ServiceNow for their IT Service Management (ITSM) to maintain a comprehensive record of all EmpowerID-originated requests within ServiceNow. This record includes essential details such as the request's status, the requester's identity, the request's timestamp, information on approvals or rejections, and any associated comments.
The screenshots below show the correlation between a request for group membership initiated in EmpowerID and the request record in ServiceNow.
Â
Â
Architectural Overview
Understanding the architecture is crucial for effective implementation and ongoing management. The primary components involved in this integration are:
Business Request Type: Defines the approval processes.
ITShop Business Request Type: Specific type for EmpowerID's IAM Shop.
Workflow Triggers: Decide what happens when a Business Request reaches a particular state.
Pre-Approval Step Workflow Job: Scheduled task to initiate workflow.
Specialized Workflows: Such as
CreateSnowRequestForBR
andUpdateSNOWRequestStatus
.
Business Request Type
The Business Request Type is a core element of EmpowerID's Approval Flow engine. It allows organizations to specify the approval processes required when users request access to resources. Business Request Types have several configurable settings that can be used to direct how the system processes requests belonging to that type. For Business Requests originating from EmpowerID's IAM Shop, the relevant Business Request Type is known as the "ITShop Business Request Type." In the case of integrating with ServiceNow ticketing, it is the specific workflows selected in these general Business Request Type settings that enable the integration:
Workflow to Run on Step Ready: This setting within the Business Request Type determines the workflow that will be initiated when a step in the Approval Flow policy is ready for an approval decision. For seamless integration with ServiceNow, the workflow typically selected here is
CreateSnowRequestForBR
.Workflow to Run on Fulfillment: This setting within the Business Request Type outlines the workflow that will be triggered when a Business Request is approved. In the context of ServiceNow integration, the workflow commonly selected for this setting is also
CreateSnowRequestForBR
.
Pre Approval Step Workflow Job
This is a scheduled task in EmpowerID that is responsible for claiming open Business Requests associated with the ITShop Business Request Type and starting the designated workflow.
Claiming Conditions: Business Requests that share the same
PreStepRequestWorkflowID
are grouped together.Triggered Workflow: For ServiceNow integration,
CreateSnowRequestForBR
is initiated.
Specialized Workflows
CreateSnowRequestForBR Workflow
This workflow interfaces with the ServiceNow API to generate the corresponding Request and Request Item records in ServiceNow based on Business Requests in EmpowerID.
UpdateSNOWRequestStatus Workflow
Operating continuously, this workflow syncs the status and metadata between EmpowerID and ServiceNow, ensuring up-to-date records in both systems.
Process Flow
The below illustration depicts the process flow for this. A description follows the illustration.
Â
Initiation: Users request access to resources via EmpowerID’s IAM Shop.
Claiming Business Requests: The Pre-Approval Step Workflow Job claims open Business Requests meeting certain conditions:
Yet to be processed.
PreStepRequestWorkflowID
is not null.
Validation and Processing: The
CreateSnowRequestForBR
workflow validates Business Requests and sets the processing status accordingly.Successful: Status set to 2.
Failed: Status set to 3, with retries scheduled.
ServiceNow Ticket Creation: On successful validation, ServiceNow Request and Request Items are created.
Approval Tasks: Routed to EmpowerID’s My Tasks Microservice for further action.
Data Mapping and Synchronization
Business Requests
ServiceNow Fields | EmpowerID Fields |
---|---|
Active | True |
State | Pre-defined state value from permanent workflow (field name: |
Priority | Pre-defined priority value from permanent workflow (field name: |
Approval | Pre-defined approval value from permanent workflow (field name: |
Opened_by | Business Request initiator |
Requested_for | Target Person of Business Request |
Description | Pre-defined description value from permanent workflow (field name: |
Short Description | Pre-defined short description value from permanent workflow (field name: |
GUID | ExternalProcessID |
Request Number | ExternalProcessNumber |
snowResourceSystem.ResourceSystemGUID | ExternalResourceSystemID |
Approved | Approved |
Partially Approved | Approved |
Rejected | Rejected |
Cancelled | Cancelled |
Business Request Items
ServiceNow Fields | EmpowerID Fields |
Active | True |
State | Pre-defined state value from permanent workflow (field name: |
Priority | Pre-defined priority value from permanent workflow (field name: |
Approval | Pre-defined approval value from permanent workflow (field name: |
Opened_by | Business Request initiator |
Request | SNOW Request GUID |
Cat_item | Pre-defined approval value from permanent workflow (field name: |
Requested_for | Target Person of Business Request |
Description | Pre-defined description value from permanent workflow (field name: |
Short Description | Pre-defined short description value from permanent workflow (field name: |
GUID | ExternalProcessID |
Request Item Number | ExternalProcessNumber |
snowResourceSystem.ResourceSystemGUID | ExternalResourceSystemID |
Approved | Approved |
Rejected | Rejected |
Cancelled | Cancelled |
If the Business Request Item has an approver in EmpowerID, the workflow assigns the same approver to the associated ServiceNow Request Item and sets the approval state to “requested in ServiceNow.
Â
ServiceNow Ticket Integration Procedure