Authorization Setup

🧩 Authorization Setup

1. Connect to GitHub

1. Configure Git Repository.

2. Enter:

   • Git Provider (GitHub - github.com)

   • GitHub Personal Access Token (with repo and admin:repo_hook scopes)

     • 🔗 Creating a personal access token (classic)

     • Ensure the token has sufficient permission (

       • repo scope (for repository read access)

       • admin:repo_hook scope (for creating webhooks)

Optional: Fine-grained Personal Access Token (Recommanded for more granular control)

If you prefer more granular permission control, you can use a Fine-grained Personal Access Token instead.

🔗 Creating a personal access token (fine-grained)

Please select:

• Repository access → Only select repositories

  • Choose the repositories you want to enable auto-sync.

• Permissions → Repository permissions

  • Contents (Read-only)

  • Metadata (Read-only)

  • Webhooks (Read and write)

• Git Repository (e.g. your-org/your-repo)

• Branch Name (e.g. master)

• Test Directory Path (e.g. tests/)

  • The specified path must exist in your repository. If it’s incorrect or points to a non-existent file/folder, the sync will silently complete without importing any test cases.

3. Click Test Connection to check the credential is correct.

Note: The “Test Connection” only verifies the correctness of your GitHub credentials. It does not validate the test file path or check the repository contents.

4. Click Save Settings to complete configurating

5. You can click Enable incremental sync switch to activate git commit-based sync

The app will verify access and automatically create a webhook for the target branch.

2. Connect to Xray

1. Switch to the Test Management System Integration section.

2. Enter:

   • Test Management System (Xray - Test Management for Jira)

   • Xray Work Item Type (e.g. Test)

     • In most cases, this should be set to ”Test”, unless your Jira admin has customized the issue type mapping in Xray (e.g., renamed it or mapped “Test” to a different Jira issue type).

   • Xray Client ID and Xray Client Secret from Xray API settings

     • 🔗 How to get Xray Client ID and Client Secret

     • Select user AutoTestCase Extractor to generate Client Id and Client Secret

   • Xray Test Repository Root Path (/AutoTestCaseSync)

     • All synced test cases will be added into this root path, this value cannot be modified in this version

3. Click Test Connection and Save Settings