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 Visual Basic 6.0 Downloads
Dim success As Long
success = 0
' Assumes Chilkat is unlocked. See Global Unlock Sample.
success = 0
Dim config As New ChilkatJsonObject
config.Strict = 1
success = config.LoadFile("outlook-calendar-app.json")
If (success <> 1) Then
Debug.Print "Could not load private app configuration."
Exit Sub
End If
If ((config.JsonTypeOf("tenant_id") <> 1) Or (config.StringOfEquals("tenant_id","",1) = 1)) Then
Debug.Print "Expected a nonempty tenant_id in the JSON."
Exit Sub
End If
If ((config.JsonTypeOf("client_id") <> 1) Or (config.StringOfEquals("client_id","",1) = 1)) Then
Debug.Print "Expected a nonempty client_id in the JSON."
Exit Sub
End If
If ((config.JsonTypeOf("mailbox") <> 1) Or (config.StringOfEquals("mailbox","",1) = 1)) Then
Debug.Print "Expected a nonempty mailbox in the JSON."
Exit Sub
End If
If ((config.JsonTypeOf("pfx_path") <> 1) Or (config.StringOfEquals("pfx_path","",1) = 1)) Then
Debug.Print "Expected a nonempty pfx_path in the JSON."
Exit Sub
End If
' pfx_password may be empty for an unencrypted test PFX; protect the private key in production.
Dim http As New ChilkatHttp
http.RequireSslCertVerify = 1
http.FollowRedirects = 0
http.ConnectTimeout = 20
http.ReadTimeout = 30
Dim tokenEndpoint As New ChilkatStringBuilder
success = tokenEndpoint.Append("https://login.microsoftonline.com/")
success = tokenEndpoint.Append(http.UrlEncode(config.StringOf("tenant_id")))
success = tokenEndpoint.Append("/oauth2/v2.0/token")
Dim tokenUrl As String
tokenUrl = tokenEndpoint.GetAsString()
Dim cert As New ChilkatCert
success = cert.LoadPfxFile(config.StringOf("pfx_path"),config.StringOf("pfx_password"))
If (success <> 1) Then
Debug.Print "Could not load the application certificate."
Exit Sub
End If
Dim key As New PrivateKey
success = cert.GetPrivateKey(key)
If (success <> 1) Then
Debug.Print "The certificate needs an accessible RSA private key."
Exit Sub
End If
Dim der As New ChilkatBinData
success = cert.ExportCertDerBd(der)
If (success <> 1) Then
Debug.Print "Could not read the certificate DER bytes."
Exit Sub
End If
Dim crypt As New ChilkatCrypt2
crypt.HashAlgorithm = "sha256"
crypt.EncodingMode = "base64url"
Dim thumbprint As String
thumbprint = crypt.HashBdENC(der)
If (crypt.LastMethodSuccess <> 1) Then
Debug.Print "Could not hash the certificate."
Exit Sub
End If
Dim header As New ChilkatJsonObject
success = header.UpdateString("alg","PS256")
success = header.UpdateString("typ","JWT")
success = header.UpdateString("x5t#S256",thumbprint)
Dim claims As New ChilkatJsonObject
success = claims.UpdateString("aud",tokenUrl)
success = claims.UpdateString("iss",config.StringOf("client_id"))
success = claims.UpdateString("sub",config.StringOf("client_id"))
Dim assertionId As String
assertionId = crypt.GenerateUuid()
If (crypt.LastMethodSuccess <> 1) Then
Debug.Print "Could not create the assertion ID."
Exit Sub
End If
success = claims.UpdateString("jti",assertionId)
Dim clock As New CkDateTime
success = clock.SetFromCurrentSystemTime()
If (success <> 1) Then
Debug.Print "Could not read the clock."
Exit Sub
End If
' Numeric dates are JSON numbers built from decimal strings, without converting timestamps to a platform-sized integer.
success = claims.UpdateNumber("iat",clock.GetAsUnixTimeStr(0))
success = claims.UpdateNumber("nbf",clock.GetAsUnixTimeStr(0))
success = clock.AddSeconds(300)
If (success <> 1) Then
Debug.Print "Could not set assertion expiry."
Exit Sub
End If
success = claims.UpdateNumber("exp",clock.GetAsUnixTimeStr(0))
Dim jwt As New ChilkatJwt
Dim assertion As String
assertion = jwt.CreateJwtPk(header.Emit(),claims.Emit(),key)
If (jwt.LastMethodSuccess <> 1) Then
Debug.Print "Could not sign the client assertion."
Exit Sub
End If
Dim req As New ChilkatHttpRequest
req.HttpVerb = "POST"
req.ContentType = "application/x-www-form-urlencoded"
req.AddParam "client_id",config.StringOf("client_id")
req.AddParam "grant_type","client_credentials"
req.AddParam "scope","https://graph.microsoft.com/.default"
req.AddParam "client_assertion_type","urn:ietf:params:oauth:client-assertion-type:jwt-bearer"
req.AddParam "client_assertion",assertion
Dim resp As New ChilkatHttpResponse
Dim result As New ChilkatJsonObject
result.Strict = 1
success = http.HttpReq(tokenUrl,req,resp)
' A false result can still include an HTTP error response.
If ((success <> 1) And (resp.StatusCode = 0)) Then
Debug.Print "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
Exit Sub
End If
If (resp.StatusCode <> 200) Then
Debug.Print "Unexpected HTTP status: " & resp.StatusCode
Debug.Print "Request ID: " & resp.GetHeaderField("request-id")
If (resp.StatusCode = 429) Then
Debug.Print "Retry-After: " & resp.GetHeaderField("Retry-After")
End If
If (resp.StatusCode = 401) Then
Debug.Print "Refresh the Graph access token or authorize again."
End If
Exit Sub
End If
success = result.Load(resp.BodyStr)
If (success <> 1) Then
Debug.Print "Expected a well-formed JSON response."
Exit Sub
End If
If ((result.JsonTypeOf("access_token") <> 1) Or (result.StringOfEquals("access_token","",1) = 1)) Then
Debug.Print "Expected a nonempty access_token in the JSON."
Exit Sub
End If
http.AuthToken = result.StringOf("access_token")
' App-only tokens have no /me. Address the approved mailbox explicitly.
Dim endpoint As New ChilkatStringBuilder
success = endpoint.Append("https://graph.microsoft.com/v1.0/users/")
success = endpoint.Append(http.UrlEncode(config.StringOf("mailbox")))
success = endpoint.Append("/calendar?$select=id,name,canEdit")
success = http.HttpNoBody("GET",endpoint.GetAsString(),resp)
' A false result can still include an HTTP error response.
If ((success <> 1) And (resp.StatusCode = 0)) Then
Debug.Print "No HTTP response was received. Inspect diagnostics privately; reconcile a write before retrying."
Exit Sub
End If
If (resp.StatusCode <> 200) Then
Debug.Print "Unexpected HTTP status: " & resp.StatusCode
Debug.Print "Request ID: " & resp.GetHeaderField("request-id")
If (resp.StatusCode = 429) Then
Debug.Print "Retry-After: " & resp.GetHeaderField("Retry-After")
End If
If (resp.StatusCode = 401) Then
Debug.Print "Refresh the Graph access token or authorize again."
End If
Exit Sub
End If
success = result.Load(resp.BodyStr)
If (success <> 1) Then
Debug.Print "Expected a well-formed JSON response."
Exit Sub
End If
If ((result.JsonTypeOf("id") <> 1) Or (result.StringOfEquals("id","",1) = 1)) Then
Debug.Print "Expected a nonempty id in the JSON."
Exit Sub
End If
Debug.Print "Calendar ID: " & result.StringOf("id")
Debug.Print "Calendar name: " & result.StringOf("name")