Skip to content

GitHub Access Setup for New MUSoD Employees

Purpose

This process enables new employees to gain access to MUSoD GitHub repositories using their Marquette email, while keeping the setup simple, secure, and easy to manage.

This process is intentionally split between:

  • Admin Assistant → coordinates and verifies setup
  • Technical Owner → grants access in GitHub

Overview (Simple Flow)

  1. Employee creates GitHub account
  2. Employee enables security (2FA)
  3. Employee sends username to Admin
  4. Admin forwards to Technical Owner
  5. Technical Owner grants access

Step 1 — Admin Sends Setup Instructions

Send the following message to the new employee:

📩 Message to Employee

Please complete the steps below to gain access to MUSoD systems:

  1. Go to: https://github.com/signup
  2. Create an account using your Marquette email address
  3. Choose a professional username (e.g., firstname-lastname)
  4. Verify your email

🔐 Security Requirement (Required)

After creating your account:

  1. Go to Settings → Password and Authentication

  2. Enable Two-Factor Authentication (2FA)

  3. Use an authenticator app if possible

✅ When Finished

Reply to this email with:

  • Your GitHub username
  • Confirmation that 2FA is enabled

Step 2 — Admin Verifies Response

When the employee replies:

Confirm they included:

  • GitHub username
  • Statement confirming 2FA is enabled

If anything is missing, ask them to complete it before proceeding.

Step 3 — Admin Forwards to Technical Owner

Forward the employee’s response to the Technical Owner.

📩 Example Forward Message

Subject: GitHub Access Request — MUSoD

New employee GitHub access request:

Name: [Employee Name]  
Email: [Marquette Email]  
GitHub Username: [username]  
2FA Confirmed: Yes  

Please grant appropriate access.

Step 4 — Technical Owner Grants Access

(Handled by developer / repo owner)

  • Invite user to muinformatics organization
  • Assign appropriate access (team or repo level)

Step 5 — Confirmation

Technical Owner notifies Admin (or employee directly) once access is granted.

Admin may optionally confirm:

“You should now have access to MUSoD GitHub repositories. Please verify.”

Important Notes

🔹 Personal Accounts Only

Employees must create their own GitHub accounts.

Do not create accounts on their behalf.

🔹 Security is Required

Access will not be granted unless:

  • 2FA is enabled
  • Username is provided

🔹 Existing GitHub Users

If the employee already has a GitHub account:

  • They may use it
  • They should add their Marquette email to the account

🔹 Access Control

All repository access is managed by the Technical Owner.

The Admin Assistant does not need to log into GitHub.

Admin Quick Checklist

  • [ ] Employee received instructions
  • [ ] GitHub username received
  • [ ] 2FA confirmed
  • [ ] Request forwarded to Technical Owner
  • [ ] Access confirmation received