Docs
⚙️ Configuration
🔌 Connectors
VCS Tools
Github

Github

Connecting your Github account:

To connect with your Github tenant, we use Oauth2 authentication. You can follow the following steps:

  • Navigate to Connectors Page (opens in a new tab) and select Github. Github Connector Card

  • Select the org which you want to connect from the Github oauth wall. Github Oauth Wall

  • Select the repositories you want to give access to and click Install And Authorize. Github Oauth Wall

  • Once done you will be redirected to Hatica app and sync process will begin. You can check the progress of the sync on the repositories (opens in a new tab) page.

Connecting your Github on-premise account:

To connect with your Github tenant, we use Oauth2 authentication. You'll need to share the following pieces of information with Hatica:

  • Personal Access Token: You can follow these instructions (opens in a new tab) from Github on how to generate a PAT. Hatica requires the following the scopes to access the data: Github On-Prem PAT scopes

    NOTE: It is advised to set the PAT expiry to the longest duration for a seamless experience.

  • Domain: Where your hosted version of Github instance. If it’s hosted behind a fire please whitelist our ip addresses. Link

  • Navigate to Connectors Page (opens in a new tab) and select Github On-prem. Github Onprem Connector Card

  • Enter the information gathered earlier in the form and click Connect. Github On-prem Connector Form

  • Hatica will validate the token and begin the sync.

FAQs

How long does initial sync take?

Depending upon the size, it can take upto 3 days for the initial sync to conclude.

Why does Hatica require write access?

Hatica requires the write access to setup webhooks for accelerated syncing of Git changes. Using webhooks, Hatica can receive near-instantaneous updates from GitHub. Note that Hatica also relies on a periodic data sync to catch-up on webhooks calls that are missed. If the webhook write access is not given, Hatica solely relies on the periodic data sync.

How can I connect my secondary github org?

Head over to https://github.com/apps/haticahq/installations/new (opens in a new tab) and authorise the installation for the relevant orgs.

How can I modify the repository access given to hatica app?

You can follow these instructions from Github to modify the access.

FAQGitlab