# Github

{% hint style="info" %} <sub>Treat tokens like keys to a building, not a master key to every city block. Smaller scope is calmer sleep.</sub>
{% endhint %}

<h2 align="center"><sub>This page means</sub></h2>

<table><thead><tr><th width="284.90911865234375">This page is</th><th>This page is not</th></tr></thead><tbody><tr><td><sub>Operator habits for PAT or app tokens</sub></td><td><sub>GitHub’s full security white paper</sub></td></tr><tr><td><sub>Save, scope, Test</sub></td><td><sub>A promise that every org policy will allow automation</sub></td></tr></tbody></table>

<h3 align="center"><sub>How to get a Github token for ARIA</sub></h3>

{% stepper %}
{% step %} <sub>**Classic Tokens**</sub>

<sub>Fine grained tokens start with</sub> <sub></sub><sub>`github_pat_`</sub><sub>. Classic tokens start with</sub> <sub></sub><sub>`ghp_`</sub><sub>.</sub> <sub></sub><sub>**ARIA uses  both.**</sub>
{% endstep %}

{% step %} <sub>**Open token settings**</sub>

<sub>Sign in to GitHub. Go to</sub> <sub></sub><sub>**Settings**</sub> <sub></sub><sub>(your profile, not a repo), then</sub> <sub></sub><sub>**Developer settings**</sub><sub>, then</sub> <sub></sub><sub>**Personal access tokens**</sub><sub>.</sub>\
![](/files/vK8iMjLCceSgkBlOtvOa)![](/files/z7JVryrbBtlCR09mV2rd)![](/files/ysONZHVYELIy2VNTaHok)
{% endstep %}

{% step %} <sub>**Scope to the repos ARIA needs**</sub>

<sub>For the full ARIA</sub> <sub></sub><sub>**Test**</sub> <sub></sub><sub>flow, product copy expects</sub> <sub></sub><sub>**create, update, and delete**</sub> <sub></sub><sub>style repo powers (classic “repo” scope or equivalent). If you only grant read, Test will fail by design.</sub>
{% endstep %}

{% step %} <sub>**Generate & copy once**</sub>

<sub>Generate the token and copy it immediately. GitHub will not show it again.</sub>
{% endstep %}

{% step %} <sub>**Watch org SAML and IP allow lists**</sub>

<sub>A token can be “valid” yet blocked by enterprise SSO. If Test fails with auth errors, open an internal ticket with your GitHub org admin.</sub>
{% endstep %}

{% step %} <sub>**Paste in ARIA and Test**</sub>

<sub>In ARIA</sub> <sub></sub><sub>**Settings**</sub><sub>, open</sub> <sub></sub><sub>**GitHub Token**</sub><sub>, paste,</sub> <sub></sub><sub>**Save**</sub><sub>, then</sub> <sub></sub><sub>**Test**</sub><sub>. If it fails, narrow or widen scopes once, then retry.</sub>
{% endstep %}
{% endstepper %}

***

<h2 align="center"><sub>Ask a question</sub></h2>

<p align="center"><sub><strong>If this token leaked in a screenshot, what is the smallest blast radius you can live with?</strong></sub> <br><sub>If the answer scares you, narrow scopes before you Save again.</sub></p>

<h3 align="center"><sub>Official GitHub links</sub></h3>

<table><thead><tr><th width="246.727294921875">Resource</th><th>URL</th></tr></thead><tbody><tr><td><sub>Personal access tokens (account)</sub></td><td><a href="https://github.com/settings/tokens"><sub>https://github.com/settings/tokens</sub></a></td></tr><tr><td><sub>Fine grained tokens</sub></td><td><a href="https://github.com/settings/personal-access-tokens"><sub>https://github.com/settings/personal-access-tokens</sub></a></td></tr><tr><td><sub>Developer settings hub</sub></td><td><a href="https://github.com/settings/apps"><sub>https://github.com/settings/apps</sub></a> <sub>(then use “Personal access tokens” in the left nav from Settings)</sub></td></tr><tr><td><sub>GitHub docs: PAT</sub></td><td><a href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens"><sub>https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens</sub></a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ariaagi.com/settings-and-integrations/github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.