View a markdown version of this page

ACME ドメインの検証 - AWS Certificate Manager

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ACME ドメインの検証

ACME ドメイン検証リソースは、ACME エンドポイントが証明書を発行できるドメインを事前に承認します。標準の ACM ドメイン検証 (証明書リクエストの一部として設定) とは異なり、ACME ドメイン検証は PKI 管理者が事前に設定する永続的リソースです。この分離により、アプリケーション所有者はドメイン検証を自分で実行しなくても証明書をリクエストできます。

各ドメイン検証には、DNS の CNAME レコードが必要です。これは、標準の ACM DNS 検証に使用されるのと同じタイプの CNAME レコードです。ただし、ACME ドメインの検証は個々のエンドポイントに固有です。同じドメインであっても、エンドポイントごとに個別の CNAME レコードが必要です。

ACME ドメイン検証と標準 ACM 検証の関係

どちらのメカニズムも同じ CNAME レコード形式と目的を使用します。つまり、「」で説明されているように、DNS に特定のレコードを配置してドメインの所有権を証明しますAWS Certificate Manager DNS 検証。いずれの場合も、CNAME は継続的なドメイン検証を ACM に委任します。レコードは ACM が管理するターゲットを指すため、ACM はユーザーからの追加のアクションなしで、時間の経過とともにドメインの所有権を再検証できます。これにより、ACM は証明書を自動的に更新できます。次のリストでは、主な違いについて説明します。

  • 標準 ACM 検証では、 の呼び出しなど、証明書リクエストの一部として CNAME を確立しますRequestCertificate

  • ACME ドメイン検証は、管理者が個々の証明書リクエストとは無関係に事前に設定する永続的な ACM リソースです。

  • ACME ドメインの検証には、エンドポイントが正確なドメイン、そのサブドメイン、またはワイルドカード名の証明書を発行できるかどうかを制御できる設定可能なスコープが含まれています。詳細については、「ドメイン検証スコープ」を参照してください。

ドメイン検証スコープ

ドメイン検証を作成するときは、この検証を使用して発行できる証明書を制御するスコープを設定します。スコープには 3 つの独立した設定があります。apex ドメインサブドメインの定義については、「」を参照してくださいドメイン名

ExactDomain (ENABLED/DISABLED)

指定した正確なドメインの証明書を許可します。たとえば、apex ドメイン を指定するとexample.com、この設定では の証明書が許可されますexample.com

Subdomains (ENABLED/DISABLED)

指定したドメインのサブドメイン ( www.example.comや など) の証明書を許可しますapi.example.com

Wildcards (ENABLED/DISABLED)

指定したドメインのワイルドカード証明書を許可します (例: *.example.com)。

これらの設定を組み合わせることができます。次の表は、スコープの組み合わせの例を示しています。

ドメイン検証スコープの組み合わせ
DomainName ExactDomain サブドメイン ワイルドカード 許可される証明書
example.com 有効 無効 無効 example.com のみ
example.com 無効 有効 無効 sub.example.com、api.example.com など
example.com 無効 無効 有効 *.example.com のみ
example.com 有効 有効 有効 example.com、任意のサブドメイン、*.example.com
internal.example.com 有効 有効 無効 internal.example.com とそのサブドメイン

ステータスライフサイクル

ドメイン検証を作成すると、ACM は最大 72 時間 CNAME レコードの検証を試みます。この期間内にレコードが検出されない場合、ドメイン検証は INVALIDステータスに移行します。ドメイン検証を作成したら、CNAME レコードをすぐにプロビジョニングしてください。

ACME ドメイン検証は、次のステータスに移行します。

VALIDATING

CNAME レコードは検証中です。ACM は最大 72 時間レコードの検証を試みます。この期間内にレコードが確認されない場合、ステータスはTIMED_OUT失敗の理由INVALIDとともに に移行します。

VALID

CNAME レコードが確認されます。ドメイン検証はアクティブであり、発行に使用できます。

INVALID

CNAME レコードの検証に失敗しました。次の障害の理由を参照してください。

DELETING

ドメインの検証は削除中です。

失敗の理由

ACCESS_DENIED

DNS レコードを検証するアクセス許可が不十分です。

DOMAIN_MISMATCH

CNAME レコードが想定値と一致しません。

HOSTED_ZONE_NOT_FOUND

指定されたホストゾーンが見つかりませんでした。

INTERNAL_FAILURE

内部エラーが発生しました。ドメイン検証を再度作成してみてください。

DOMAIN_NOT_ALLOWED

ドメインの発行は許可されていません。ドメインが制限リストに含まれているか、発行要件を満たしていない可能性があります。

CAA_ERROR

認証機関認可 (CAA) DNS レコードは、ACM がこのドメインに対して発行できないようにします。CAA レコードで Amazon が証明書を発行できることを確認します。

TIMED_OUT

CNAME レコードは 72 時間以内に検出されませんでした。レコードが DNS で伝播され、予想される名前と値と正確に一致することを確認します。

ドメイン検証の作成

ACME ドメイン検証を作成するには、ACM コンソールまたは AWS CLI を使用します。

ドメイン検証を作成するには (コンソール)

  1. AWS マネジメントコンソールにサインインし、ACM コンソールを開きます。

  2. 左側のナビゲーションペインの ACME で、エンドポイントを選択します。

  3. 設定するエンドポイントを選択します。

  4. ドメインタブを選択します。

  5. [ドメインを追加する] を選択します。

  6. ドメイン名には、ドメイン名 ( などexample.com) を入力します。

  7. 正確なドメイン、サブドメイン、ワイルドカードの範囲設定を行います。

  8. (オプション) ホストゾーン ID には、自動 CNAME プロビジョニング用の Route 53 ホストゾーン ID を入力します。

  9. (オプション) タグで、ドメイン設定に 1 つ以上のタグを追加します。

  10. ドメイン設定の追加 を選択します。

  11. Route 53 自動プロビジョニングを使用していない場合は、DNS で CNAME レコードをプロビジョニングします。必要な CNAME 名と値は、ドメイン設定の詳細に表示されます。

  12. ステータスが に変わるまで待ちますVALID

ドメイン検証を作成するには (AWS CLI)

次のコマンドを実行して、ACME ドメイン検証を作成します。

aws acm create-acme-domain-validation \ --acme-endpoint-arn arn:aws:acm:region:111122223333:acme-endpoint/00000000-0000-0000-0000-000000000000 \ --domain-name example.com \ --prevalidation-options '{ "DnsPrevalidation": { "DomainScope": { "ExactDomain": "ENABLED", "Subdomains": "ENABLED", "Wildcards": "DISABLED" }, "HostedZoneId": "Z1234567890" } }'

ステータスを確認して CNAME の詳細を取得するには、次のコマンドを実行します。

aws acm describe-acme-domain-validation \ --acme-domain-validation-arn arn:aws:acm:region:111122223333:acme-endpoint/00000000-0000-0000-0000-000000000000/acme-domain-validation/11111111-1111-1111-1111-111111111111

ドメイン検証の管理

ACME ドメインの検証では、次の管理オペレーションを実行できます。

説明

ステータスと CNAME レコードの詳細を表示します。

リスト

エンドポイントのすべてのドメイン検証を表示します。

更新

スコープ設定を変更します。

Delete

ドメイン検証を削除します。すでに発行された証明書は影響を受けません。