Outlook Calendar: Access a Microsoft 365 Calendar with a Certificate
See more Outlook Calendar Examples
Obtain an app-only Graph token using a signed certificate assertion, then read an explicitly named Microsoft 365 mailbox's default calendar. Upload the public certificate to the Entra app registration and keep its RSA private key private. Grant the appropriate Graph application permission and administrator consent: Calendars.ReadBasic for this read, or a stronger permission only for the operations required. Scope mailbox access using your organization's supported Exchange application-access controls/RBAC; avoid unintended tenant-wide access.
Private outlook-calendar-app.json contains tenant_id (the directory ID), client_id (Application ID), mailbox (object ID or UPN), pfx_path, and pfx_password. Use an organization tenant, not common/consumers. This is not available for personal Outlook.com mailboxes. Certificate authentication is not a requirement to run a public web server, but the private key must remain in a trusted application environment.
The short-lived assertion uses PS256 and an x5t#S256 thumbprint of the certificate's DER bytes. It is a credential submitted only to the token endpoint, not the Graph bearer token. Client credentials returns no refresh token: obtain another access token with a fresh assertion when needed. The example never prints tokens or assertions.
HTTP methods can return false for an HTTP error as well as a connection failure. The code distinguishes those cases and checks the expected status before reading JSON. For 401, refresh the access token or authorize again; for 403, check permissions, mailbox access, and tenant policy. For 429, honor Retry-After before a bounded retry. Do not automatically repeat a write after an uncertain outcome. Keep detailed errors and calendar data private.
Chilkat PowerBuilder Downloads
integer li_rc
long li_Success
oleobject loo_Config
oleobject loo_Http
oleobject loo_TokenEndpoint
string ls_TokenUrl
oleobject loo_Cert
oleobject loo_Key
oleobject loo_Der
oleobject loo_Crypt
string ls_Thumbprint
oleobject loo_Header
oleobject loo_Claims
string ls_AssertionId
oleobject loo_Clock
oleobject loo_Jwt
string ls_Assertion
oleobject loo_Req
oleobject loo_Resp
oleobject loo_Result
oleobject loo_Endpoint
li_Success = 0
// Assumes Chilkat is unlocked. See Global Unlock Sample.
li_Success = 0
loo_Config = create oleobject
li_rc = loo_Config.ConnectToNewObject("Chilkat.JsonObject")
if li_rc < 0 then
destroy loo_Config
MessageBox("Error","Connecting to COM object failed")
return
end if
loo_Config.Strict = 1
li_Success = loo_Config.LoadFile("outlook-calendar-app.json")
if li_Success <> 1 then
Write-Debug "Could not load private app configuration."
destroy loo_Config
return
end if
if (loo_Config.JsonTypeOf("tenant_id") <> 1) OR (loo_Config.StringOfEquals("tenant_id","",1) = 1) then
Write-Debug "Expected a nonempty tenant_id in the JSON."
destroy loo_Config
return
end if
if (loo_Config.JsonTypeOf("client_id") <> 1) OR (loo_Config.StringOfEquals("client_id","",1) = 1) then
Write-Debug "Expected a nonempty client_id in the JSON."
destroy loo_Config
return
end if
if (loo_Config.JsonTypeOf("mailbox") <> 1) OR (loo_Config.StringOfEquals("mailbox","",1) = 1) then
Write-Debug "Expected a nonempty mailbox in the JSON."
destroy loo_Config
return
end if
if (loo_Config.JsonTypeOf("pfx_path") <> 1) OR (loo_Config.StringOfEquals("pfx_path","",1) = 1) then
Write-Debug "Expected a nonempty pfx_path in the JSON."
destroy loo_Config
return
end if
// pfx_password may be empty for an unencrypted test PFX; protect the private key in production.
loo_Http = create oleobject
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")
loo_Http.RequireSslCertVerify = 1
loo_Http.FollowRedirects = 0
loo_Http.ConnectTimeout = 20
loo_Http.ReadTimeout = 30
loo_TokenEndpoint = create oleobject
li_rc = loo_TokenEndpoint.ConnectToNewObject("Chilkat.StringBuilder")
loo_TokenEndpoint.Append("https://login.microsoftonline.com/")
loo_TokenEndpoint.Append(loo_Http.UrlEncode(loo_Config.StringOf("tenant_id")))
loo_TokenEndpoint.Append("/oauth2/v2.0/token")
ls_TokenUrl = loo_TokenEndpoint.GetAsString()
loo_Cert = create oleobject
li_rc = loo_Cert.ConnectToNewObject("Chilkat.Cert")
li_Success = loo_Cert.LoadPfxFile(loo_Config.StringOf("pfx_path"),loo_Config.StringOf("pfx_password"))
if li_Success <> 1 then
Write-Debug "Could not load the application certificate."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
return
end if
loo_Key = create oleobject
li_rc = loo_Key.ConnectToNewObject("Chilkat.PrivateKey")
li_Success = loo_Cert.GetPrivateKey(loo_Key)
if li_Success <> 1 then
Write-Debug "The certificate needs an accessible RSA private key."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
return
end if
loo_Der = create oleobject
li_rc = loo_Der.ConnectToNewObject("Chilkat.BinData")
li_Success = loo_Cert.ExportCertDerBd(loo_Der)
if li_Success <> 1 then
Write-Debug "Could not read the certificate DER bytes."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
return
end if
loo_Crypt = create oleobject
li_rc = loo_Crypt.ConnectToNewObject("Chilkat.Crypt2")
loo_Crypt.HashAlgorithm = "sha256"
loo_Crypt.EncodingMode = "base64url"
ls_Thumbprint = loo_Crypt.HashBdENC(loo_Der)
if loo_Crypt.LastMethodSuccess <> 1 then
Write-Debug "Could not hash the certificate."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
return
end if
loo_Header = create oleobject
li_rc = loo_Header.ConnectToNewObject("Chilkat.JsonObject")
loo_Header.UpdateString("alg","PS256")
loo_Header.UpdateString("typ","JWT")
loo_Header.UpdateString("x5t#S256",ls_Thumbprint)
loo_Claims = create oleobject
li_rc = loo_Claims.ConnectToNewObject("Chilkat.JsonObject")
loo_Claims.UpdateString("aud",ls_TokenUrl)
loo_Claims.UpdateString("iss",loo_Config.StringOf("client_id"))
loo_Claims.UpdateString("sub",loo_Config.StringOf("client_id"))
ls_AssertionId = loo_Crypt.GenerateUuid()
if loo_Crypt.LastMethodSuccess <> 1 then
Write-Debug "Could not create the assertion ID."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
return
end if
loo_Claims.UpdateString("jti",ls_AssertionId)
loo_Clock = create oleobject
li_rc = loo_Clock.ConnectToNewObject("Chilkat.CkDateTime")
li_Success = loo_Clock.SetFromCurrentSystemTime()
if li_Success <> 1 then
Write-Debug "Could not read the clock."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
return
end if
// Numeric dates are JSON numbers built from decimal strings, without converting timestamps to a platform-sized integer.
loo_Claims.UpdateNumber("iat",loo_Clock.GetAsUnixTimeStr(0))
loo_Claims.UpdateNumber("nbf",loo_Clock.GetAsUnixTimeStr(0))
li_Success = loo_Clock.AddSeconds(300)
if li_Success <> 1 then
Write-Debug "Could not set assertion expiry."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
return
end if
loo_Claims.UpdateNumber("exp",loo_Clock.GetAsUnixTimeStr(0))
loo_Jwt = create oleobject
li_rc = loo_Jwt.ConnectToNewObject("Chilkat.Jwt")
ls_Assertion = loo_Jwt.CreateJwtPk(loo_Header.Emit(),loo_Claims.Emit(),loo_Key)
if loo_Jwt.LastMethodSuccess <> 1 then
Write-Debug "Could not sign the client assertion."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
return
end if
loo_Req = create oleobject
li_rc = loo_Req.ConnectToNewObject("Chilkat.HttpRequest")
loo_Req.HttpVerb = "POST"
loo_Req.ContentType = "application/x-www-form-urlencoded"
loo_Req.AddParam("client_id",loo_Config.StringOf("client_id"))
loo_Req.AddParam("grant_type","client_credentials")
loo_Req.AddParam("scope","https://graph.microsoft.com/.default")
loo_Req.AddParam("client_assertion_type","urn:ietf:params:oauth:client-assertion-type:jwt-bearer")
loo_Req.AddParam("client_assertion",ls_Assertion)
loo_Resp = create oleobject
li_rc = loo_Resp.ConnectToNewObject("Chilkat.HttpResponse")
loo_Result = create oleobject
li_rc = loo_Result.ConnectToNewObject("Chilkat.JsonObject")
loo_Result.Strict = 1
li_Success = loo_Http.HttpReq(ls_TokenUrl,loo_Req,loo_Resp)
// A false result can still include an HTTP error response.
if (li_Success <> 1) AND (loo_Resp.StatusCode = 0) then
Write-Debug "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
return
end if
if loo_Resp.StatusCode <> 200 then
Write-Debug "Unexpected HTTP status: " + string(loo_Resp.StatusCode)
Write-Debug "Request ID: " + loo_Resp.GetHeaderField("request-id")
if loo_Resp.StatusCode = 429 then
Write-Debug "Retry-After: " + loo_Resp.GetHeaderField("Retry-After")
end if
if loo_Resp.StatusCode = 401 then
Write-Debug "Refresh the Graph access token or authorize again."
end if
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
return
end if
li_Success = loo_Result.Load(loo_Resp.BodyStr)
if li_Success <> 1 then
Write-Debug "Expected a well-formed JSON response."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
return
end if
if (loo_Result.JsonTypeOf("access_token") <> 1) OR (loo_Result.StringOfEquals("access_token","",1) = 1) then
Write-Debug "Expected a nonempty access_token in the JSON."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
return
end if
loo_Http.AuthToken = loo_Result.StringOf("access_token")
// App-only tokens have no /me. Address the approved mailbox explicitly.
loo_Endpoint = create oleobject
li_rc = loo_Endpoint.ConnectToNewObject("Chilkat.StringBuilder")
loo_Endpoint.Append("https://graph.microsoft.com/v1.0/users/")
loo_Endpoint.Append(loo_Http.UrlEncode(loo_Config.StringOf("mailbox")))
loo_Endpoint.Append("/calendar?$select=id,name,canEdit")
li_Success = loo_Http.HttpNoBody("GET",loo_Endpoint.GetAsString(),loo_Resp)
// A false result can still include an HTTP error response.
if (li_Success <> 1) AND (loo_Resp.StatusCode = 0) then
Write-Debug "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
destroy loo_Endpoint
return
end if
if loo_Resp.StatusCode <> 200 then
Write-Debug "Unexpected HTTP status: " + string(loo_Resp.StatusCode)
Write-Debug "Request ID: " + loo_Resp.GetHeaderField("request-id")
if loo_Resp.StatusCode = 429 then
Write-Debug "Retry-After: " + loo_Resp.GetHeaderField("Retry-After")
end if
if loo_Resp.StatusCode = 401 then
Write-Debug "Refresh the Graph access token or authorize again."
end if
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
destroy loo_Endpoint
return
end if
li_Success = loo_Result.Load(loo_Resp.BodyStr)
if li_Success <> 1 then
Write-Debug "Expected a well-formed JSON response."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
destroy loo_Endpoint
return
end if
if (loo_Result.JsonTypeOf("id") <> 1) OR (loo_Result.StringOfEquals("id","",1) = 1) then
Write-Debug "Expected a nonempty id in the JSON."
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
destroy loo_Endpoint
return
end if
Write-Debug "Calendar ID: " + loo_Result.StringOf("id")
Write-Debug "Calendar name: " + loo_Result.StringOf("name")
destroy loo_Config
destroy loo_Http
destroy loo_TokenEndpoint
destroy loo_Cert
destroy loo_Key
destroy loo_Der
destroy loo_Crypt
destroy loo_Header
destroy loo_Claims
destroy loo_Clock
destroy loo_Jwt
destroy loo_Req
destroy loo_Resp
destroy loo_Result
destroy loo_Endpoint