(Ruby) Verify Okta Access Token Locally

This example demonstrates how to validate an Okta access token using Chilkat's JWT class.

For more information, see https://developer.okta.com/docs/guides/validate-access-tokens/overview/#what-to-check-when-validating-an-access-token

Chilkat Ruby Downloads install from rubygems.org gem install chilkat or download... Ruby Library for Windows, MacOS, Linux, Alpine Linux

require 'chilkat'

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# This example begins with two JSON files:
# 
# 1. The access token obtained from Okta as shown in one fo these examples:  
#    Get Okta Token using Resource Owner Password Flow
# 
# 2. The Okta web keys obtained by this example:  Get Okta Web Keys
# 
# 

# Load the access token to be verified.
# It contains JSON that looks like this:
# {
#   "access_token": "eyJraWQiOiJhb ... O_eVu-kBp6g",
#   "token_type": "Bearer",
#   "expires_in": 3600,
#   "scope": "openid",
#   "id_token": "eyJraWQi ... FrL9WOuwbQtUg"
# }
# This example verifies the access_token.  (The id_token is verified in this example:  Verify Okta ID Token

jsonToken = Chilkat::CkJsonObject.new()
success = jsonToken.LoadFile("qa_data/tokens/okta_access_token.json")

# Load the public keys (Okta web keys), one of which is needed to validate.
# The web keys JSON looks like this:
# {
#   "keys": [
#     {
#       "kty": "RSA",
#       "alg": "RS256",
#       "kid": "anSaRDPfWGOSCVNZEIZB9quCbNsdsvl5uWGBzxbudWQ",
#       "use": "sig",
#       "e": "AQAB",
#       "n": "jT8uAgd5w ... euLB1HaVw"
#     },
#     {
# 	...
#     }
#   ]
# }

jsonWebKeys = Chilkat::CkJsonObject.new()
success = jsonWebKeys.LoadFile("qa_data/tokens/okta_web_keys.json")

# ------------------------
# Step 1: Get the JOSE header from the JWT.  The JOSE header contains JSON.  One of the JSON members will be the key ID "kid" which identifies the web key to be used for validation.
# 
jwt = Chilkat::CkJwt.new()
accessToken = jsonToken.stringOf("access_token")
joseHeader = jwt.getHeader(accessToken)

print joseHeader + "\n";
# The joseHeader contains this:   {"kid":"anSaRDPfWGOSCVNZEIZB9quCbNsdsvl5uWGBzxbudWQ","alg":"RS256"}

json = Chilkat::CkJsonObject.new()
json.Load(joseHeader)
kid = json.stringOf("kid")
print "kid to find: " + kid + "\n";

# ------------------------
# Step 2: Find the key with the same "kid" in the Okta web keys.

sbKid = Chilkat::CkStringBuilder.new()
e = ""
n = ""

i = 0
count_i = jsonWebKeys.SizeOfArray("keys")
bFound = false
iMatch = 0
while (bFound == false) and (i < count_i)
    jsonWebKeys.put_I(i)
    sbKid.Clear()
    jsonWebKeys.StringOfSb("keys[i].kid",sbKid)
    print "checking kid: " + sbKid.getAsString() + "\n";

    if (sbKid.ContentsEqual(kid,true) == true)
        e = jsonWebKeys.stringOf("keys[i].e")
        n = jsonWebKeys.stringOf("keys[i].n")
        # Exit the loop. 
        print "Found matching kid." + "\n";
        iMatch = i
        bFound = true
    end

    i = i + 1
end

if (bFound == false)
    print "No matching key ID found." + "\n";
    exit
end

print "Matching key:" + "\n";
print "  exponent = " + e + "\n";
print "  modulus = " + n + "\n";

# ------------------------
# Step 3: Load the RSA modulus and exponent into a Chilkat public key object.
pubkey = Chilkat::CkPublicKey.new()

# Get the matching JSON key from the array of keys.
jsonWebKeys.put_I(iMatch)
# jsonWebKey is a CkJsonObject
jsonWebKey = jsonWebKeys.ObjectOf("keys[i]")
success = pubkey.LoadFromString(jsonWebKey.emit())
if (success == false)
    print "Failed to load JSON web key." + "\n";
    print jsonWebKey.emit() + "\n";
    print pubkey.lastErrorText() + "\n";

    exit
end

print "successfully loaded web key." + "\n";

# OK.. we have the desired JSON web key loaded into our public key object.
# Now we can verify the access token.

# ------------------------
# Step 4: Verify the access token.
bVerified = jwt.VerifyJwtPk(accessToken,pubkey)
if (bVerified == true)
    print "The access token is valid." + "\n";
else
    print "The access token is NOT valid." + "\n";
end