Skip to content

Commit ab11104

Browse files
committed
Add GH authentication reference page
1 parent cb0ad8d commit ab11104

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

reference/03-gh-auth.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# 🔐 Configuring GitHub authentication
2+
3+
GitHub authentication on shared cloud infrastructure is complicated.
4+
5+
Always remember, "cloud" is the same as "someone else's computer".
6+
It's not a good idea to store your credentials on someone else's computer!
7+
8+
For this reason, we use a special tool called `gh-scoped-creds` to provide a special
9+
credential which grants restricted access to only certain GitHub resources for a limited
10+
amount of time.
11+
12+
13+
## Copy the GitHub authentication Notebook
14+
15+
There's a special notebook titled `GHAUTH.ipynb` in the `shared/` directory.
16+
17+
Right-click it, select "**Copy**", then return to your home directory by clicking the 📁
18+
icon at the top of your file browser.
19+
Finally, right click in the empty space in your home directory and select "**Paste**".
20+
21+
:::{hint}
22+
Right-click this notebook and select "Add Favorite" to enable quick access in the
23+
future!
24+
:::
25+
26+
27+
## Follow the instructions in the Notebook
28+
29+
**The first time you use this Notebook, you should open the "First time setup" hint and
30+
follow the instructions within.**
31+
32+
After you've completed first-time setup, run the code cell at the end of the Notebook
33+
and carefully follow the instructions output by this cell.

0 commit comments

Comments
 (0)