diff --git a/keycloak/account-linking.md b/keycloak/account-linking.md index c893e88..6d2316f 100644 --- a/keycloak/account-linking.md +++ b/keycloak/account-linking.md @@ -34,7 +34,7 @@ You should follow these steps if **all** of the following apply: --- -## Step 1 ? Sign out of any existing Digitalboard session +## Step 1 Sign out of any existing Digitalboard session 1. Open the Digitalboard service you normally use. 2. If you are signed in, **sign out** completely. 3. Close the browser window. @@ -43,7 +43,7 @@ This makes sure the next login starts cleanly and the linking flow can run. --- -## Step 2 ? Open the service in a private window +## Step 2 Open the service in a private window 1. Open a **new private/incognito browser window**. 2. Navigate to the Digitalboard service login page. @@ -51,13 +51,13 @@ You should now see the login page with the available identity provider buttons, --- -## Step 3 ? Sign in through your home tenant +## Step 3 Sign in through your home tenant 1. Click the login button for your **home tenant** (the new one ? for example, **Sign in with WKS Bern**). 2. Complete the Microsoft sign-in with your **home tenant credentials**. Because the email address matches the one already on file from your guest login, Digitalboard now detects the existing account and shows the **Account already exists** screen. -![Account already exists dialog](images/account-linking/step-03.png "Digitalboard detects the existing account by email address") +![Account already exists dialog](images/account-linking/step-3.png "Digitalboard detects the existing account by email address") *Figure 1: The "Account already exists" screen.* 3. Click **Add to existing account**. @@ -66,10 +66,10 @@ Because the email address matches the one already on file from your guest login, --- -## Step 4 ? Verify your email address +## Step 4 Verify your email address To prove that the email address belongs to you, Digitalboard sends a confirmation email to the address on file. -![Email verification page](images/account-linking/step-04.png "Digitalboard prompts for email verification before linking") +![Email verification page](images/account-linking/step-4.png "Digitalboard prompts for email verification before linking") *Figure 2: The email verification step.* 1. Leave this browser tab open. @@ -77,10 +77,10 @@ To prove that the email address belongs to you, Digitalboard sends a confirmatio --- -## Step 5 ? Open the confirmation email +## Step 5 Open the confirmation email Look for an email with the subject **Link \** (for example, *Link WKS Bern*) from `auth@digitalboard.ch`. If it does not appear within a minute, check your spam/junk folder. -![Confirmation email](images/account-linking/step-05.png "The confirmation email containing the linking link") +![Confirmation email](images/account-linking/step-5.png "The confirmation email containing the linking link") *Figure 3: The confirmation email sent by Digitalboard.* 1. Click **Link to confirm account linking**.