Integration with Yandex-Tracker

Features

The following features are available for the Integration with Yandex Tracker:

• Test Connection
  • Allure TestOps can check the validity of the provided credentials
  • Permissions cannot be validated
• Issue Sync Operation
• Issue Suggest Operation
  • Allure TestOps can retrieve and filter the list of issues from the tracker based on the data entered by an end user
• Issue Create Operation
  • Issues can be created from Defects
• Export Launch Operation
  • If a launch is associated with some issue, then link to this launch will be added to the said issue as comment

There are 2 steps you need to perform to integrate with YandexTracker:

1. Create OAuth2 token on Yandex cloud side
2. Add integration on TestOps side

Create OAuth2 token on Yandex side

To be able to use YandexTracker, you need to be properly authenticated on Yandex side.

The creation of the authentication parameters is described in the official documentation of Yandex Cloud

https://cloud.yandex.com/en/docs/tracker/concepts/access

First, you need to authenticate at https://yandex.com/dev/

1. Open https://oauth.yandex.com/client/new
2. Add service name

• for example AllureIntegration

3. Select "Which platform is the app required for?" and click on "Insert URL for development"

4. Scroll to Data access, type "tracker" and select permissions from the list Read from tracker and Write in tracker

5. Next, for the item Link to website select Insert URL for development and click Create app

6. You'll be redirected to the created application page here you need to copy ClientID (note that lifetime of token - 1 year)

7. Next, you need to create and follow link:

https://oauth.yandex.com/authorize?response_type=token&client_id=application_ID

where application_ID - your current CLientID from point 5

8. Confirm authorization, if required

9. Now, your OAuth2 token is created and enabled

Add integration on TestOps side

The general description of enabling of an integration is described in the Integration section.

Integration recap

1. Create (get/generate/you name it) the secrets (credentials) on an external system to use their API.
2. Add the required integration on Allure TestOps global level (you need to be an administrator or have an administrator nearby).
3. Add the required integration on the project level and provide credentials (secrets) you got on the step 1.

Global level

You need to have ROLE_ADMIN authority to configure Allure TestOps instance on the global level.

1. Go to User menu > Administration > Integrations
2. In the upper-right corner click Add integration
3. Search for Yandex Tracker
4. Click on the Yandex Tracker banner
5. Provide the name of the integration
6. Provide the URL of Yandex Tracker (most likely that'll be https://tracker.yandex.com).
7. Allure TestOps will use the default API Endpoint see https://cloud.yandex.com/en/docs/tracker/concepts/access as https://api.tracker.yandex.net as the Endpoint if you leave this field empty.
   • do not update this parameter unless your instance is very special.
8. Finalise by clicking Add integration.

Adding Yandex Tracker to your project

You need to be a Project owner to configure these settings.

1. Go to the project's settings.
2. Go to the Integration section
3. Locate the Yandex Tracker integration you want to add.
4. Click Add integration.
5. In the modal window enter the credentials – the organisation ID (can be found by following the link https://tracker.yandex.com/settings)
   • OAuth2 token (described in the very beginning of this very article)
6. Click Test connection
7. Finalise the Integration settings by clicking on Add integration.

That's all folks – you can use Yandex Tracker now.