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
. -
Select the org which you want to connect from the Github oauth wall.
-
Select the repositories you want to give access to and click
Install And Authorize
. -
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: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
. -
Enter the information gathered earlier in the form and click Connect.
-
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 (opens in a new tab) from Github to modify the access.