> ## Documentation Index
> Fetch the complete documentation index at: https://hub.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Github

> Follow these steps to connect Github via the StackOne Hub successfully.

<Warning>
  Ensure that your Github account has the Owner privileges in the organization you are making connection with.
</Warning>

If you've been directed to StackOne to integrate with Github, the following steps will help you understand the process and any necessary actions to configure a successful integration.

## Log in to Github

<Step title="Log in">
  Log in to your Github account at [https://github.com/login](https://github.com/login).

  <Frame>
    <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Log in" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image2.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=b524124fde7df758c351494677605477" width="1622" height="588" data-path="images/github/image2.png" />
  </Frame>
</Step>

## Create a New Personal Access Token

<Steps>
  <Step title="Navigate to Your Profile">
    Click the **Settings** tab.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to Your Profile" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image3.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=d6fc5194d1c53a6f6ce7612d65a30914" width="763" height="692" data-path="images/github/image3.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Developer settings tab">
    Click **Developer settings**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to Developer settings" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image4.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=c4655189f0a782cd75a4ab7613d097b6" width="1256" height="684" data-path="images/github/image4.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Personal access tokens tab">
    Select **Tokens (classic)** from the **Personal access tokens** dropdown.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to Personal Access Tokens" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image5.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=869e46771c409af392f93d37af56036c" width="1441" height="389" data-path="images/github/image5.png" />
    </Frame>
  </Step>

  <Step title="Generate new token">
    Click the **Generate new token** dropdown.
    Select **Generate new token (classic)** from the dropdown.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generate new token" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image6.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=cadc50ad69a81fe61c07b6b83b2b7164" width="1484" height="524" data-path="images/github/image6.png" />
    </Frame>
  </Step>

  <Step title="Expiration">
    Select **No expiration** from the Expiration dropdown.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select Expiration" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image7.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=25a4a59f808619358d8b83a3bfb759bc" width="1466" height="617" data-path="images/github/image7.png" />
    </Frame>
  </Step>

  <Step title="Scopes">
    Select the following **Scopes** which are required for this IAM integration.

    <ul>
      <li>admin-org</li>
    </ul>

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Scopes" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image8.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=3ce74fbc88dbbe022cf7da021e5e49ba" width="1449" height="803" data-path="images/github/image8.png" />
    </Frame>
  </Step>

  <Step title="Generate token">
    Scroll down to the bottom and click **Generate token**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generate token" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image9.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=ff015cba932ad1ae060ddb024522e514" width="953" height="269" data-path="images/github/image9.png" />
    </Frame>
  </Step>

  <Step title="Copy your Personal Access Token">
    Your new **Personal Access Token** will be displayed only once. Copy and store this value securely.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy your Personal Access Token" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image10.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=8f631a87beddbce2632220cf93d63b3c" width="1627" height="619" data-path="images/github/image10.png" />
    </Frame>
  </Step>
</Steps>

## Find Organization

<Steps>
  <Step title="Navigate to Your Profile">
    Select **Your organizations** tab.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy your Personal Access Token" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image11.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=9e5fa6de47911460ffc687a2771be280" width="804" height="672" data-path="images/github/image11.png" />
    </Frame>
  </Step>

  <Step title="Organization name">
    You can find the list of organizations here. Copy the **Name** of the organization you wish to connect.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy your Personal Access Token" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image13.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=e5420b375c89a5a9c9010aec0dccf329" width="1008" height="430" data-path="images/github/image13.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter the credentials from the previous steps:

    * **Personal Access Token**
    * **Organization**

    Proceed by clicking the Connect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Credentials" src="https://mintcdn.com/stackone-hub/_t7Al4-v7TDhyzSs/images/github/image12.png?fit=max&auto=format&n=_t7Al4-v7TDhyzSs&q=85&s=d861723c8250a150e2e5b3504b9c8cb4" width="757" height="699" data-path="images/github/image12.png" />
    </Frame>
  </Step>
</Steps>

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/getting-started-with-your-api) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
</ul>
