(Tcl) Azure Key Vault Find Certificate

See more Azure Key Vault Examples

Let's say you have the certificate locally, but not with the private key. You only have the certificate, such as in a .cer file, but not the .pfx. The purpose of this example is to show how to find the same certificate in Azure Key Vault, and return the Azure Key Vault's name for the certificate.

Note: This example requires Chilkat v9.5.0.96 or later.

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

# We have a .cer file locally, and we want to find this same certificate in Azure Key Vault
# because we'll need Azure Key Vault's name (and version) for the certificate if we are going to ask
# Key Vault to sign using the cert's private key.

set cert [new_CkCert]

set success [CkCert_LoadFromFile $cert "qa_data/certs/myCert.cer"]
if {$success == 0} then {
    puts [CkCert_lastErrorText $cert]
    delete_CkCert $cert
    exit
}

# Let's the the SHA1 thumbprint for our cert in base64url format.  This is the "x5t" member that we'll 
# be seeking in the list of certificates returned from Azure Key Vault.
set bdThumbprint [new_CkBinData]

CkBinData_AppendEncoded $bdThumbprint [CkCert_sha1Thumbprint $cert] "hex"
set seek_x5t [CkBinData_getEncoded $bdThumbprint "base64url"]
puts "Seeking the cert with x5t = $seek_x5t"

# Provide information needed for Chilkat to automatically get an OAuth2 access token as needed.
set json [new_CkJsonObject]

CkJsonObject_UpdateString $json "client_id" "APP_ID"
CkJsonObject_UpdateString $json "client_secret" "APP_PASSWORD"
CkJsonObject_UpdateString $json "resource" "https://vault.azure.net"
CkJsonObject_UpdateString $json "token_endpoint" "https://login.microsoftonline.com/TENANT_ID/oauth2/token"

set http [new_CkHttp]

# Instead of providing an actual access token, we give Chilkat the information that allows it to 
# automatically fetch the access token using the OAuth2 client credentials flow.
CkHttp_put_AuthToken $http [CkJsonObject_emit $json]

# Download JSON containing information about the certs in the Azure Key Vault.
# Replace VAULT_NAME with the name of your Azure Key Vault.
set sbResponse [new_CkStringBuilder]

set success [CkHttp_QuickGetSb $http "https://VAULT_NAME.vault.azure.net/certificates?api-version=7.4" $sbResponse]
if {$success == 0} then {

    set statusCode [CkHttp_get_LastStatus $http]
    if {$statusCode == 0} then {
        # We did not get a response from the server..
        puts [CkHttp_lastErrorText $http]
    }     else {
        # We received a response, but it was an error.
        puts "Error response status code: $statusCode"
        puts "Error response:"
        puts [CkStringBuilder_getAsString $sbResponse]
    }

    delete_CkCert $cert
    delete_CkBinData $bdThumbprint
    delete_CkJsonObject $json
    delete_CkHttp $http
    delete_CkStringBuilder $sbResponse
    exit
}

set jsonResp [new_CkJsonObject]

CkJsonObject_LoadSb $jsonResp $sbResponse
CkJsonObject_put_EmitCompact $jsonResp 0

# The JSON will contain an array of certs like this:

# {
#   "value": [
#     {
#       "id": "https://kvchilkat.vault.azure.net/certificates/BadSSL",
#       "x5t": "U04xLnb8Ww7BKkW9dD7P1cCHNDY",
#       "attributes": {
#         "enabled": true,
#         "nbf": 1674409014,
#         "exp": 1737481014,
#         "created": 1697294224,
#         "updated": 1697294224
#       },
#       "subject": ""
#     },
# ...
# ...

# Find the record having an "x5t" value equal to the one we're seeking.
# jsonRec is a CkJsonObject
set jsonRec [CkJsonObject_FindRecord $jsonResp "value" "x5t" $seek_x5t 1]
if {[CkJsonObject_get_LastMethodSuccess $jsonResp] == 0} then {
    puts "Did not find a matching certificate."
} else {
    puts "Found the matching certificate."
    # The id is a value such as https://kvchilkat.vault.azure.net/certificates/BadSSL
    puts "id: [CkJsonObject_stringOf $jsonRec id]"

    # The name of the certificate is the last word after the final "/", such as "BadSSL"
    set sbId [new_CkStringBuilder]

    CkStringBuilder_Append $sbId [CkJsonObject_stringOf $jsonRec "id"]
    set certName [CkStringBuilder_getAfterFinal $sbId "/" 0]
    puts "name: $certName"

    delete_CkJsonObject $jsonRec

}

delete_CkJsonObject $jsonResp


delete_CkCert $cert
delete_CkBinData $bdThumbprint
delete_CkJsonObject $json
delete_CkHttp $http
delete_CkStringBuilder $sbResponse
delete_CkJsonObject $jsonResp
delete_CkStringBuilder $sbId