CkPhp
CkPhp
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.
Chilkat CkPhp Downloads
<?php
include("chilkat.php");
$success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
$success = false;
// Look up the address exactly as stored, including any plus tag.
$address = 'avery+orders@example.com';
$region = 'us-west-2';
$accessKey = 'AWS_ACCESS_KEY_ID';
$secretKey = 'AWS_SECRET_ACCESS_KEY';
$sessionToken = '';
$host = new CkStringBuilder();
$host->Append('email.');
$host->Append($region);
$host->Append('.amazonaws.com');
$mailbox = new CkStringBuilder();
$mailbox->Append($address);
$path = new CkStringBuilder();
$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.
$canonicalPath = new CkStringBuilder();
$canonicalPath->Append($path->getAsString());
$replaced = $canonicalPath->Replace('%','%25');
$clock = new CkDateTime();
$clock->SetFromCurrentSystemTime();
$stamp = new CkStringBuilder();
$stamp->Append($clock->getAsTimestamp(false));
$replaced = $stamp->Replace('-','');
$replaced = $stamp->Replace(':','');
$date = $stamp->getRange(0,8,false);
$rest = new CkRest();
$rest->AddHeader('Host',$host->getAsString());
$rest->AddHeader('x-amz-date',$stamp->getAsString());
$headers = new CkStringBuilder();
$headers->Append('host:');
$headers->Append($host->getAsString());
$headers->Append('\nx-amz-date:');
$headers->Append($stamp->getAsString());
$headers->Append('\n');
$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';
}
$crypto = new CkCrypt2();
$crypto->put_HashAlgorithm('sha256');
$crypto->put_MacAlgorithm('hmac');
$crypto->put_EncodingMode('hexlower');
$crypto->put_Charset('utf-8');
$canonical = new CkStringBuilder();
$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(''));
$scope = new CkStringBuilder();
$scope->Append($date);
$scope->Append('/');
$scope->Append($region);
$scope->Append('/ses/aws4_request');
$toSign = new CkStringBuilder();
$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.
$seed = new CkStringBuilder();
$seed->Append('AWS4');
$seed->Append($secretKey);
$crypto->SetMacKeyString($seed->getAsString());
$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');
$signature = $crypto->macStringENC($toSign->getAsString());
$authorization = new CkStringBuilder();
$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());
$connection = new CkSocket();
$connection->put_RequireSslCertVerify(true);
$success = $connection->Connect($host->getAsString(),443,true,10000);
if ($success != true) {
print $connection->lastErrorText() . "\n";
exit;
}
$success = $rest->UseConnection($connection,false);
if ($success != true) {
print $rest->lastErrorText() . "\n";
exit;
}
$responseText = $rest->fullRequestNoBody('GET',$path->getAsString());
if ($rest->get_LastMethodSuccess() != true) {
print $rest->lastErrorText() . "\n";
exit;
}
if ($rest->get_ResponseStatusCode() == 404) {
print 'No account suppression entry for this address in this Region.' . "\n";
exit;
}
if ($rest->get_ResponseStatusCode() != 200) {
print 'SES returned HTTP ' . $rest->get_ResponseStatusCode() . ' ' . $responseText . "\n";
exit;
}
$response = new CkJsonObject();
$success = $response->Load($responseText);
if ($success != true) {
print $response->lastErrorText() . "\n";
exit;
}
print $response->stringOf('SuppressedDestination.EmailAddress') . "\n";
print 'Reason: ' . $response->stringOf('SuppressedDestination.Reason') . "\n";
print 'Last updated (Unix seconds): ' . $response->stringOf('SuppressedDestination.LastUpdateTime') . "\n";
?>