Sample code for 30+ languages & platforms
C++

Amazon SES v2: Check an address on the account suppression list

See more Amazon SES Examples

Look up one address in the sending Region with ses:GetSuppressedDestination. The record distinguishes a bounce from a complaint. An absent record tells you only that this account suppression lookup found no entry. The example signs the exact encoded mailbox path and also works with temporary credentials.

GetSuppressedDestination

Chilkat C++ Downloads

C++
#include <CkStringBuilder.h>
#include <CkDateTime.h>
#include <CkRest.h>
#include <CkCrypt2.h>
#include <CkSocket.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false;

    //  Look up the address exactly as stored, including any plus tag.
    const char *address = "avery+orders@example.com";
    const char *region = "us-west-2";
    const char *accessKey = "AWS_ACCESS_KEY_ID";
    const char *secretKey = "AWS_SECRET_ACCESS_KEY";
    const char *sessionToken = "";
    CkStringBuilder host;
    host.Append("email.");
    host.Append(region);
    host.Append(".amazonaws.com");
    CkStringBuilder mailbox;
    mailbox.Append(address);
    CkStringBuilder path;
    path.Append("/v2/email/suppression/addresses/");
    path.Append(mailbox.getEncoded("url_rfc3986","utf-8"));

    //  SigV4 for SES encodes the wire path a second time in the canonical request.
    //  Only the canonical copy escapes the percent signs. Send the original path over HTTPS.
    CkStringBuilder canonicalPath;
    canonicalPath.Append(path.getAsString());
    int replaced = canonicalPath.Replace("%","%25");
    CkDateTime clock;
    clock.SetFromCurrentSystemTime();
    CkStringBuilder stamp;
    stamp.Append(clock.getAsTimestamp(false));
    replaced = stamp.Replace("-","");
    replaced = stamp.Replace(":","");
    const char *date = stamp.getRange(0,8,false);
    CkRest rest;
    rest.AddHeader("Host",host.getAsString());
    rest.AddHeader("x-amz-date",stamp.getAsString());
    CkStringBuilder headers;
    headers.Append("host:");
    headers.Append(host.getAsString());
    headers.Append("\nx-amz-date:");
    headers.Append(stamp.getAsString());
    headers.Append("\n");
    const char *signedHeaders = "host;x-amz-date";
    if (sessionToken != "") {
        rest.AddHeader("x-amz-security-token",sessionToken);
        headers.Append("x-amz-security-token:");
        headers.Append(sessionToken);
        headers.Append("\n");
        signedHeaders = "host;x-amz-date;x-amz-security-token";
    }

    CkCrypt2 crypto;
    crypto.put_HashAlgorithm("sha256");
    crypto.put_MacAlgorithm("hmac");
    crypto.put_EncodingMode("hexlower");
    crypto.put_Charset("utf-8");
    CkStringBuilder canonical;
    canonical.Append("GET\n");
    canonical.Append(canonicalPath.getAsString());
    canonical.Append("\n\n");
    canonical.Append(headers.getAsString());
    canonical.Append("\n");
    canonical.Append(signedHeaders);
    canonical.Append("\n");
    canonical.Append(crypto.hashStringENC(""));
    CkStringBuilder scope;
    scope.Append(date);
    scope.Append("/");
    scope.Append(region);
    scope.Append("/ses/aws4_request");
    CkStringBuilder toSign;
    toSign.Append("AWS4-HMAC-SHA256\n");
    toSign.Append(stamp.getAsString());
    toSign.Append("\n");
    toSign.Append(scope.getAsString());
    toSign.Append("\n");
    toSign.Append(crypto.hashStringENC(canonical.getAsString()));

    //  Derive the signing key one HMAC at a time. Decode each intermediate key from hex.
    CkStringBuilder seed;
    seed.Append("AWS4");
    seed.Append(secretKey);
    crypto.SetMacKeyString(seed.getAsString());
    const char *key = crypto.macStringENC(date);
    crypto.SetMacKeyEncoded(key,"hex");
    key = crypto.macStringENC(region);
    crypto.SetMacKeyEncoded(key,"hex");
    key = crypto.macStringENC("ses");
    crypto.SetMacKeyEncoded(key,"hex");
    key = crypto.macStringENC("aws4_request");
    crypto.SetMacKeyEncoded(key,"hex");
    const char *signature = crypto.macStringENC(toSign.getAsString());
    CkStringBuilder authorization;
    authorization.Append("AWS4-HMAC-SHA256 Credential=");
    authorization.Append(accessKey);
    authorization.Append("/");
    authorization.Append(scope.getAsString());
    authorization.Append(", SignedHeaders=");
    authorization.Append(signedHeaders);
    authorization.Append(", Signature=");
    authorization.Append(signature);
    rest.AddHeader("Authorization",authorization.getAsString());
    CkSocket connection;
    connection.put_RequireSslCertVerify(true);
    success = connection.Connect(host.getAsString(),443,true,10000);
    if (success != true) {
        std::cout << connection.lastErrorText() << "\r\n";
        return;
    }

    success = rest.UseConnection(connection,false);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    const char *responseText = rest.fullRequestNoBody("GET",path.getAsString());
    if (rest.get_LastMethodSuccess() != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    if (rest.get_ResponseStatusCode() == 404) {
        std::cout << "No account suppression entry for this address in this Region." << "\r\n";
        return;
    }

    if (rest.get_ResponseStatusCode() != 200) {
        std::cout << "SES returned HTTP " << rest.get_ResponseStatusCode() << " " << responseText << "\r\n";
        return;
    }

    CkJsonObject response;
    success = response.Load(responseText);
    if (success != true) {
        std::cout << response.lastErrorText() << "\r\n";
        return;
    }

    std::cout << response.stringOf("SuppressedDestination.EmailAddress") << "\r\n";
    std::cout << "Reason: " << response.stringOf("SuppressedDestination.Reason") << "\r\n";
    std::cout << "Last updated (Unix seconds): " << response.stringOf("SuppressedDestination.LastUpdateTime") << "\r\n";
    }