# GitHub

### **Steps to Create a GitHub Integration** <a href="#steps-to-create-an-github-integration" id="steps-to-create-an-github-integration"></a>

&#x20;

For Personal Access Token permissions and guidelines, follow this link [GitHub | In-Product Guides](https://docs.ozone.one/in-product-guides/github)

**Pre-requisites**

* Username
* personal access token

**Steps:**

1. Enter the details required to link your provider for onboarding the repository and click **Create Integration**.

<figure><img src="https://3829750647-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAObcOkMb6sCSnSdcUOTm%2Fuploads%2Fxc6WKOeAMKylKIIW1idi%2FScreenshot%202024-05-07%20at%2012.31.57%E2%80%AFPM.png?alt=media&#x26;token=edb78d76-fb41-43e6-8537-4db9d5f559e0" alt=""><figcaption></figcaption></figure>

2. Once the credentials are verified a modal window is shown to choose the organizations you want to integrate into Ozone, here you can click the toggle switch below if you want your personal repositories to be integrated

<figure><img src="https://3829750647-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAObcOkMb6sCSnSdcUOTm%2Fuploads%2FjnnjToIwmVL79uAwGMI7%2FScreenshot%202024-05-07%20at%2012.42.36%E2%80%AFPM.png?alt=media&#x26;token=3f7334e5-f5d8-495e-9bca-8a7591673f6f" alt=""><figcaption></figcaption></figure>

3. Once done selecting click on **Submit** below

<figure><img src="https://3829750647-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAObcOkMb6sCSnSdcUOTm%2Fuploads%2F4aJyneI3Y1ipK9s5vTfo%2FScreenshot%202024-05-07%20at%202.54.14%E2%80%AFPM-20240507-092420.png?alt=media&#x26;token=582609df-29fc-48d4-bd87-56123c85acda" alt=""><figcaption></figcaption></figure>

4. &#x20;Once the integration is created, the resources will be synced, and the status of the resource synced will be shown on the top left of the integration card ( as shown above - *Success)*<br>

   Click the card to get a detailed view of the integration created, user can view the credentials and the resources that are synced, in this case the sync fails the user can click the sync icon on the top right to sync again\
   \
   This integration Syncs the Repositories that you allow from your Github Account

<figure><img src="https://3829750647-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAObcOkMb6sCSnSdcUOTm%2Fuploads%2F4q6cvGdTM6uN0iYHMA4r%2Fimage-20240507-101945.png?alt=media&#x26;token=963203d6-a162-4266-abd9-d1714f4ac251" alt=""><figcaption></figcaption></figure>
