A common case is using AzureAD via OpenIdConnect for login - and then wanting to consume GraphAPI services.
In order to consume GraphAPI, you will need a shortlived Access_token.
To get the fresh Access_token, you will need a Refresh_token.
To get the Refresh_token, you must do a call to the token-endpoint with the short-lived code you get when you login.
Turnkey will do all this for you and update the SysUserClaim object with a ClaimType access_token and refresh_token.
These will be fetched when you login.
The access_token is shortlived - you should renew it prior to new operations.
Turnkey can renew it if you add and later call a Method on SysUser:
OpenIdConnectAccessTokenRefresh():String (TV: Eco.ExternalLateBound)
This will return an error or ok. If it is ok, the SysUserClaim object with a ClaimType access_token and refresh_token has been updated.
For this to work, you need to supply settings for OpenIdConnect.
- (You must give the OpenID_TokenEndPoint, and OpenIDConnectScope must contain offline_access for AzureAD to issue refresh_token)
- You should also set a value on SharedSecret in TurnkeySettings - this will be used to encrypt the temporary tokens stored in the db