Skip to content

Commit a73a7e1

Browse files
authored
Merge pull request #1 from init6-rj/init6-rj-patch-1
Enhanced setup instructions with illustrative screenshots for improve…
2 parents f68c9b1 + f31e6ec commit a73a7e1

File tree

1 file changed

+39
-11
lines changed

1 file changed

+39
-11
lines changed

github.md

Lines changed: 39 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -18,23 +18,51 @@ But you can still use `check50` and `submit50`! You just need to log in a bit di
1818
## SSH
1919

2020
1. Open a terminal window, if not open already, within [Visual Studio Code](/code/), [CS50 IDE](/ide/index), [CS50 Sandbox](/sandbox/), or [CS50 Lab](/lab/).
21-
1. Execute `ssh-keygen`. When prompted to "save the key," just hit Enter, without typing anything.
22-
1. You'll then be prompted for a "passphrase" (i.e., password). If you only use your GitHub account for CS50, no need to input a passphrase; just hit Enter. Otherwise, input a passphrase (that you won't forget!), then hit Enter, then input it again, then hit Enter again. For security's sake, you won't see what you type. You'll then see a "randomart image" that you can ignore.
23-
1. Execute `cat ~/.ssh/id_rsa.pub`. You'll then see your "public key," multiple lines of seemingly random text. Highlight and copy all of those lines, starting with `ssh-rsa` to the end. **But don't highlight your terminal window's prompts (which contain `$`) before or after those lines.**
24-
1. Visit [https://github.com/settings/keys](https://github.com/settings/keys), logging in with your GitHub username and password as usual. Don't use the passphrase you just created, if any.
25-
1. Click **New SSH Key**.
26-
1. Paste your public key into the text box under **Key**. Optionally input a title under **Title** (e.g., `CS50`).
27-
1. Click **Add SSH Key**.
28-
1. Execute `ssh -T [email protected] -p 443`.
29-
1. Enter "yes" and press enter if you see the following prompt (the IP address might be different):
21+
22+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/41125327-ecfe-4b49-b776-dc9ecbee3f83)
23+
24+
25+
2. Execute `ssh-keygen`. When prompted to "save the key," just hit Enter, without typing anything.
26+
27+
3. You'll then be prompted for a "passphrase" (i.e., password). If you only use your GitHub account for CS50, no need to input a passphrase; just hit Enter. Otherwise, input a passphrase (that you won't forget!), then hit Enter, then input it again, then hit Enter again. For security's sake, you won't see what you type. You'll then see a "randomart image" that you can ignore.
28+
29+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/f2878e7c-fa61-4dd1-a070-a96209c79517)
30+
31+
32+
4. Execute `cat ~/.ssh/id_rsa.pub`. You'll then see your "public key," multiple lines of seemingly random text. Highlight and copy all of those lines, starting with `ssh-rsa` to the end. **But don't highlight your terminal window's prompts (which contain `$`) before or after those lines.**
33+
34+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/b9ff868f-7bca-47cb-80fa-f674a1fa6fd9)
35+
36+
37+
5. Visit [https://github.com/settings/keys](https://github.com/settings/keys), logging in with your GitHub username and password as usual. Don't use the passphrase you just created, if any.
38+
39+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/f1a880b2-818f-4f71-ab70-62ee66c7d35c)
40+
41+
42+
6. Click **New SSH Key**.
43+
44+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/1efc9a59-251c-45e0-adb5-a0dc354f5d20)
45+
46+
47+
7. Paste your public key into the text box under **Key**. Optionally input a title under **Title** (e.g., `CS50`).
48+
8. Click **Add SSH Key**.
49+
50+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/a6573592-c9fc-4915-988e-56670afd6d4d)
51+
52+
53+
9. Execute `ssh -T [email protected] -p 443`.
54+
10. Enter "yes" and press enter if you see the following prompt (the IP address might be different):
3055
```
3156
The authenticity of host '[ssh.github.com]:443 ([140.82.113.35]:443)' can't be established.
3257
ED25519 key fingerprint is SHA256:7KMZvJiITZ+HbOyqjKJV2AeC5As3GSZES5abcd1NIe4.
3358
This key is not known by any other names
3459
Are you sure you want to continue connecting (yes/no/[fingerprint])?
3560
```
36-
1. If you input a "passphrase" (i.e., password) earlier, enter the passphrase and press Enter when you see the following prompt `"Enter passphrase for key 'home/ubuntu/.ssh/id_rsa':"`
37-
1. You should be greeted with `"Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access."` If you don't see that, review the above steps to verify you didn't skip something.
61+
11. If you input a "passphrase" (i.e., password) earlier, enter the passphrase and press Enter when you see the following prompt `"Enter passphrase for key 'home/ubuntu/.ssh/id_rsa':"`
62+
12. You should be greeted with `"Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access."` If you don't see that, review the above steps to verify you didn't skip something.
63+
64+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/5ba967f4-5fe3-4276-bd43-4aa419b57f36)
65+
3866
3967
You should now be able to use `check50` and `submit50` (and `git`) without GitHub username and password. But if you created a passphrase, you might still be prompted for that.
4068

0 commit comments

Comments
 (0)