Skip to content

Commit e4c741c

Browse files
committed
Add consent screenshots to Microsoft Entra guide
1 parent f9929a6 commit e4c741c

7 files changed

Lines changed: 50 additions & 0 deletions

File tree

110 KB
Loading

en/guides/general/microsoft-entra/index.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,10 @@ Dodona never calls the Microsoft Graph API. The permissions above exist only so
6060
That is the complete list. There is no background service, and nothing with which Dodona could query your directory.
6161
:::
6262

63+
This is what a user sees when signing in to Dodona for the first time:
64+
65+
![Screenshot of the Microsoft consent screen for the Dodona application, showing the verified publisher badge and the requested permissions "View your basic profile" and "Maintain access to data you have given it access to"](./user-consent-en.png =440x)
66+
6367
::: info Why the consent screen mentions "Maintain access to data you have given it access to"
6468

6569
Microsoft's consent screen shows this line for every application, including ones that never ask for it. It corresponds to the `offline_access` scope, and Microsoft [documents](https://learn.microsoft.com/en-us/entra/identity-platform/scopes-oidc#the-offline_access-scope) that it "currently appears on all consent pages, even for flows that don't provide a refresh token".
@@ -89,6 +93,10 @@ From the application's `Permissions` page you can see exactly which permissions
8993

9094
Granting admin consent on behalf of your organisation means your users are never prompted for consent themselves. You do this from the application's `Permissions` page under `Enterprise applications`, as described in [Grant tenant-wide admin consent to an application](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/grant-admin-consent).
9195

96+
This is what the admin consent screen looks like:
97+
98+
![Screenshot of the Microsoft admin consent screen for the Dodona application, showing the verified publisher badge and the requested permission "View users' basic profile"](./admin-consent-en.png =440x)
99+
92100
If the application isn't in your tenant yet, you can also start the consent flow directly. Open the following URL while signed in with an account that may consent on behalf of your organisation, and replace `{tenant}` with your tenant ID or one of your verified domain names:
93101

94102
```
99.5 KB
Loading
115 KB
Loading

nl/guides/general/microsoft-entra/index.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,12 @@ Dodona roept de Microsoft Graph API nooit aan. De machtigingen hierboven dienen
6060
Dat is de volledige lijst. Er is geen achtergrondproces, en niets waarmee Dodona je directory zou kunnen bevragen.
6161
:::
6262

63+
Dit is wat een gebruiker te zien krijgt bij het aanmelden op Dodona:
64+
65+
![Screenshot van het Microsoft-toestemmingsscherm voor de Dodona-applicatie, met het geverifieerde uitgeversbadge en de gevraagde machtigingen "View your basic profile" en "Maintain access to data you have given it access to"](./user-consent-nl.png =440x)
66+
67+
Let op: Microsoft vertaalt wel de omkadering van dit scherm, maar niet de namen van de machtigingen zelf. Die blijven in het Engels staan, zoals je hierboven ziet. Dat is dus geen foutje van onze kant.
68+
6369
::: info Waarom het toestemmingsscherm "Maintain access to data you have given it access to" vermeldt
6470

6571
Het toestemmingsscherm van Microsoft toont deze regel bij elke applicatie, ook bij applicaties die er nooit om vragen. Ze komt overeen met de `offline_access`-scope. Microsoft [documenteert](https://learn.microsoft.com/en-us/entra/identity-platform/scopes-oidc#the-offline_access-scope) zelf, in het Engels, dat die "currently appears on all consent pages, even for flows that don't provide a refresh token".
@@ -89,6 +95,10 @@ Op de pagina `Permissions` van de applicatie zie je precies welke machtigingen g
8995

9096
Als je toestemming geeft namens je organisatie, krijgen je gebruikers zelf nooit een toestemmingsscherm te zien. Dat doe je vanaf de pagina `Permissions` van de applicatie onder `Enterprise applications`, zoals beschreven in [Grant tenant-wide admin consent to an application](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/grant-admin-consent).
9197

98+
Zo ziet het beheerderstoestemmingsscherm eruit:
99+
100+
![Screenshot van het Microsoft-beheerderstoestemmingsscherm voor de Dodona-applicatie, met het geverifieerde uitgeversbadge en de gevraagde machtiging "View users' basic profile"](./admin-consent-nl.png =440x)
101+
92102
Staat de applicatie nog niet in je tenant, dan kan je de toestemmingsflow ook rechtstreeks starten. Open de volgende URL terwijl je aangemeld bent met een account dat namens je organisatie toestemming mag geven, en vervang `{tenant}` door je tenant-ID of door een van je geverifieerde domeinnamen:
93103

94104
```
102 KB
Loading

screenshots/shots.yaml

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2229,3 +2229,35 @@ shots:
22292229
hook: hooks/sm-announcement.mjs
22302230
crop: { selector: '#active-announcement' }
22312231
must_show: [announcement text, dismiss cross]
2232+
2233+
# ---------------- microsoft-entra (guides/general) ----------------
2234+
# Both shots below are Microsoft's own consent screens at
2235+
# login.microsoftonline.com, not Dodona pages, so the runner has no page to
2236+
# navigate to and can't capture them. They stay manual captures.
2237+
#
2238+
# To recapture: open the consent URL in the comment while signed in as a
2239+
# tenant admin, clip the `#lightbox` element at 2x, and white out the
2240+
# account email that sits above the heading. Do not click Accept.
2241+
#
2242+
# The Dutch pass needs an `Accept-Language: nl-BE` request header on that
2243+
# request; the `ui_locales` and `mkt` URL parameters are both ignored by
2244+
# this Microsoft flow.
2245+
- id: ME-1
2246+
page: guides/general/microsoft-entra
2247+
file: admin-consent
2248+
manual: true
2249+
# https://login.microsoftonline.com/{tenant}/adminconsent?client_id={client_id}
2250+
must_show:
2251+
- Dodona name, publisher and blue verified badge
2252+
- permission list showing only "View users' basic profile"
2253+
- no account email visible
2254+
2255+
- id: ME-2
2256+
page: guides/general/microsoft-entra
2257+
file: user-consent
2258+
manual: true
2259+
# https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id={client_id}&response_type=code&redirect_uri=https%3A%2F%2Fdodona.be%2Fusers%2Fauth%2Fmicrosoft%2Fcallback&response_mode=query&scope=openid%20email%20profile&prompt=consent
2260+
must_show:
2261+
- Dodona name, publisher and blue verified badge
2262+
- permission list showing "View your basic profile" and "Maintain access to data you have given it access to"
2263+
- no account email visible

0 commit comments

Comments
 (0)