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 Go Downloads
success := false
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success = false
oauth := chilkat.NewOAuth2()
// 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.SetAuthorizationEndpoint("https://login.microsoftonline.com/common/oauth2/v2.0/authorize")
oauth.SetTokenEndpoint("https://login.microsoftonline.com/common/oauth2/v2.0/token")
oauth.SetClientId("YOUR_APPLICATION_CLIENT_ID")
// Public desktop applications cannot keep a client secret. Use PKCE instead.
oauth.SetLocalHost("localhost")
oauth.SetListenPort(3017)
oauth.SetCodeChallenge(true)
oauth.SetCodeChallengeMethod("S256")
// ReadWrite covers this collection's create/delete operations. Use ReadBasic for basic lists only.
oauth.SetScope("offline_access https://graph.microsoft.com/Calendars.ReadWrite")
success = oauth.AddAuthQueryParam("prompt","select_account")
if success != true {
fmt.Println("Could not configure the authorization request.")
oauth.DisposeOAuth2()
return
}
authUrl := oauth.StartAuth()
if oauth.LastMethodSuccess() != true {
fmt.Println("Could not start the local authorization listener.")
oauth.DisposeOAuth2()
return
}
success = oauth.LaunchBrowser(*authUrl)
if success != true {
oauth.Cancel()
fmt.Println("Could not open the system browser.")
oauth.DisposeOAuth2()
return
}
waited := 0
for ((oauth.AuthFlowState() < 3) && (waited < 180000)) {
oauth.SleepMs(200)
waited = waited + 200
}
if oauth.AuthFlowState() < 3 {
oauth.Cancel()
fmt.Println("Authorization timed out.")
oauth.DisposeOAuth2()
return
}
if oauth.AuthFlowState() != 3 {
fmt.Println("Authorization did not complete. Flow state: ", oauth.AuthFlowState())
oauth.DisposeOAuth2()
return
}
token := chilkat.NewJsonObject()
token.SetStrict(true)
success = token.Load(oauth.AccessTokenResponse())
if success != true {
fmt.Println("Could not parse the token response; existing cache unchanged.")
oauth.DisposeOAuth2()
token.DisposeJsonObject()
return
}
if (token.JsonTypeOf("access_token") != 1) || (token.StringOfEquals("access_token","",true) == true) {
fmt.Println("Expected a nonempty access_token in the JSON.")
oauth.DisposeOAuth2()
token.DisposeJsonObject()
return
}
if (token.JsonTypeOf("refresh_token") != 1) || (token.StringOfEquals("refresh_token","",true) == true) {
fmt.Println("Expected a nonempty refresh_token in the JSON.")
oauth.DisposeOAuth2()
token.DisposeJsonObject()
return
}
if (token.JsonTypeOf("expires_in") != 2) || (token.IntOf("expires_in") <= 0) {
fmt.Println("Expected a positive access-token lifetime.")
oauth.DisposeOAuth2()
token.DisposeJsonObject()
return
}
obtained := chilkat.NewCkDateTime()
success = obtained.SetFromCurrentSystemTime()
if success != true {
fmt.Println("Could not record the token acquisition time.")
oauth.DisposeOAuth2()
token.DisposeJsonObject()
obtained.DisposeCkDateTime()
return
}
token.UpdateString("obtained_at",*obtained.GetAsTimestamp(false))
// This file contains credentials. Choose an access-controlled directory for the signed-in account.
fac := chilkat.NewFileAccess()
success = fac.DirEnsureExists("qa_data/tokens")
if success != true {
fmt.Println("Could not create the private token-cache directory.")
oauth.DisposeOAuth2()
token.DisposeJsonObject()
obtained.DisposeCkDateTime()
fac.DisposeFileAccess()
return
}
success = token.WriteFile("qa_data/tokens/outlookCalendar.json")
if success != true {
fmt.Println("Could not save the token cache.")
oauth.DisposeOAuth2()
token.DisposeJsonObject()
obtained.DisposeCkDateTime()
fac.DisposeFileAccess()
return
}
// Never print access_token, refresh_token, or the complete token response.
fmt.Println("Calendar authorization completed; token cache saved.")
oauth.DisposeOAuth2()
token.DisposeJsonObject()
obtained.DisposeCkDateTime()
fac.DisposeFileAccess()