From 0d3d03286bf96e6a621839d3cc2d152c1eaf47a2 Mon Sep 17 00:00:00 2001
From: Achilleas Pipinellis <axilleas@axilleas.me>
Date: Fri, 18 Aug 2017 17:06:13 +0300
Subject: [PATCH] Add more sections in GPG docs

1. Generating a GPG key
1. Signing commits
1. Associating a GPG key with Git
---
 .../profile_settings_gpg_keys_single_key.png  | Bin 10331 -> 4403 bytes
 doc/user/project/gpg_signed_commits/index.md  | 194 ++++++++++++++++--
 2 files changed, 173 insertions(+), 21 deletions(-)

diff --git a/doc/user/project/gpg_signed_commits/img/profile_settings_gpg_keys_single_key.png b/doc/user/project/gpg_signed_commits/img/profile_settings_gpg_keys_single_key.png
index f715c46adc339b1f16a6b76560f654186599250a..5c14df36d73d4e66101369a2222af6cad5c7b556 100644
GIT binary patch
literal 4403
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

literal 10331
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
YQCH>J{5awzyGt}RvbtV*?N;2s0jEswFaQ7m

diff --git a/doc/user/project/gpg_signed_commits/index.md b/doc/user/project/gpg_signed_commits/index.md
index d90bd46d003..3ea2203c895 100644
--- a/doc/user/project/gpg_signed_commits/index.md
+++ b/doc/user/project/gpg_signed_commits/index.md
@@ -7,7 +7,7 @@ All you need to do is upload the public GPG key in your profile settings.
 
 GPG verified tags are not supported yet.
 
-## Getting started
+## Getting started with GPG
 
 Here are a few guides to get you started with GPG:
 
@@ -28,7 +28,104 @@ to be met:
 1. The public key needs to be added your GitLab account
 1. One of the emails in the GPG key matches your **primary** email
 
-## Adding a GPG key
+## Generating a GPG key
+
+If you don't already have a GPG key, the following steps will help you get
+started:
+
+1. [Install GPG](https://www.gnupg.org/download/index.html) for your operating system
+1. Generate the private/public key pair with the following command:
+
+    ```sh
+    gpg --full-gen-key
+    ```
+
+    This will spawn a series of questions.
+
+1. The first question is which algorithm can be used.  Select the kind you want
+   or press <kbd>Enter</kbd> to choose the default (RSA and RSA):
+
+    ```
+    Please select what kind of key you want:
+       (1) RSA and RSA (default)
+       (2) DSA and Elgamal
+       (3) DSA (sign only)
+       (4) RSA (sign only)
+    Your selection? 1
+    ```
+
+1. The next question is key length. We recommend to choose the highest value
+   which is `4096`:
+
+    ```
+    RSA keys may be between 1024 and 4096 bits long.
+    What keysize do you want? (2048) 4096
+    Requested keysize is 4096 bits
+    ```
+1. Next, you need to specify the validity period of your key. This is something
+   subjective, and you can use the default value which is to never expire:
+
+    ```
+    Please specify how long the key should be valid.
+             0 = key does not expire
+          <n>  = key expires in n days
+          <n>w = key expires in n weeks
+          <n>m = key expires in n months
+          <n>y = key expires in n years
+    Key is valid for? (0) 0
+    Key does not expire at all
+    ```
+
+1. Confirm that the answers you gave were correct by typing `y`:
+
+    ```
+    Is this correct? (y/N) y
+    ```
+
+1. Enter you real name, the email address to be associated with this key (should
+   match the primary email address you use in GitLab) and an optional comment
+   (press <kbd>Enter</kbd> to skip):
+
+    ```
+    GnuPG needs to construct a user ID to identify your key.
+
+    Real name: Mr. Robot
+    Email address: mr@robot.sh
+    Comment:
+    You selected this USER-ID:
+        "Mr. Robot <mr@robot.sh>"
+
+    Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? O
+    ```
+
+1. Pick a strong password when asked and type it twice to confirm.
+1. Use the following command to list the private GPG key you just created:
+
+    ```
+    gpg --list-secret-keys mr@robot.sh
+    ```
+
+    Replace `mr@robot.sh` with the email address you entered above.
+
+1. Copy the GPG key ID that starts with `sec`. In the following example, that's
+   `0x30F2B65B9246B6CA`:
+
+    ```
+    sec   rsa4096/0x30F2B65B9246B6CA 2017-08-18 [SC]
+          D5E4F29F3275DC0CDA8FFC8730F2B65B9246B6CA
+    uid                   [ultimate] Mr. Robot <mr@robot.sh>
+    ssb   rsa4096/0xB7ABC0813E4028C0 2017-08-18 [E]
+    ```
+
+1. Export the public key of that ID (replace your key ID from the previous step):
+
+    ```
+    gpg --armor --export 0x30F2B65B9246B6CA
+    ```
+
+1. Finally, copy the public key and [add it in your profile settings](#adding-a-gpg-key-to-your-account)
+
+## Adding a GPG key to your account
 
 >**Note:**
 Once you add a key, you cannot edit it, only remove it. In case the paste
@@ -50,18 +147,74 @@ You can add a GPG key in your profile's settings:
 
     ![GPG key single page](img/profile_settings_gpg_keys_single_key.png)
 
-## Removing a GPG key
+## Associating your GPG key with Git
 
-Removing a key **does not unverify** already signed commits. Commits that were
-verified by using this key will stay verified. Only unpushed commits will stay
-unverified once you remove this key. To unverify already signed commits, you need
-to [revoke the associated GPG key](#revoking-a-gpg-key) from your account.
+After you have [created your GPG key](#generating-a-gpg-key) and [added it to
+your account](#adding-a-gpg-key-to-your-account), it's time to tell Git which
+key to use.
 
-To remove a GPG key from your account:
+1. Use the following command to list the private GPG key you just created:
 
-1. On the upper right corner, click on your avatar and go to your **Settings**.
-1. Navigate to the **GPG keys** tab.
-1. Click on the trash icon besides the GPG key you want to delete.
+    ```
+    gpg --list-secret-keys mr@robot.sh
+    ```
+
+    Replace `mr@robot.sh` with the email address you entered above.
+
+1. Copy the GPG key ID that starts with `sec`. In the following example, that's
+   `0x30F2B65B9246B6CA`:
+
+    ```
+    sec   rsa4096/0x30F2B65B9246B6CA 2017-08-18 [SC]
+          D5E4F29F3275DC0CDA8FFC8730F2B65B9246B6CA
+    uid                   [ultimate] Mr. Robot <mr@robot.sh>
+    ssb   rsa4096/0xB7ABC0813E4028C0 2017-08-18 [E]
+    ```
+
+1. Tell Git to use that key to sign the commits:
+
+    ```
+    git config --global user.signingkey 0x30F2B65B9246B6CA
+    ```
+
+    Replace `0x30F2B65B9246B6CA` with your GPG key ID.
+
+## Signing commits
+
+After you have [created your GPG key](#generating-a-gpg-key) and [added it to
+your account](#adding-a-gpg-key-to-your-account), you can start signing your
+commits:
+
+1. Commit like you used to, the only difference is the addition of the `-S` flag:
+
+    ```
+    git commit -S -m "My commit msg"
+    ```
+
+1. Enter the passphrase of your GPG key when asked.
+1. Push to GitLab and check that your commits [are verified](#verifying-commits).
+
+If you don't want to type the `-S` flag every time you commit, you can tell Git
+to sign your commits automatically:
+
+```
+git config --global commit.gpgsign true
+```
+
+## Verifying commits
+
+1. Within a project or [merge request](../merge_requests/index.md), navigate to
+   the **Commits** tab. Signed commits will show a badge containing either
+   "Verified" or "Unverified", depending on the verification status of the GPG
+   signature.
+
+    ![Signed and unsigned commits](img/project_signed_and_unsigned_commits.png)
+
+1. By clicking on the GPG badge, details of the signature are displayed.
+
+    ![Signed commit with verified signature](img/project_signed_commit_verified_signature.png)
+
+    ![Signed commit with verified signature](img/project_signed_commit_unverified_signature.png)
 
 ## Revoking a GPG key
 
@@ -76,18 +229,17 @@ To revoke a GPG key:
 1. Navigate to the **GPG keys** tab.
 1. Click on **Revoke** besides the GPG key you want to delete.
 
-## Verifying commits
+## Removing a GPG key
 
-1. Within a project navigate to the **Commits** tab. Signed commits will show a
-   badge containing either "Verified" or "Unverified", depending on the
-   verification status of the GPG signature.
+Removing a key **does not unverify** already signed commits. Commits that were
+verified by using this key will stay verified. Only unpushed commits will stay
+unverified once you remove this key. To unverify already signed commits, you need
+to [revoke the associated GPG key](#revoking-a-gpg-key) from your account.
 
-    ![Signed and unsigned commits](img/project_signed_and_unsigned_commits.png)
+To remove a GPG key from your account:
 
-1. By clicking on the GPG badge, details of the signature are displayed.
-
-    ![Signed commit with verified signature](img/project_signed_commit_verified_signature.png)
-
-    ![Signed commit with verified signature](img/project_signed_commit_unverified_signature.png)
+1. On the upper right corner, click on your avatar and go to your **Settings**.
+1. Navigate to the **GPG keys** tab.
+1. Click on the trash icon besides the GPG key you want to delete.
 
 [ce-9546]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9546