Outlook.com: Refresh Mail OAuth2 Tokens
See more Office365 Examples
Exchange a saved delegated refresh token for a new access token without displaying a browser. Use the same app registration and authority as the original authorization. Save any rotated refresh token and the new lifetime information. On a rejected or malformed response, this example preserves the previous cache; an expired/revoked grant or interaction-required response needs interactive authorization again.
Read and update qa_data/tokens/hotmail.json in a private working directory. Serialize access to the cache; production storage should support atomic replacement and protect credentials. A successful refresh does not enable a disabled mail protocol. Client-credentials tokens have no refresh token; request a new application token instead.
Authorize first: desktop PKCE example. This is delegated background access after consent, not permanently unattended application authentication.
Microsoft reference documentation
Chilkat C# Downloads
bool success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
Chilkat.JsonObject token = new Chilkat.JsonObject();
success = token.LoadFile("qa_data/tokens/hotmail.json");
if (success != true) {
Debug.WriteLine("Could not read qa_data/tokens/hotmail.json from the private working directory.");
return;
}
if ((token.JsonTypeOf("refresh_token") != 1) || (token.StringOfEquals("refresh_token","",true) == true)) {
Debug.WriteLine("Authorize the account for offline access first.");
return;
}
Chilkat.OAuth2 oauth = new Chilkat.OAuth2();
oauth.TokenEndpoint = "https://login.microsoftonline.com/consumers/oauth2/v2.0/token";
oauth.ClientId = "CLIENT_ID";
// No client secret for the public desktop registration used by the PKCE example.
oauth.RefreshToken = token.StringOf("refresh_token");
success = oauth.RefreshAccessToken();
if (success != true) {
Debug.WriteLine("Refresh failed. Check the OAuth client and grant. A revoked or expired grant requires fresh consent.");
return;
}
Chilkat.JsonObject fresh = new Chilkat.JsonObject();
success = fresh.Load(oauth.AccessTokenResponse);
if (success != true) {
Debug.WriteLine("Could not parse the refresh response.");
return;
}
if ((fresh.JsonTypeOf("access_token") != 1) || (fresh.StringOfEquals("access_token","",true) == true)) {
Debug.WriteLine("The refresh response did not contain an access token.");
return;
}
if ((fresh.JsonTypeOf("refresh_token") != 1) || (fresh.StringOfEquals("refresh_token","",true) == true)) {
fresh.UpdateString("refresh_token",token.StringOf("refresh_token"));
}
if ((fresh.HasMember("scope") != true) && (token.JsonTypeOf("scope") == 1)) {
fresh.UpdateString("scope",token.StringOf("scope"));
}
// Persist the rotated refresh token. Retain the previous one only if the response omits it.
// Use the new expires_in, not the old response's expiration information.
Chilkat.CkDateTime obtained = new Chilkat.CkDateTime();
obtained.SetFromCurrentSystemTime();
fresh.UpdateString("obtained_at",obtained.GetAsTimestamp(false));
success = fresh.WriteFile("qa_data/tokens/hotmail.json");
if (success != true) {
Debug.WriteLine("Could not save the refreshed credentials.");
return;
}
Debug.WriteLine("Refreshed the access token.");