Before creating an integration using Integration Hub, we recommend reading through the following articles to get started.

• Integration Hub Overview
• Enabling the Integration Hub

Creating a Rally Integration

Rally is an Agile Planning and Test Management platform where Cyara failures can be fed as a defect for easier Defect Tracking purposes. 

To build an integration with Rally, follow the steps below.

1. Login to your Cyara Portal.
2. Click on Tools > Integrations. (If this menu does not appear in the Tools menu, confirm that the user account you're currently logged into is provisioned to use the Integration Hub).
3. Click the New Integration button.
4. Select Rally from the Type dropdown menu.
5. Enter a Name and a Description for the integration.
   
   
   
   
6.  Select a User account to access the Cyara REST API with the Impersonate User field.
7. Enter the following Rally Details
   • API Url for your Rally instance (e.g https://rally1.rallydev.com/ )
   • Incident Portal Url : (e.g https://rally1.rallydev.com/#/{projectId}/defects?detail=/defect/{id} ) Note: These Urls are specific to your own Rally Account and setup, also make sure to include {id} and {projectId} tags in the Url.
     
     
   • API User Token & From User.
     • Generate your Rally API User Token by clicking on the API Keys menu in your rally instance and selecting Create API Key.
       
       Select "Full Access" and click Create, you will be presented with a new API Key.
       
       
       
8. Click on the Test Authentication button to confirm that your API User Token and User Account credentials are working correctly.
   
9. In the Field Mapping section, select the New Rally Field to create a pre-formatted field mapping for a set Rally field.
   The following table contains the default list of fields available in Rally.
   

   • Parameters	Configurable
     API Token	Y
     Incident URL	Y
     Incident Portal Url	Y
     Project	Y - This has to be a choice field if it needs to be done through Cyara Alarm Else a Lookup Field for regular defect integration
     Tags	Y
     Iteration	Y
     Description	Y
     Name	Y
     Notes	Y
     User Story	Y (Known Issue: All user stories in the project will get loaded irrespective of the iteration selection)
     Test Cases	Cannot be mapped: A known issue that will be addressed in a future release.
     Owner	Cannot be mapped: A known issue that will be addressed in a future release.

10. Additionally, you can create Custom Fields to map to Rally.
    The following table contains the additional custom field configuration available for the Cyara-Rally integration.
    • 
      

      Custom Field Display Name	Rally Field Name	Field Type	Rally Field Value
      Priority	Priority	Choice	None,Normal,Low,High Attention,Resolve Immediately
      Severity	Severity	Choice	None, Minor Problem, Major Problem, Crash/Data Loss, Cosmetic
      State	State	Choice	Submitted,Fixed,Closed,Open
      Environment	Environment	Choice	None,Development,Test,Staging,Production
      Scheduled State	ScheduleState	Choice	Defined,In-Progress,Accepted,Completed
      Resolution	Resolution	Choice	None, Architecture, Code Change, Configuration Change, Database Change, Duplicate, Need More Information, Not a Defect, Software Limitation, User Interface
      TargetDate	TargetDate	Single line text	2020-11-20
      FixedInBuild	FixedInBuild	Single line text	Test20.0.1
      TargetBuild	TargetBuild	Single line text	Test20.0.1
      VerifiedInBuild	VerifiedInBuild	Single line text	Test20.0.1
      FoundInBuild	FoundInBuild	Single line text	Test20.0.1
      PlanEstimate	PlanEstimate	Single line text	5
      SalesforceCaseID	SalesforceCaseID	Single line text	123
      SalesforceCaseNumber	SalesforceCaseNumber	Single line text	232652d
      Blocked	Blocked	Choice	true,false
      BlockedReason	BlockedReason	Single line text	Testing
      Ready	Ready	Choice	True, false (Note: Ready and Blocked status can’t be set to true at the same time)

11.  Click Save Details to save your changes, and Enable the integration using the toggle in the top right corner of the integration editing screen.
    

Note: As mentioned above there are known issues with the current version of the Cyara Rally Integration, where User Stories, Test Cases, and Owner fields are not being mapped correctly. These issues will be addressed in a future release.