DataFlex

Send DKIM Signed Email

See more DKIM / DomainKey Examples

Demonstrates how to send DKIM signed email. DataFlex

Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoMailman
    Handle hoDkim
    Variant vEmail
    Handle hoEmail
    Variant vBdMime
    Handle hoBdMime
    String sPassword
    Variant vPrivKey
    Handle hoPrivKey
    String sStrRecipients
    String sStrFrom
    String sTemp1

    Move False To iSuccess

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

    Get Create (RefClass(cComChilkatMailMan)) To hoMailman
    If (Not(IsComObjectCreated(hoMailman))) Begin
        Send CreateComObject of hoMailman
    End
    Get Create (RefClass(cComChilkatDkim)) To hoDkim
    If (Not(IsComObjectCreated(hoDkim))) Begin
        Send CreateComObject of hoDkim
    End

    // SMTP server settings...
    Set ComSmtpHost Of hoMailman To "SMTP_DOMAIN"
    Set ComSmtpUsername Of hoMailman To "SMTP_LOGIN"
    Set ComSmtpPassword Of hoMailman To "SMTP_PASSWORD"
    Set ComSmtpPort Of hoMailman To 465
    Set ComSmtpSsl Of hoMailman To True

    Get Create (RefClass(cComChilkatEmail)) To hoEmail
    If (Not(IsComObjectCreated(hoEmail))) Begin
        Send CreateComObject of hoEmail
    End

    Set ComSubject Of hoEmail To "This is a test"
    Set ComBody Of hoEmail To "This is a test"
    Set ComFrom Of hoEmail To "Chilkat Support <support@chilkatsoft.com>"

    // Add some recipients (BCC recipients are added below)
    Get ComAddTo Of hoEmail "Chilkat Software" "chilkat_software@yahoo.com" To iSuccess
    Get ComAddTo Of hoEmail "Chilkat Admin" "admin@chilkatsoft.com" To iSuccess
    Get ComAddCC Of hoEmail "Chilkat Admin" "admin@chilkat.io" To iSuccess

    // When sending an email with a DKIM signature, the MIME
    // of the email must not be modified prior to
    // or during the sending process.  Therefore, the MIME of the
    // email is assembled, the DKIM signature is added, and then
    // SendMimeBd is called to send the email.

    // First get the MIME of the email.  Calling RenderToMimeBd 
    // causes the email to be signed and/or encrypted if those options
    // have been selected.  The MIME returned by RenderToMimeBd
    // is the exact MIME that would've been sent if SendEmail was
    // called.  We'll add a DKIM signature header to this MIME and then send...
    Get Create (RefClass(cComChilkatBinData)) To hoBdMime
    If (Not(IsComObjectCreated(hoBdMime))) Begin
        Send CreateComObject of hoBdMime
    End
    Get pvComObject of hoEmail to vEmail
    Get pvComObject of hoBdMime to vBdMime
    Get ComRenderToMimeBd Of hoMailman vEmail vBdMime To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoMailman To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // To create a DKIM signature,
    // you'll need to provide the following:
    // (1) An RSA private key in any common file format.
    // (2) The domain name (typically the same domain
    // as the sender of an email).
    // (3) A selector for the domain name -- an arbitrary string
    // to identify the matching public key in DNS.

    // To allow an email recipient to verify the DKIM signature via an
    // external email client supporting DKIM or using other software,
    // you will need to create a DNS record with the selector
    // and matching public key.  This example does not provide
    // information about DKIM DNS record creation.  
    // (Chilkat does not provide an API for creating DNS records.  
    // Creating the DKIM DNS record is something you would do
    // manually.)

    // Set the domain and selector:
    // You'll need to provide your own values here..
    Set ComDkimDomain Of hoDkim To "chilkatsoft.com"
    Set ComDkimSelector Of hoDkim To "brisbane"

    // Load a private key from any common RSA private key
    // format, such as DER, PKCS8, PEM, XML, etc.
    // The LoadDkimPkFile method automatically detects
    // the file format and reads it appropriately.
    // If a password is not required, you'll still need to provide
    // an empty password string argument, but it is ignored.
    Move "passwd" To sPassword
    Get Create (RefClass(cComChilkatPrivateKey)) To hoPrivKey
    If (Not(IsComObjectCreated(hoPrivKey))) Begin
        Send CreateComObject of hoPrivKey
    End
    Get ComLoadAnyFormatFile Of hoPrivKey "qa_data/pem/rsa_passwd.pem" sPassword To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoPrivKey To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get pvComObject of hoPrivKey to vPrivKey
    Get ComSetDkimPrivateKey Of hoDkim vPrivKey To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoDkim To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Add the DKIM-Signature header to the MIME in bdMime
    Get pvComObject of hoBdMime to vBdMime
    Get ComDkimSign Of hoDkim vBdMime To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoDkim To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // If desired, examine the MIME of the email being sent.
    Get ComWriteFile Of hoBdMime "qa_output/dkimSigned.eml" To iSuccess

    // ---- Prepare to send the email contained in bdMime ---

    // To send to multiple email addresses, the strRecipients should be set to a comma-separated
    // list of email addresses.

    // Note: This is where we can add additional BCC addreses.
    // Here we are adding "chilkat.support@gmail.com" as an additional BCC address.
    // Notice that the 1st three email addresses are NOT BCC because these email addresses
    // appear in the MIME header of the email (in the "To" and "CC" header fields).
    // A BCC email address does not appear in the MIME, and thus the non-BCC recipients cannot see
    // that the email was also sent to the BCC address.  (BCC means "blind carbon copy")
    Move "chilkat_software@yahoo.com, admin@chilkatsoft.com, admin@chilkat.io, chilkat.support@gmail.com" To sStrRecipients
    Move "support@chilkatsoft.com" To sStrFrom

    Get pvComObject of hoBdMime to vBdMime
    Get ComSendMimeBd Of hoMailman sStrFrom sStrRecipients vBdMime To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoMailman To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get ComCloseSmtpConnection Of hoMailman To iSuccess
    If (iSuccess <> True) Begin
        Showln "Connection to SMTP server not closed cleanly."
    End

    Showln "DKIM Signed Mail Sent!"


End_Procedure