Sample code for 30+ languages & platforms
PureBasic Requires Chilkat v11.0.0+

Check a published DKIM selector against a signed message

See more DKIM Examples

After publishing a selector, run this check with a message signed by its matching private key. Start with a fresh verifier, fetch the public key from DNS, and then verify the message with that same object. DNS lookup alone shows only that a usable key was returned. Signature verification also checks that it matches what the signer used.

Set the signing domain and selector exactly as they appear in the signature. Applications processing many messages can reuse the verifier for that selector. After a key change, use a new verifier and allow for the DNS resolver’s TTL.

Chilkat PureBasic Downloads

PureBasic
IncludeFile "CkBinData.pb"
IncludeFile "CkDkim.pb"
IncludeFile "CkJsonObject.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Assumes Chilkat is unlocked. See Global Unlock Sample.

    message.i = CkBinData::ckCreate()
    If message.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkBinData::ckLoadFile(message,"signed.eml")
    If success <> 1
        Debug "Could not read signed.eml."
        CkBinData::ckDispose(message)
        ProcedureReturn
    EndIf

    verifier.i = CkDkim::ckCreate()
    If verifier.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    domain.s = "example.com"
    selector.s = "mail2026"
    success = CkDkim::ckPrefetchPublicKey(verifier,selector,domain)
    If success <> 1
        Debug CkDkim::ckLastErrorText(verifier)
        CkBinData::ckDispose(message)
        CkDkim::ckDispose(verifier)
        ProcedureReturn
    EndIf

    ;  signed.eml from the signing example has our newly added signature at index zero.
    If CkDkim::ckNumDkimSigs(verifier,message) = 0
        Debug "No DKIM signature in signed.eml."
        CkBinData::ckDispose(message)
        CkDkim::ckDispose(verifier)
        ProcedureReturn
    EndIf

    success = CkDkim::ckDkimVerify(verifier,0,message)
    If success <> 1
        Debug CkDkim::ckLastErrorText(verifier)
        Debug CkDkim::ckVerifyInfo(verifier)
        CkBinData::ckDispose(message)
        CkDkim::ckDispose(verifier)
        ProcedureReturn
    EndIf

    info.i = CkJsonObject::ckCreate()
    If info.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkJsonObject::ckLoad(info,CkDkim::ckVerifyInfo(verifier))
    If (success <> 1) OR (CkJsonObject::ckStringOfEquals(info,"domain",domain,1) <> 1) OR (CkJsonObject::ckStringOfEquals(info,"selector",selector,1) <> 1)
        Debug "The first signature is not from the selected domain and selector."
        CkBinData::ckDispose(message)
        CkDkim::ckDispose(verifier)
        CkJsonObject::ckDispose(info)
        ProcedureReturn
    EndIf

    Debug "The published key verifies this message for " + selector + "._domainkey." + domain


    CkBinData::ckDispose(message)
    CkDkim::ckDispose(verifier)
    CkJsonObject::ckDispose(info)


    ProcedureReturn
EndProcedure