CyberArk-Jira-Integration

1. Clone the repository
2. Add reference to the current solution

• CyberArk.PasswordVault.PublicInterfaces.dll (copy from PVWA Bin Folder)
• Newtonsoft.Json.dll v11.0.2 (depend on your PVWA version, go to PVWA Bin Folder, right click the dll file and check)
• RestSharp.dll v106.13.0.0 (latest as of Dec 2021)

3. Ensure .NET framework is 4.8
4. Build the solution, dll will be located in the debug folder.
5. Copy this dll to PVWA Bin folder.

Function Implemented

1. Validate ticket

• Ticket's assignee need to match with PVWA user
• Ticket's status need to match with allowed status configured in PVWA -> Option -> Ticketing System
• Ticket's start time and end time need to match with PVWA user request time.
• Ticket's configuration item need to match with requesting machine/remote machine.

2. Create incident ticket to Jira with following parameter

• This scenario will trigger if user input "Create Incident Ticket" code configured in PVWA -> Option -> Ticketing System
• Static Parameter
  • requesting machine/remote machine, convert to ticket's configuration item.
  • password object's additional file categories (tower ID), convert to ticket's team name.
  • pvwa user, convert to ticket's assignee

3. Leave a comment to ticket, whenever ticket is validated successfully and user generated a RDP file successfully.

• Comment will include below parameter
  • Reason
  • Requesting User
  • Requesting User's email
  • Object's parameter
  • Dual Control
  • Dual Control Request Confirmed.
  • etc
• This parameter can be configure in the cs file.

4. Logging

• Log will be generated in PVWA server, file path can be configured in PVWA -> Option -> Ticketing System

5. Reporting

• Csv file will be generated in PVWA server, regarding the ticket validated success/fail, created success/fail.

6. Bypass Jira Validation Check in the event that jira is not available.

• User need to enter bypass code in ticket ID
• bypass code can be configured in PVWA -> Option -> Ticketing System

Configurable Item in PVWA

1. Login to PVWA as administrator, go to Option -> Ticketing System and configure below parameter.

allowedChangeTicketStatus

allowedServiceRequestTicketStatus

allowedIncidentTicketStatus

allowedProblemTicketStatus

allowTicketFormatRegex

msgInvalidTicket

msgInvalidTicketFormat

msgInvalidTicketStatus

msgConnectionError

msgInvalidAccessTime

msgInvalidMachine

msgInvalidImplementer

chkLogonToTicketingSystem

enChkTime

enChkCI (yes/no) - enable CI check based on enChkCI_CR, enChkCI_SR, enChkCI_INC

enChkCI_CR (yes/no) - enable CI check for ticket category CR

enChkCI_SR (yes/no) - enable CI check for ticket category SR

enChkCI_INC (yes/no) - enable CI check for ticket category INC

enChkImplementer

bypassJiraValidationCode

bypassJiraValidateTimeStampCode

createJiraIncValidationCode

jiraApiKey_CI

jiraApiKey_StartTime

jiraApiKey_EndTime

logFilePath