Outlook Calendar: Authorize with OAuth2 and PKCE
See more Outlook Calendar Examples
Authorize an interactive desktop application using the Microsoft identity platform v2.0 authorization-code flow with PKCE (S256). This replaces the older public-client example that disabled PKCE, embedded a client secret, requested unrelated file/profile permissions, and printed tokens.
- Register an application in Microsoft Entra. Select personal Microsoft accounts, organizational accounts, or both according to the intended users. Copy the Application (client) ID, not the Object ID.
- Under Authentication, add a Mobile and desktop applications redirect URI of
http://localhost:3017/. This is a local callback handled by Chilkat; it is not a hosted web-backend redirect. - Add the delegated Microsoft Graph
Calendars.ReadWritepermission for this example collection. A basic read-only application can instead useCalendars.ReadBasic; useCalendars.Readwhen fuller event information is required. Tenant consent policies can require an administrator even for delegated access. - Use
commononly with the appropriate app account-type configuration,consumersfor personal accounts only,organizationsfor organizational accounts, or your tenant ID for a single organization. Change both endpoints together.
offline_access requests a refresh token. Save the returned tokens privately and use the access token only for Graph. The saved obtained_at and expires_in describe its lifetime; refresh tokens can also expire or be revoked, so handle a need for interactive sign-in. This example saves a demonstration JSON cache; production applications should use protected credential storage and atomic replacement per account. No token is printed.
This system-browser/loopback example is intended for a machine with an interactive user. Web applications, mobile applications, and headless services need an authentication flow and redirect handling appropriate to their environment. Do not add a client secret to a public desktop application.
Chilkat Unicode C++ Downloads
#include <CkOAuth2W.h>
#include <CkJsonObjectW.h>
#include <CkDateTimeW.h>
#include <CkFileAccessW.h>
void ChilkatSample(void)
{
bool success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success = false;
CkOAuth2W oauth;
// Register a Mobile and desktop applications redirect URI: http://localhost:3017/
// Use an account type that matches your app registration (common, consumers, or tenant ID).
oauth.put_AuthorizationEndpoint(L"https://login.microsoftonline.com/common/oauth2/v2.0/authorize");
oauth.put_TokenEndpoint(L"https://login.microsoftonline.com/common/oauth2/v2.0/token");
oauth.put_ClientId(L"YOUR_APPLICATION_CLIENT_ID");
// Public desktop applications cannot keep a client secret. Use PKCE instead.
oauth.put_LocalHost(L"localhost");
oauth.put_ListenPort(3017);
oauth.put_CodeChallenge(true);
oauth.put_CodeChallengeMethod(L"S256");
// ReadWrite covers this collection's create/delete operations. Use ReadBasic for basic lists only.
oauth.put_Scope(L"offline_access https://graph.microsoft.com/Calendars.ReadWrite");
success = oauth.AddAuthQueryParam(L"prompt",L"select_account");
if (success != true) {
wprintf(L"Could not configure the authorization request.\n");
return;
}
const wchar_t *authUrl = oauth.startAuth();
if (oauth.get_LastMethodSuccess() != true) {
wprintf(L"Could not start the local authorization listener.\n");
return;
}
success = oauth.LaunchBrowser(authUrl);
if (success != true) {
oauth.Cancel();
wprintf(L"Could not open the system browser.\n");
return;
}
int waited = 0;
while (((oauth.get_AuthFlowState() < 3) && (waited < 180000))) {
oauth.SleepMs(200);
waited = waited + 200;
}
if (oauth.get_AuthFlowState() < 3) {
oauth.Cancel();
wprintf(L"Authorization timed out.\n");
return;
}
if (oauth.get_AuthFlowState() != 3) {
wprintf(L"Authorization did not complete. Flow state: %d\n",oauth.get_AuthFlowState());
return;
}
CkJsonObjectW token;
token.put_Strict(true);
success = token.Load(oauth.accessTokenResponse());
if (success != true) {
wprintf(L"Could not parse the token response; existing cache unchanged.\n");
return;
}
if ((token.JsonTypeOf(L"access_token") != 1) || (token.StringOfEquals(L"access_token",L"",true) == true)) {
wprintf(L"Expected a nonempty access_token in the JSON.\n");
return;
}
if ((token.JsonTypeOf(L"refresh_token") != 1) || (token.StringOfEquals(L"refresh_token",L"",true) == true)) {
wprintf(L"Expected a nonempty refresh_token in the JSON.\n");
return;
}
if ((token.JsonTypeOf(L"expires_in") != 2) || (token.IntOf(L"expires_in") <= 0)) {
wprintf(L"Expected a positive access-token lifetime.\n");
return;
}
CkDateTimeW obtained;
success = obtained.SetFromCurrentSystemTime();
if (success != true) {
wprintf(L"Could not record the token acquisition time.\n");
return;
}
token.UpdateString(L"obtained_at",obtained.getAsTimestamp(false));
// This file contains credentials. Choose an access-controlled directory for the signed-in account.
CkFileAccessW fac;
success = fac.DirEnsureExists(L"qa_data/tokens");
if (success != true) {
wprintf(L"Could not create the private token-cache directory.\n");
return;
}
success = token.WriteFile(L"qa_data/tokens/outlookCalendar.json");
if (success != true) {
wprintf(L"Could not save the token cache.\n");
return;
}
// Never print access_token, refresh_token, or the complete token response.
wprintf(L"Calendar authorization completed; token cache saved.\n");
}