# GitHub Teams

{% hint style="info" %}
This is an older version of the document. To view the most recent version of the document, click [here](https://docs.opsmx.com/products/orchestration-module-opsmx-enterprise-for-spinnaker-oes/additional-feature-configuration/secure-spinnaker/authorization/user-role-providers/github-teams).
{% endhint %}

## Setup GitHub Team for Spinnaker <a href="#setup-github-team-for-spinnaker" id="setup-github-team-for-spinnaker"></a>

### Overview of GitHub Teams <a href="#overview-of-github-teams" id="overview-of-github-teams"></a>

* GitHub Teams, this is a group of organization members that reflects company or groups structure with cascading access and permissions to the repositories.
* Roles from GitHub are mapped to the members under a specific organization.

### Personal Access Token <a href="#personal-access-token" id="personal-access-token"></a>

* Login to the GitHub console, as an admin user of the organization.
* Navigate to ‘Developer Settings’, under Settings and click on ‘Personal Access Tokens’
* To generate a new token Click on ‘Generate New Token’
* Provide a name for the Token. (E.g. Spinnaker-Team)
* Select a Scope of access for the users ‘read:org’
* To finalize the token creation, click on ‘Generate Token’.

### Configure GitHub Teams with Spinnaker <a href="#configure-github-teams-with-spinnaker" id="configure-github-teams-with-spinnaker"></a>

* From the above steps, ensure to have admin personal token in hand.
* Execute the below Halyard commands, to Configure GitHub Teams to Spinnaker

  ```
  TOKEN=<Admin-Token Name> # Personal access token under admin account
  ORG=<Admin Org Details> # GitHub Organization

  hal config security authz github edit \
  --accessToken $TOKEN \
  --organization $ORG \
  --baseUrl https://api.github.com

  hal config security authz edit --type github

  hal config security authz enable

  ```


---

# 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.opsmx.com/opsmx-context-graph-and-data-fabric/additional-resources/previous-releases/isd-3.10/orchestration-module-opsmx-enterprise-for-spinnaker-oes/additional-feature-configuration/secure-spinnaker/authorization/user-role-providers/github-teams.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.