domains

要素domainsについて説明します。

リクエスト時、domainsの要素内に、DKIM認証で利用するドメインの情報を記載します。
配列型であり、複数のdomain情報を同時に登録することが可能となります。

{
  "domains": [
    {
      "sign_domain": "example.com",
　　　"selector": "sample0001",
      "key_len": 1024,
      "start_date": "2021-07-01T00:00+09:00",
      "default": 0,
      "enable": true
    },
    {...},
    {...}
  ]
}

構成

リクエスト時に構成される要素は以下です。

sign_domain

DKIM署名で利用するドメインです。
署名ドメインは、メール送信時にHeader Fromとして指定するメールアドレスのドメインを指定します。
メール送信時に署名ドメインと一致したドメインを指定すると、DKIM署名は作成者署名として送信されます。

異なるドメインを指定しますと、DKIMは第三者署名として送信されます。

selector

DKIM情報をドメイン名との組み合わせで、一意に認識するためのラベルです。
リクエスト時、省略しての利用を推奨します。

リクエスト時に省略すると、弊社システムで生成した文字列を返却します。
同じ署名ドメインでも、異なるセレクタを指定することで、複数の認証情報を登録可能です。

key_len

署名時に利用する鍵の長さを指定します。リクエスト時、省略可能。
鍵長は、以下の二つから選択可能です。

1. 1024
   1024bitの鍵長で生成します。省略時は1024bitで処理します。
2. 2048
   2048bitの鍵長で生成します。

start_date

登録した署名ドメインの利用開始日を指定します。リクエスト時、省略可能。
利用開始日はセレクタ単位で設定します。省略時は、登録日時で設定されます。

default

登録した署名ドメインの第三者署名利用を指定します。リクエスト時、省略可能。
セレクタ単位で指定します。

1. 0
   作成者署名として利用します。省略時は「0」で登録されます。
2. 1
   第三者署名として利用します。

本設定を行なった場合、署名ドメインと合致しないFromドメインで配信した場合、指定された署名ドメインで署名し、配信を行います。

enable

利用開始日以降に、署名ドメインの有効・無効を指定します。リクエスト時、省略可能。
セレクタ単位で指定します。

1. true
   「有効」。省略時はtrueで登録されます。
2. false
   「無効」