# Github

Integrate your Github account with HPE Morpheus Enterprise and have access to all your public and private repositories within the platform. Use your existing code and any future code to build automation Tasks and Workflows, onboard Spec Templates for Terraform and Kubernetes to build App configurations, and more. Integrated Github repositories also populate the Code list page (Provisioning > Code) where repositories can be browsed and individual files can be viewed. Repositories can be configured as [import and export](https://docs.morpheusdata.com/en/latest/provisioning/code/code.html?highlight=import#import-and-export) targets from Code detail pages as well. Each time code from your repositories is invoked in Tasks, Workflows, Spec Templates, and more, HPE Morpheus Enterprise will pull the current live version (depending on configuration) so any recent changes to the code are used.

## Generating a Personal Access Token (Classic)

### About this task

As of August 13, 2021, due to policy changes on the Github platform, HPE Morpheus Enterprise requires an access token to authenticate with Github. Password authentication is no longer possible. HPE Morpheus Enterprise accepts both classic personal access tokens and fine-grained tokens (described in the next section). To create a new access token:

### Procedure

1. Log in to Github
2. Click on your account profile avatar in the upper-right portion of the window
3. Click Settings
4. From the left nav, click on Developer Settings
5. Once again from the left nav, click Personal access tokens
6. Click “Tokens (classic)”
7. Click Generate new token
8. Click “Generate new token (classic)”
9. Give the new token at least access to everything in the “repo” scope
10. Click Generate token
11. Copy the access token and save it for the next step when the integration is created

### Results

TIP

We recommend using a long-lived token, Github even includes the option to have no expiration on your tokens (for classic personal access tokens only, not fine-grained tokens). Should the token expire, any HPE Morpheus Enterprise automation, App Blueprints, and Terraform or Kubernetes Spec Templates which are based on code contained in your repositories will no longer work. This could lead to failed provisioning and time spent troubleshooting to isolate the issue until the Github integration is refreshed with a new access token.

## Generating a Fine-Grained Token

### About this task

As of August 13, 2021, due to policy changes on the Github platform, HPE Morpheus Enterprise requires an access token to authenticate with Github. Password authentication is no longer possible. HPE Morpheus Enterprise accepts both classic personal access tokens and fine-grained tokens. To create a new fine-grained access token:

### Procedure

1. Log in to Github
2. Click on your account profile avatar in the upper-right portion of the window
3. Click Settings
4. From the left nav, click on Developer Settings
5. Once again from the left nav, click Personal access tokens
6. Click “Fine-grained tokens”
7. Click Generate new token
8. Give the token access to all repositories unless you will only need to work with specific repositories within HPE Morpheus Enterprise
9. Click Generate token
10. Copy the access token and save it for the next step when the integration is created

### Results

TIP

Fine-grained tokens can be created with an expiration date of up to one year. Should the token expire, any HPE Morpheus Enterprise automation, App Blueprints, and Terraform or Kubernetes Spec Templates which are based on code contained in your repositories will no longer work. This could lead to failed provisioning and time spent troubleshooting to isolate the issue until the Github integration is refreshed with a new access token.

## Creating an Integration

### About this task

New Github integrations are created either in the global integrations section (Administration > Integrations) or in the code integrations section (Provisioning > Code > Integrations). You will need a Github access token to complete this step, see the prior section for instructions on obtaining a Github access code.

### Procedure

1. Navigate to the global integrations section (Administration > Integrations) or the code integrations section (Provisioning > Code > Integrations)
2. Click +ADD
3. Click Github
4. Configure the following: 

   - NAME: A friendly name for the Github integration in HPE Morpheus Enterprise
   - ENABLED: When marked, this Github integration is active and any code repositories are available for building HPE Morpheus Enterprise automation and other constructs within the platform
   - USERNAME: The username for your Github account
   - PASSWORD: Copy your access token here rather than in the “ACCESS TOKEN” field. See the “Important” box below for additional details
   - ACCESS TOKEN: Do not use this field. See the “Important” box below for additional details
   - KEY PAIR: (Optional) Select a stored SSH keypair for Github SSH authentication
   - ENABLE GIT REPOSITORY CACHING: When unmarked, HPE Morpheus Enterprise retrieves code fresh from the repository each time it’s invoked. When marked, HPE Morpheus Enterprise will use a cached version of the code if it’s less than five minutes old. In general, this should be left unmarked unless you are experiencing performance issues related to very large amounts of code being invoked many times during a deployment
5. Click SAVE CHANGES

### Results

IMPORTANT

Your access token should be pasted into the PASSWORD field and not the ACCESS TOKEN field. If the ACCESS TOKEN field is used, the repository will create successfully and many features will work. However, in Code detail pages (Provisioning > Code > Selected code detail page), you will not be able to browse files in private Github repositories unless the access token is pasted into the PASSWORD field. New Github integrations should be created by pasting the access token in the PASSWORD field and the ACCESS TOKEN field should be ignored.

NOTE

In certain cases, it can take several seconds for the integration process to complete and the ADD INTEGRATION modal to be dismissed.

## Viewing an Integrated Github Account

When authentication is successful, click into the new Github integration from the list of available integrations. The Organizations tab will list each organization the Github account is associated with. The Repositories tab lists all public and private repositories which are associated with the account. We can also click in to each repository to view its files and folders, as well as create specific types of automation or Spec Templates from the files directly in this view.

![../../_images/github.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-19D7B591-B18D-4BB5-A378-425A0110A7C7-high.png)
