← Misc

GitHub

General Setup

In order to get access to Github, please make a request using JHNow using this form. Make sure you select Github Access for the Type of Request, and check General Github Access.

To help other Banno developers distinguish you and recognize you personally from your GitHub username, Banno requires you to use your Full name in your GitHub profile.

Make sure that the email address that is tied to your account is set to not be private. Uncheck the box in your Github settings listed under Email -> Keep my email addresses private.

Banno also requires all associates to have 2 factor authentication enabled in your account settings. Banno also requires all logins to be tied into the Jack Henry and Associates AD via GitHub SSO.

Windows

A few extra steps for Windows users

  • Install a package manager like Chocolatey.
  • Add openssh and git ; ex: choco install git & choco install openssh (May need to relaunch powershell/CMD after installing chocolatey and again after installing openssh and git)
  • Proceed as outlined below.

To clone Banno GitHub repositories, it is encouraged to use HTTPS cloning and authorize your personal access token for use with GitHub SSO.

Once you are added to the Banno organization, depending on your GitHub notification settings you will start receiving a lot of emails. You can filter them based on whether or not you’re mentioned, etc, to cut down on inbox noise.

GitHub SAML Single Sign-on (SSO) Requirement

If you attempt to clone a repository and get a strange error that looks like this:

$ git clone git@github.com:Banno/some-cool-banno-repo.git
Cloning into 'some-cool-banno-repo'...
ERROR: The 'Banno' organization has enabled or enforced SAML SSO. To access
this repository, you must use the HTTPS remote with a personal access token
or SSH with an SSH key and passphrase
that has been whitelisted for this organization. Visit
https://help.github.com/articles/authenticating-to-a-github-organization-with-saml-single-sign-on/ for more information.

fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

…then you need to make sure that you have enabled SSO for your SSH Key. To do this, follow the steps described here. You’ll see the Banno (JHA) organization that you’ll need to authorize for SSO.

Git Setup

For Mac, you can simply enter git in terminal and it should prompt for an install if not already installed.

Next work through labs 1 through 9 in Git Immersion to acclimate yourself with how Git works. If you are not familiar with Ruby, you can replace the code examples you commit with any arbitrary file (like a Scala file). While only labs 1-9 are required, you will use most of the information presented in the tutorial and it is worthwhile to work through all of it.

For more help, visit the official Git help guide.