Skip to content
TDACorpIDENTITYSign in

Consent

When identity asks you to allow an application, what the Allow access screen says, how long a consent lasts, and what revoking it does.

On this page

Consent is your decision to let an application see part of your account. Identity records it, so you are asked once, and you can take it back at any time.

When you are asked#

You are asked when an application is third party, meaning it is not one that TDACorp ships itself. A first-party application is never shown the consent screen, because a screen asking you to allow TDACorp's own software would be theatre. It also does not appear on your Connected apps page.

For a third-party application, identity checks, on every sign-in, whether you have already allowed everything it is asking for.

SituationWhat happens
You have never allowed this applicationThe consent screen appears.
You allowed it, and it asks for the same scopes or fewerNo screen. The sign-in continues.
You allowed it, and it now asks for a scope you have not grantedThe screen appears again.
The application asks to show the screen anywayThe screen appears, even though you have allowed it.
The application asks for no screen, and consent is missingThe sign-in fails with consent_required and nothing is shown.

An unrevoked consent that covers the request is enough. It is never time limited by identity: it lasts until you revoke it.

The Allow access screen#

The screen is titled Allow access and its heading names the application: Allow ExampleApp to access your account? It says It will be able to see what you allow below.

  • Verified application appears when TDACorp has verified the application. Otherwise the screen says This application is not verified by TDACorp. Treat that line as a warning. An application that identifies itself only by a web address (a client ID metadata document, flag oauth_cimd, default OFF) also shows It is identified only by its web address: followed by that address.
  • Under This application is asking for each scope is listed as a short title and a plain description. See Scopes and consent for the wording of each.
  • Required marks what cannot be unticked. Only openid is required, because without it there is no sign-in. The other items start ticked and you can untick any you do not want to share.
  • Links to the application's Privacy policy and Terms of service can appear.
  • Allow continues, and Deny refuses.

What you leave ticked is what the application gets. The sign-in is completed for the scopes it requested that you also granted, plus openid. An application that asked for your email address and was refused it receives a sign-in without an email address, and has to cope.

If you select Deny, the application is sent back with the standard error access_denied.

What identity stores#

When you select Allow, identity stores which application and which scopes you granted, and when. That is a consent. It is the basis for both skipping the screen next time and for the list on Connected apps.

Verified against commit 936c0b4