本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> ESS> VerifyDomainDkim

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>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2021年9月17日時点の情報です。

推奨画面サイズ 1024×768 以上