Skip to main content

Connection and authentication issues

Use these steps to resolve common repository access failures, authentication errors, and missing asset issues when running the Talend connector workflow in Atlan.

Repository connection failure​

Error

Connection failed or Repository not found

Cause​

The workflow fails during connection when the repository URL is incorrect, the repository doesn't exist, or Atlan can't reach the repository host.

Solution​

  1. Verify the repository URL format matches your hosting platform:
    • GitHub: https://github.com/organization/repository
    • Stash: https://stash.company.com/scm/project/repository
  2. Confirm the repository exists and contains Talend project files.
  3. Verify Atlan has network access to your repository host. For on-premises Stash deployments, check firewall rules and VPN configurations.

Authentication failure​

Error

Authentication failed or 401 Unauthorized

Cause​

The workflow fails during authentication when the personal access token is invalid, expired, or lacks required permissions.

Solution​

  1. Verify the personal access token is valid and not expired.
  2. Confirm the token has the correct permissions:
    • GitHub: repo scope for private repositories or public_repo for public repositories
    • Stash: Read permissions for both project and repository
  3. Copy and paste the token carefully with no extra spaces.
  4. If the token was revoked, generate a new token and update the workflow configuration.

Missing assets or incomplete metadata​

Error

Expected jobs or components not appearing in Atlan

Cause​

The workflow completes but assets are missing when the repository doesn't contain the expected Talend project structure or the branch configuration is incorrect.

Solution​

  1. Verify .item and .properties files exist in the repository.
  2. Confirm the workflow points to the correct branch (for example, main, master, or develop).
  3. Check that the folder structure matches the Talend project export format from Talend Studio.
  4. If you specified a Talend project path, verify the subdirectory path is correct.

See also​

Need help​

If you need assistance after trying these steps, contact Atlan support by submitting a request.