All active faculty, staff, and students can use the NC State GitHub service via GitHub Enterprise Cloud by logging in to github.com via EntraID SSO. External users can be added as guest accounts by request to authenticate and access the service. Service accounts can also log in after approval by the GitHub Service Team.
Logging in to GitHub with your Unity Account
1. Go to https://github.com
2. Click on "Sign In" in the upper right corner of the screen.
2b. If you are already logged in to a personal account, you can use the Account Switcher feature to add your NC State account.
3. Enter your Unity ID in the username field, followed by an underscore, followed by "ncstate": cacard_ncstate
4. Click the green "Sign in with your identity provider" button.
5. You should see a prompt for "Single sign-on to North Carolina State University". Click the green Continue button.
6. You will be redirected to an EntraID login for NC State. Log in by following the on-screen instructions.
7. After entering your password, you'll be prompted to "Verify your identity". Click "Approve with NCSU Duo".
8. Follow the on-screen instructions to verify your identity via Duo.
9. If you are prompted to "Stay signed in?", choose yes or no, depending on if would like to stay signed in.
10. You will be redirected back to github.com, logged in to your NC State GitHub account.
Logging in to GitHub as an external Guest Account
1. First, request an external guest account from the GitHub Service Team
2. Go to https://github.com
3. Click on "Sign In" in the upper right corner of the screen.
3b. If you are already logged in to a personal account, you can use the Account Switcher feature to add your NC State account.
4. Enter your username provided by the GitHub Service Team.
4. Click the green "Sign in with your identity provider" button.
5. You should see a prompt for "Single sign-on to North Carolina State University". Click the green Continue button.
6. You will be redirected to an EntraID login for NC State. Log in by entering your email address.
7. Depending on your account type, you may be prompted for the password for your parent institution account, or you may receive a one-time passcode via email.
7. Next, you'll be prompted to "Verify your identity". Depending on your account type, this may be via Microsoft Authenticator, or another 2FA solution.
8. If you are prompted to "Stay signed in?", choose yes or no, depending on if would like to stay signed in.
9. You will be redirected back to github.com, logged in to your NC State GitHub account.
Logging in to GitHub with a Service Account
1. Ensure that your service account has been approved by access by the GitHub Service Team and enrolled in Duo by Security and Compliance.
2. Go to https://github.com
3. Click on "Sign In" in the upper right corner of the screen.
3b. If you are already logged in to a personal account, you can use the Account Switcher feature to add your NC State account.
4. Enter your Service Account name in the username field, converting dots to dashes, followed by an underscore, followed by "ncstate": oit-example-svc_ncstate
5. Click the green "Sign in with your identity provider" button.
6. You should see a prompt for "Single sign-on to North Carolina State University". Click the green Continue button.
7. You will be redirected to an EntraID login for NC State. Log in by following the on-screen instructions. Your username may be @ncsu.edu or @wolftech.ad.ncsu.edu, depending on the SPN.
8. After entering your password, you'll be prompted to "Verify your identity". Click "Approve with NCSU Duo".
9. Follow the on-screen instructions to verify your identity via Duo. Note that you may need to choose a different option if there are multiple devices enrolled for the account.
10. If you are prompted to "Stay signed in?", choose yes or no, depending on if would like to stay signed in.
11. You will be redirected back to github.com, logged in to your NC State GitHub service account.
It is highly recommended to create personal access tokens and configure SSH keys to limit the number of times you need to log in via the web to a service account.