keycloak/account-linking.md aktualisiert

This commit is contained in:
Tobias Wüst 2026-04-30 11:29:30 +00:00
parent d3e25ca773
commit ab64c5c0a3

View file

@ -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. 1. Open the Digitalboard service you normally use.
2. If you are signed in, **sign out** completely. 2. If you are signed in, **sign out** completely.
3. Close the browser window. 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**. 1. Open a **new private/incognito browser window**.
2. Navigate to the Digitalboard service login page. 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**). 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**. 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. 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.* *Figure 1: The "Account already exists" screen.*
3. Click **Add to existing account**. 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. 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.* *Figure 2: The email verification step.*
1. Leave this browser tab open. 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 \<Provider Name\>** (for example, *Link WKS Bern*) from `auth@digitalboard.ch`. If it does not appear within a minute, check your spam/junk folder. Look for an email with the subject **Link \<Provider Name\>** (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.* *Figure 3: The confirmation email sent by Digitalboard.*
1. Click **Link to confirm account linking**. 1. Click **Link to confirm account linking**.