GITBOOK-454: change request with no subject merged in GitBook

Author: defguard-community

.gitbook/assets/defguard-client-2fa.png

@@ -103,7 +103,8 @@
 ## Using Defguard (for end users) <a href="#help" id="help"></a>
 
 * [Overview](help/overwiew.md)
-* [Desktop Client](help/desktop-client.md)
+* [Desktop Client](help/desktop-client/README.md)
+  * [Authenticating with MFA](help/desktop-client/authenticating-with-mfa.md)
 * [Mobile Client](help/mobile-client/README.md)
   * [Adding new Instance](help/mobile-client/instance-adding.md)
   * [Connecting to Instance](help/mobile-client/instance-connect.md)

.gitbook/assets/defguard-client-instances.png

@@ -104,7 +104,7 @@ By defining a group, assigning users to that group and then choosing this group(
 By enabling this setting this location **will require Multi-Factor Authentication** on each connection to this location.
 
 {% hint style="danger" %}
-This feature is only supported in [**Defguard Desktop Client**](../../help/desktop-client.md)**.**
+This feature is only supported in [**Defguard Desktop Client**](../../help/desktop-client/)**.**
 {% endhint %}
 
 Each connection in the client:

.gitbook/assets/defguard-client-internal-mfa.png

@@ -23,7 +23,7 @@ Has no external requirements and we have wireguard-go bundled.
 ## Linux
 
 {% hint style="warning" %}
-On Linux the desktop client uses `resolvconf` to manage DNS servers. On newer distributions it should be a symbolic link to `resolvectl`, more details can be found on the [troubleshooting](broken-reference) page.
+On Linux the desktop client uses `resolvconf` to manage DNS servers. On newer distributions it should be a symbolic link to `resolvectl`, more details can be found on the [troubleshooting](../broken-reference/) page.
 {% endhint %}
 
 ### Ubuntu
@@ -84,8 +84,8 @@ Defguard Client regularly checks for updates and in order to do so operating sys
 
 This functionality can be turned off in the Client settings under Updates section so that no data is sent.
 
-<figure><img src="../.gitbook/assets/defguard-client-settings-updates.png" alt=""><figcaption><p>"Check for updates" setting</p></figcaption></figure>
+<figure><img src="../../.gitbook/assets/defguard-client-settings-updates.png" alt=""><figcaption><p>"Check for updates" setting</p></figcaption></figure>
 
 If a new version is available, a notification with a download button will be shown near the bottom of the menu.
 
-<figure><img src="../.gitbook/assets/defguard-client-new-release-available.png" alt=""><figcaption><p>New Desktop Client version available for download</p></figcaption></figure>
+<figure><img src="../../.gitbook/assets/defguard-client-new-release-available.png" alt=""><figcaption><p>New Desktop Client version available for download</p></figcaption></figure>

.gitbook/assets/defguard-client-openid.png

@@ -0,0 +1,45 @@
+# Authenticating with MFA
+
+{% hint style="danger" %}
+Connecting to location with required MFA is possible in the desktop client since **version 1.5.0.**
+
+[**https://github.com/DefGuard/client/releases**](https://github.com/DefGuard/client/releases)
+{% endhint %}
+
+## Internal MFA
+
+1. Open Defguard client, select your Instance and click **Connect** next to location with required MFA
+
+<figure><img src="../../.gitbook/assets/defguard-client-instances.png" alt=""><figcaption></figcaption></figure>
+
+2. After clicking **Authenticate with Google,** you will be redirected to a secure site where you will need to log in in order to confirm your identity. In this example, we use Google as our OpenID provider, but yours can be different (Microsoft, Okta, etc.)
+
+<figure><img src="../../.gitbook/assets/defguard-client-openid.png" alt="" width="563"><figcaption></figcaption></figure>
+
+3. After logging in, you will see this
+
+<figure><img src="../../.gitbook/assets/defguard-openid-success (1).png" alt="" width="375"><figcaption></figcaption></figure>
+
+Your connection will be established immediately after successful authentication.
+
+## External MFA
+
+1. Open Defguard client, select your Instance and click **Connect** next to location with required MFA
+
+<figure><img src="../../.gitbook/assets/defguard-client-instances.png" alt=""><figcaption></figcaption></figure>
+
+2. Choose method configured for your account, and click **Connect**.
+   * If you're using "Email" method, please enter the code sent to your email.
+   * If you're using "Authenticator App", please enter code generated within your authenticator app.
+
+{% hint style="info" %}
+If you don't know how to setup or use your **Authenticator App** please check [this article](../setting-up-2fa-mfa.md#setting-up-2famfa) for detailed information.
+{% endhint %}
+
+<figure><img src="../../.gitbook/assets/defguard-client-internal-mfa.png" alt="" width="563"><figcaption></figcaption></figure>
+
+3. After entering code, click **Verify**
+
+<figure><img src="../../.gitbook/assets/defguard-client-2fa.png" alt=""><figcaption></figcaption></figure>
+
+Your connection will be established immediately after this step.