Skip to content

Commit f9929a6

Browse files
committed
Add table header and offline_access note to Microsoft Entra guide
1 parent eca2ffc commit f9929a6

2 files changed

Lines changed: 16 additions & 2 deletions

File tree

  • en/guides/general/microsoft-entra
  • nl/guides/general/microsoft-entra

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

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ If your institution explicitly allowed the previous application, that approval d
2929

3030
## The application registration
3131

32-
| | |
32+
| Property | Value |
3333
| --- | --- |
3434
| Display name | `Dodona` |
3535
| Application (client) ID | `060c642b-473b-4423-a9f6-dfc67066deb6` |
@@ -60,6 +60,13 @@ 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+
::: info Why the consent screen mentions "Maintain access to data you have given it access to"
64+
65+
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".
66+
67+
Dodona does not request `offline_access`. Its sign-in requests ask for `openid`, `email` and `profile` only, which is exactly what you see on the application's `API permissions` page. Microsoft only issues a refresh token to an application that explicitly requests that scope, so Dodona never receives one.
68+
:::
69+
6370
Concretely, this means that:
6471

6572
- Dodona never receives, stores or asks for the user's Microsoft password. Authentication happens entirely on Microsoft's own sign-in pages.

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

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Als je instelling de vorige applicatie expliciet toeliet, geldt die goedkeuring
2929

3030
## De app-registratie
3131

32-
| | |
32+
| Eigenschap | Waarde |
3333
| --- | --- |
3434
| Weergavenaam | `Dodona` |
3535
| Toepassings-ID (client) | `060c642b-473b-4423-a9f6-dfc67066deb6` |
@@ -60,6 +60,13 @@ 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+
::: info Waarom het toestemmingsscherm "Maintain access to data you have given it access to" vermeldt
64+
65+
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".
66+
67+
Dodona vraagt geen `offline_access`. De aanmeldaanvragen van Dodona vragen enkel `openid`, `email` en `profile`, precies wat je ziet op de `API permissions`-pagina van de applicatie. Microsoft geeft enkel een refresh token aan een applicatie die die scope expliciet aanvraagt, waardoor Dodona er nooit een ontvangt.
68+
:::
69+
6370
Concreet betekent dat:
6471

6572
- Dodona ontvangt, bewaart of vraagt nooit het Microsoft-wachtwoord van de gebruiker. Het aanmelden gebeurt volledig op de aanmeldpagina's van Microsoft zelf.

0 commit comments

Comments
 (0)