From 828298704da6fee5332f68d4192f6b8f008468da Mon Sep 17 00:00:00 2001 From: Toby Hodges Date: Mon, 25 Sep 2023 11:15:16 +0200 Subject: [PATCH 1/3] add guidance fr configuring 2FA on GitHub accounts --- learners/setup.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/learners/setup.md b/learners/setup.md index a2f6e21b57..a6fed48a59 100644 --- a/learners/setup.md +++ b/learners/setup.md @@ -12,6 +12,40 @@ instructions on installing Git for various operating systems. - [Git installation on MacOS][workshop-setup] - [Git installation on Linux][workshop-setup] +## Creating a GitHub Account + +You will need an account for [GitHub](https://github.com) to follow this lesson. + +1. Go to and follow the "Sign up" link at the top-right of the window. +2. Follow the instructions to create an account. +3. Verify your email address with GitHub. +4. Configure multifactor authentication (see below). + +### Multi-factor Authentication + +In 2023, GitHub introduced a requirement for +all accounts to have +[multi-factor authentication (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication) +configured for extra security. +Several options exist for setting up 2FA, which are summarised here: + +1. If you already use an authenticator app, + like [Google Authenticator](https://support.google.com/accounts/answer/1066447?hl=en&co=GENIE.Platform%3DiOS&oco=0) + or [Duo Mobile](https://duo.com/product/multi-factor-authentication-mfa/duo-mobile-app) on your smartphone for example, + [add GitHub to that app](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-totp-mobile-app). +2. If you have access to a smartphone but do not already use an authenticator app, install one and + [add GitHub to the app](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-totp-mobile-app). +3. If you do not have access to a smartphone or do not want to install an authenticator app, you have two options: + 1. [set up 2FA via text message](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages) + ([list of countries where authentication by SMS is supported](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/countries-where-sms-authentication-is-supported)), or + 2. [use a hardware security key](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key) + like [Youbikey](https://www.yubico.com/products/yubikey-5-overview/) + or the [Google Titan key](https://store.google.com/us/product/titan_security_key?hl=en-US&pli=1). + +The GitHub documentation provides [more details about configuring 2FA](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication). + +---------------- + ## Preparing Your Working Directory We'll do our work in the `Desktop` folder so make sure you change your working directory to it with: From 67c18ff31b720b6bb50cae4c75e1b875755c1102 Mon Sep 17 00:00:00 2001 From: Toby Hodges Date: Tue, 26 Sep 2023 10:13:09 +0200 Subject: [PATCH 2/3] More specific GitHub instructions Co-authored-by: Katherine Koziar --- learners/setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learners/setup.md b/learners/setup.md index a6fed48a59..e8065f45c0 100644 --- a/learners/setup.md +++ b/learners/setup.md @@ -14,7 +14,7 @@ instructions on installing Git for various operating systems. ## Creating a GitHub Account -You will need an account for [GitHub](https://github.com) to follow this lesson. +You will need an account for [GitHub](https://github.com) to follow episodes 7 & 8 in this lesson. 1. Go to and follow the "Sign up" link at the top-right of the window. 2. Follow the instructions to create an account. From 78ce883317556457f597d4ef3eab06beed59e86a Mon Sep 17 00:00:00 2001 From: Toby Hodges Date: Tue, 26 Sep 2023 10:13:09 +0200 Subject: [PATCH 3/3] More specific GitHub instructions Co-authored-by: "K.E. Koziar" --- learners/setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learners/setup.md b/learners/setup.md index a6fed48a59..e8065f45c0 100644 --- a/learners/setup.md +++ b/learners/setup.md @@ -14,7 +14,7 @@ instructions on installing Git for various operating systems. ## Creating a GitHub Account -You will need an account for [GitHub](https://github.com) to follow this lesson. +You will need an account for [GitHub](https://github.com) to follow episodes 7 & 8 in this lesson. 1. Go to and follow the "Sign up" link at the top-right of the window. 2. Follow the instructions to create an account.