Patrick Georgi has uploaded this change for review.
Documentation: Update SSH key procedure
Use ed25519 keys because recent changes to RSA keys in OpenSSH are
making a mess.
Also update references to the Gerrit UI to match the current version.
Change-Id: Ib13836feb6968307d2c8b3022cb0c859dac89bb8
Signed-off-by: Patrick Georgi <patrick@coreboot.org>
---
M Documentation/tutorial/part2.md
1 file changed, 8 insertions(+), 21 deletions(-)
git pull ssh://review.coreboot.org:29418/coreboot refs/changes/06/59806/1
diff --git a/Documentation/tutorial/part2.md b/Documentation/tutorial/part2.md
index 964057e..f24b0b6 100644
--- a/Documentation/tutorial/part2.md
+++ b/Documentation/tutorial/part2.md
@@ -12,37 +12,24 @@
username for the account will be the username of the account you used to
sign-in with. (ex. your Google username).
-## Step 2a: Set up RSA Private/Public Key
+## Step 2a: Set up SSH keys
If you prefer to use an HTTP password instead, skip to Step 2b.
-For the most up-to-date instructions on how to set up SSH keys with Gerrit go to
-<https://gerrit-documentation.storage.googleapis.com/Documentation/2.14.2/user-upload.html#configure_ssh>
-and follow the instructions there. Then, skip to Step 3.
-
-Additionally, that section of the Web site provides explanation on starting
-an ssh-agent, which may be particularly helpful for those who anticipate
-frequently uploading changes.
-
-If you instead prefer to have review.coreboot.org specific instructions,
-follow the steps below. Note that this particular section may have the
-most up-to-date instructions.
-
-If you do not have an RSA key set up on your account already (as is the case
+If you do not have an SSH key set up on your account already (as is the case
with a newly created account), follow the instructions below; otherwise,
doing so could overwrite an existing key.
-In the upper right corner, select your name and click on **Settings**.
-Select **SSH Public Keys** on the left-hand side.
-
-In a terminal, run `ssh-keygen` and confirm the default path `.ssh/id_rsa`.
+In a terminal, run `ssh-keygen -t ed25519` and confirm the default path
+`.ssh/id_ed25519`.
Make a passphrase -- remember this phrase. It will be needed whenever you use
-this RSA Public Key. **Note:** You might want to use a short password, or
+this public key. **Note:** You might want to use a short password, or
forego the password altogether as you will be using it very often.
-Open `id_rsa.pub`, copy all contents and paste into the textbox under
-"Add SSH Public Key" in the https://review.coreboot.org webpage.
+Copy the content of `.ssh/id_ed25519.pub` (notice the ".pub" suffix
+as you need to send the public key) into the textbox "New SSH Key" at
+https://review.coreboot.org/settings/#SSHKeys and save it.
## Step 2b: Set up an HTTP Password
To view, visit change 59806. To unsubscribe, or for help writing mail filters, visit settings.