# GitHub Authentication

Swarmia supports authentication using GitHub. GitHub authentication is automatically used if you used GitHub when signing up your organization to Swarmia.

### **Access control with multiple GitHub organizations**

If you have connected multiple [GitHub](/settings/integrations/code-hosting-platforms/github.md) organizations to a single Swarmia organization, everyone who can access Swarmia will be able to see data from all connected GitHub organizations.

In this scenario, you can choose between several options for access control:

1. User must have access to **all connected GitHub organizations** on GitHub to be allowed logging into the Swarmia organization. This ensures Swarmia users will never have more access than they would already have on GitHub. **This is the default.**
2. User must have access to at **least one connected GitHub organization** on GitHub to be allowed logging into the Swarmia organization. This is more convenient, as you don't need to add all users to all organizations GitHub-side. You may opt into this access control setup during organization merge, or later, by reaching out to our support.
3. User must have access to **your external SSO provider** (such as Okta, Google, or Microsoft Entra SSO). In this case, users logging into your Swarmia organization will see all data from all connected GitHub organizations, regardless of the access control configuration GitHub-side. **This is the default when using an external SSO provider.**

To choose between option 1 and 2, navigate to **Setings > Authentication > GitHub** and select who can sign in to Swarmia.

<figure><img src="/files/iZzjoI67csrY0BJvndQO" alt=""><figcaption></figcaption></figure>


---

# 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://help.swarmia.com/settings/integrations/authentication/github-authentication.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.