VerifyDomainDkim
処理概要
指定したドメインに対してDKIMトークン一式を生成して返すとともに、DKIM署名に必要な設定が完了したかどうかを検証する手続きを開始します。
DKIM署名メールが送信可能になったドメインに対してDKIM署名を有効化、無効化するには「SetIdentityDkimEnabled」を使用してください。
DKIMトークンについて
ドメインの身元をあらわす文字列です。
これらのトークンを使用して、DKIM公開鍵を置いてあるニフクラ ESSのホストに転送するようにDNS CNAMEレコードを定義する必要があります。
DNS更新後、72時間以内にDNSレコードが更新されたことを検出します。
検出に成功すると、ニフクラ ESSからDKIM署名メールを送信可能になります。
各ドメインにつき、トークンは3つ所持しているので、レスポンス（XML）では、常にmemberは3つ返却されます。
指定するパラメーター
| パラメーター | 型 | 説明 | 必須 |
|---|---|---|---|
| Domain | string |
DKIM署名検証対象のドメイン名 |
○ |
応答フィールド
| フィールド (項目) | 型 | 説明 |
|---|---|---|
| VerifyDomainDkimResponse | structure |
ルート |
| ␣VerifyDomainDkimResult | structure |
結果 |
| ␣␣DkimTokens | list |
DKIMトークンのリスト |
| ␣␣␣member | string |
DKIMトークン |
| ␣ResponseMetadata | structure |
共通メタ情報 |
| ␣␣RequestId | string |
リクエスト識別子 |
エラー
| コード | メッセージ | タイプ | HTTPステータスコード | 説明 |
|---|---|---|---|---|
| ValidationError | Sender | 400 | パラメーターが不正です。 | |
| InvalidParameterValue | Sender | 400 | 無効な値または範囲外の値を入力パラメーターに指定しています。 |
リクエストサンプル
POST / HTTP/1.1
Authorization: NIFTY4-HMAC-SHA256 Credential=<Credential>/20140320/east-1/email/nifty4_request, SignedHeaders=content-type;host;x-nifty-date, Signature=<Signature>
Host: ess.api.nifcloud.com
Content-type: application/x-www-form-urlencoded
X-Nifty-Date: 20140320T112311Z
Content-Length: 43
Action=VerifyDomainDkim&Domain=example.com&Version=2010-12-01N2014-05-28
応答サンプル
HTTP/1.1 200 OK
Date: Thu, 20 Mar 2014 11:23:11 GMT
x-amzn-RequestId: 5e84d51e-3050-4407-9517-3d6906d2f1de
X-Nifty-RequestId: 5e84d51e-3050-4407-9517-3d6906d2f1de
Content-Type: text/xml
Content-Length: 2494
Connection: close
<VerifyDomainDkimResponse>
<VerifyDomainDkimResult>
<DkimTokens>
<member>kualucltd26z4yipt6owl4mikb4fmfvq</member>
<member>xwelpa6tnx5geyief43plnmg6yrwvkvg</member>
<member>oa3sn4i3gjljpmj2b62dvgrwen4goibu</member>
</DkimTokens>
</VerifyDomainDkimResult>
<ResponseMetadata>
<RequestId>2c253c6b-caa1-11e3-a7ab-2b7b69e49394</RequestId>
</ResponseMetadata>
</VerifyDomainDkimResponse>
