Xbase++ Requires Chilkat v11.0.0+
Xbase++
Azure OpenID Connect Step 2 -- Get id_token and Validate
See more OIDC Examples
After getting the endpoints by querying the Azure's OIDC well-known discovery document (OpenID Configuration document), we use the authorization_endpoint to get the id_token, and then validate it..Chilkat Xbase++ Downloads
LOCAL nSuccess
LOCAL cAuthorization_endpoint
LOCAL cJwks_uri
LOCAL oReq
LOCAL oPrng
LOCAL cEncodedParams
LOCAL oSbUrl
LOCAL cUrl
LOCAL oListenSock
LOCAL oBrowserSock
LOCAL nBackLog
LOCAL nMaxWaitMs
LOCAL oTask
LOCAL oOauth2
LOCAL cStartLine
LOCAL cRequestHeader
LOCAL oSbRequestBody
LOCAL oSbResponseHtml
LOCAL oSbResponse
LOCAL oHashTab
LOCAL cIdToken
LOCAL oJwt
LOCAL nLeeway
LOCAL nBTimeValid
LOCAL cPayload
LOCAL oJson
LOCAL cJoseHeader
LOCAL oJsonJoseHeader
LOCAL oSbJwks
LOCAL oHttp
LOCAL oJwkset
LOCAL cKid
LOCAL oJwk
LOCAL nVerified
LOCAL oPubkey
nSuccess := 0
// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
// In our previous example (Azure Fetch OpenID Connect metadata document) we fetched
// the OpenID configuration document which is JSON which contains an entry for authorization_endpoint.
cAuthorization_endpoint := "https://login.microsoftonline.com/{tenant}/oauth2/v2.0/authorize"
// The OpenID Connect metadata document also contained a jwks_uri entry. This is the JSON Web Key Set (JWKS),
// which is a set of keys containing the public keys used to verify any JSON Web Token (JWT) (in this case the id_token)
// issued by the authorization server and signed using the RS256 signing algorithm.
cJwks_uri := "https://login.microsoftonline.com/{tenant}/discovery/v2.0/keys"
// We're going to send the following GET request, but it will be sent through an interactive web browser (not by Chilkat).
// The following code will form the URL that is to be programmatically loaded and sent in a browser.
// GET https://login.microsoftonline.com/{tenant}/oauth2/v2.0/authorize?
// client_id=6731de76-14a6-49ae-97bc-6eba6914391e
// &response_type=id_token
// &redirect_uri=http%3A%2F%2Flocalhost%2Fmyapp%2F
// &response_mode=form_post
// &scope=openid
// &state=12345
// &nonce=678910
// Use this object to set params and then get the URL-encoded query params string
oReq := CreateObject("Chilkat.HttpRequest")
oReq:AddParam("client_id", "{client_id}")
oReq:AddParam("response_type", "id_token")
oReq:AddParam("redirect_uri", "http://localhost:3017/")
oReq:AddParam("response_mode", "form_post")
oReq:AddParam("scope", "openid")
oPrng := CreateObject("Chilkat.Prng")
oReq:AddParam("state", oPrng:GenRandom(3, "decimal"))
oReq:AddParam("nonce", oPrng:GenRandom(4, "decimal"))
cEncodedParams := oReq:GetUrlEncodedParams()
? cEncodedParams
// Sample URL encoded params:
// client_id=6731de76-14a6-49ae-97bc-6eba6914391e&redirect_uri=http%3A%2F%2Flocalhost%3A3017%2F&response_mode=form_post&scope=openid&state=3572902&nonce=57352474
// This is the URL to be programmatically loaded and sent in an interactive web browser..
oSbUrl := CreateObject("Chilkat.StringBuilder")
oSbUrl:Append(cAuthorization_endpoint)
oSbUrl:Append("?")
oSbUrl:Append(cEncodedParams)
cUrl := oSbUrl:GetAsString()
// Before we launch the browser with the contents of sbUrl, create a socket to listen for the eventual callback..
oListenSock := CreateObject("Chilkat.Socket")
// This is the connection received from the browser.
oBrowserSock := CreateObject("Chilkat.Socket")
// Listen at the port indicated by the redirect_uri above.
nBackLog := 5
nSuccess := oListenSock:BindAndListen(3017, nBackLog)
IF (nSuccess == 0)
? oListenSock:LastErrorText
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
RETURN
ENDIF
// Wait for the browser's connection in a background thread.
// (We'll send load the URL into the browser following this..)
// Wait a max of 60 seconds before giving up.
nMaxWaitMs := 30000
oTask := oListenSock:AcceptNextAsync(nMaxWaitMs, oBrowserSock)
oTask:Run()
// -------------------------------------------------------------------
// At this point, your application should load the URL in a browser.
oOauth2 := CreateObject("Chilkat.OAuth2")
nSuccess := oOauth2:LaunchBrowser(cUrl)
IF (nSuccess == 0)
? oOauth2:LastErrorText
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
oOauth2:destroy()
RETURN
ENDIF
// -------------------------------------------------------------------
// Wait for the listenSock's task to complete.
nSuccess := oTask:Wait(nMaxWaitMs)
IF (.NOT. nSuccess .OR. (oTask:StatusInt != 7) .OR. (oTask:TaskSuccess != 1))
IF (.NOT. nSuccess)
// The task.LastErrorText applies to the Wait method call.
? oTask:LastErrorText
ELSE
// The ResultErrorText applies to the underlying task method call (i.e. the AcceptNextConnection)
? oTask:Status
? oTask:ResultErrorText
ENDIF
oTask:destroy()
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
oOauth2:destroy()
RETURN
ENDIF
// If we get to this point, a connection on listenSock was accepted, and the redirected POST
// is waiting to be read on the connected socket.
// The POST we are going to read contains the following:
// POST /myapp/ HTTP/1.1
// Host: localhost
// Content-Type: application/x-www-form-urlencoded
//
// id_token=eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Ik1uQ19WWmNB...&state=12345
// But first.. we no longer need the listen socket...
// Stop listening on port 3017.
oListenSock:Close(10)
oTask:destroy()
// We're acting as a temporary web server to receive this one redirected HTTP request..
// Read the start line of the request.. (i.e. the "POST /myapp/ HTTP/1.1")
cStartLine := oBrowserSock:ReceiveUntilMatch(Chr(13) + Chr(10))
IF (oBrowserSock:LastMethodSuccess == 0)
? oBrowserSock:LastErrorText
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
oOauth2:destroy()
RETURN
ENDIF
// Read the request header.
cRequestHeader := oBrowserSock:ReceiveUntilMatch(Chr(13) + Chr(10) + Chr(13) + Chr(10))
IF (oBrowserSock:LastMethodSuccess == 0)
? oBrowserSock:LastErrorText
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
oOauth2:destroy()
RETURN
ENDIF
? cRequestHeader
? "----"
// Read the body.
// The body will contain "id_token= eyJ......"
oSbRequestBody := CreateObject("Chilkat.StringBuilder")
nSuccess := oBrowserSock:ReceiveSb(oSbRequestBody)
IF (nSuccess == 0)
? oBrowserSock:LastErrorText
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
oOauth2:destroy()
oSbRequestBody:destroy()
RETURN
ENDIF
? oSbRequestBody:GetAsString()
// Given that we're acting as a web server, we must send a response..
// We can now send our HTTP response.
oSbResponseHtml := CreateObject("Chilkat.StringBuilder")
oSbResponseHtml:Append("<html><body><p>Thank you!</b></body</html>")
oSbResponse := CreateObject("Chilkat.StringBuilder")
oSbResponse:Append("HTTP/1.1 200 OK" + Chr(13) + Chr(10))
oSbResponse:Append("Content-Length: ")
oSbResponse:AppendInt(oSbResponseHtml:Length)
oSbResponse:Append(Chr(13) + Chr(10))
oSbResponse:Append("Content-Type: text/html" + Chr(13) + Chr(10))
oSbResponse:Append(Chr(13) + Chr(10))
oSbResponse:AppendSb(oSbResponseHtml)
oBrowserSock:SendString(oSbResponse:GetAsString())
oBrowserSock:Close(50)
// Get the id_token from the sbRequestBody that we just received.
// (Remember, we're acting as the web server, thus we received the redirect request..)
oHashTab := CreateObject("Chilkat.Hashtable")
oHashTab:AddQueryParams(oSbRequestBody:GetAsString())
// See https://docs.microsoft.com/en-us/azure/active-directory/develop/id-tokens#validating-an-id-token
// for more information about ID tokens..
cIdToken := oHashTab:LookupStr("id_token")
oJwt := CreateObject("Chilkat.Jwt")
// Let's see if the time constraints, if any, are valid.
// The above JWT was created on the afternoon of 16-May-2016, with an expiration of 1 hour.
// If the current system time is before the "nbf" time, or after the "exp" time,
// then IsTimeValid will return false/0.
// Also, we'll allow a leeway of 60 seconds to account for any clock skew.
// Note: If the token has no "nbf" or "exp" claim fields, then IsTimeValid is always true.
nLeeway := 60
nBTimeValid := oJwt:IsTimeValid(cIdToken, nLeeway)
? "time constraints valid: " + Str(nBTimeValid)
// Now let's recover the original claims JSON (the payload).
cPayload := oJwt:GetPayload(cIdToken)
// The payload will likely be in compact form:
? cPayload
// We can format for human viewing by loading it into Chilkat's JSON object
// and emit.
oJson := CreateObject("Chilkat.JsonObject")
nSuccess := oJson:Load(cPayload)
oJson:EmitCompact := 0
? oJson:Emit()
// Sample output:
// {
// "aud": "f125d695-c50e-456e-a579-a486f06d1213",
// "iss": "https://login.microsoftonline.com/6d8ddd66-68d1-43b0-af5c-e31b4b7dd5cd/v2.0",
// "iat": 1626535322,
// "nbf": 1626535322,
// "exp": 1626539222,
// "aio": "AWQAm/8TAAAAHQncmY0VvhgyMIhfleHX3DjsGfmlPM1CopkJ3mPnBUnCxrJ0ubruaACEhwGO7NsoHBhqFEzRzPxOq7MtuGVFsql+qJKZx8vQCszKYEPX9Wb3b5+d5KJTABHCIH48bTFd",
// "idp": "https://sts.windows.net/9188040d-6c67-4c5b-b112-36a304b66dad/",
// "nonce": "1519043321",
// "rh": "0.ARgAZt2NbdFosEOvXOMbS33VzZXWJfEOxW5FpXmkhvBtEhMYALQ.",
// "sub": "RMIZlHJ7hfsJmL8Qq3h6M0nPi4g-HEavnAFgxzaT2KM",
// "tid": "6d8ddd66-68d1-43b0-af5c-e31b4b7dd5cd",
// "uti": "-BXGHxvfREW-r9HI5NBiAA",
// "ver": "2.0"
// }
// We can recover the original JOSE header in the same way:
cJoseHeader := oJwt:GetHeader(cIdToken)
// The payload will likely be in compact form:
? cJoseHeader
// We can format for human viewing by loading it into Chilkat's JSON object
// and emit.
oJsonJoseHeader := CreateObject("Chilkat.JsonObject")
nSuccess := oJsonJoseHeader:Load(cJoseHeader)
oJsonJoseHeader:EmitCompact := 0
? oJsonJoseHeader:Emit()
// Sample output:
// {
// "typ": "JWT",
// "alg": "RS256",
// "kid": "nOo3ZDrODXEK1jKWhXslHR_KXEg"
// }
// Finally, we need to fetch the JSON Web Key Sets from the jwks_uri
// and use it to verify the id_token's RSA signature.
oSbJwks := CreateObject("Chilkat.StringBuilder")
oHttp := CreateObject("Chilkat.Http")
nSuccess := oHttp:QuickGetSb(cJwks_uri, oSbJwks)
IF (nSuccess == 0)
? oHttp:LastErrorText
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
oOauth2:destroy()
oSbRequestBody:destroy()
oSbResponseHtml:destroy()
oSbResponse:destroy()
oHashTab:destroy()
oJwt:destroy()
oJson:destroy()
oJsonJoseHeader:destroy()
oSbJwks:destroy()
oHttp:destroy()
RETURN
ENDIF
oJwkset := CreateObject("Chilkat.JsonObject")
nSuccess := oJwkset:LoadSb(oSbJwks)
oJwkset:EmitCompact := 0
? oJwkset:Emit()
// A sample jwkset:
// {
// "keys": [
// {
// "kty": "RSA",
// "use": "sig",
// "kid": "nOo3ZDrODXEK1jKWhXslHR_KXEg",
// "x5t": "nOo3ZDrODXEK1jKWhXslHR_KXEg",
// "n": "oaLLT9hkcSj ... NVrZdUdTBQ",
// "e": "AQAB",
// "x5c": [
// "MIIDBTC ... MRku44Dw7R"
// ],
// "issuer": "https://login.microsoftonline.com/6d8ddd66-68d1-43b0-af5c-e31b4b7dd5cd/v2.0"
// },
// {
// "kty": "RSA",
// "use": "sig",
// "kid": "l3sQ-50cCH4xBVZLHTGwnSR7680",
// "x5t": "l3sQ-50cCH4xBVZLHTGwnSR7680",
// "n": "sfsXMXW ... AYkwb6xUQ",
// "e": "AQAB",
// "x5c": [
// "MIIDBTCCA ... BWrh+/vJ"
// ],
// "issuer": "https://login.microsoftonline.com/6d8ddd66-68d1-43b0-af5c-e31b4b7dd5cd/v2.0"
// },
// {
// "kty": "RSA",
// "use": "sig",
// "kid": "DqUu8gf-nAgcyjP3-SuplNAXAnc",
// "x5t": "DqUu8gf-nAgcyjP3-SuplNAXAnc",
// "n": "1n7-nWSL ... V3pFWhQ",
// "e": "AQAB",
// "x5c": [
// "MIIC8TC ... 9pIcnkPQ=="
// ],
// "issuer": "https://login.microsoftonline.com/6d8ddd66-68d1-43b0-af5c-e31b4b7dd5cd/v2.0"
// },
// {
// "kty": "RSA",
// "use": "sig",
// "kid": "OzZ5Dbmcso9Qzt2ModGmihg30Bo",
// "x5t": "OzZ5Dbmcso9Qzt2ModGmihg30Bo",
// "n": "01re9a2BU ... 5OzQ6Q",
// "e": "AQAB",
// "x5c": [
// "MIIC8TC ... YmwJ6sDdRvQ=="
// ],
// "issuer": "https://login.microsoftonline.com/6d8ddd66-68d1-43b0-af5c-e31b4b7dd5cd/v2.0"
// }
// ]
// }
// We should have an RSA key with kid matching the kid from the joseHeader..
cKid := oJsonJoseHeader:StringOf("kid")
// Find the RSA key with the specified key id
oJwk := oJwkset:FindRecord("keys", "kid", cKid, 1)
IF (oJwkset:LastMethodSuccess == 0)
? "Failed to find a matching RSA key in the JWK key set..."
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
oOauth2:destroy()
oSbRequestBody:destroy()
oSbResponseHtml:destroy()
oSbResponse:destroy()
oHashTab:destroy()
oJwt:destroy()
oJson:destroy()
oJsonJoseHeader:destroy()
oSbJwks:destroy()
oHttp:destroy()
oJwkset:destroy()
RETURN
ENDIF
oPubkey := CreateObject("Chilkat.PublicKey")
nSuccess := oPubkey:LoadFromString(oJwk:Emit())
IF (nSuccess == 0)
? oPubkey:LastErrorText
? oJwk:Emit()
ELSE
nVerified := oJwt:VerifyJwtPk(cIdToken, oPubkey)
? "Verified: " + Str(nVerified)
ENDIF
oJwk:destroy()
oReq:destroy()
oPrng:destroy()
oSbUrl:destroy()
oListenSock:destroy()
oBrowserSock:destroy()
oOauth2:destroy()
oSbRequestBody:destroy()
oSbResponseHtml:destroy()
oSbResponse:destroy()
oHashTab:destroy()
oJwt:destroy()
oJson:destroy()
oJsonJoseHeader:destroy()
oSbJwks:destroy()
oHttp:destroy()
oJwkset:destroy()
oPubkey:destroy()