証明書の注文と認証

このページでは、SSL 証明書の選択と購入、証明書のドメインの指定、DNS または HTTP 認証によるドメイン所有権の確認方法を説明します。

#証明書を選択する

コンソールで SSL 証明書 → 証明書を購入 (/ssl/browse) を開きます。ページ上部で発行チャネルを指定してカタログを絞り込めます。各製品カードには、次の情報が表示されます。

• 製品名とブランド（例：Let's Encrypt、ZeroSSL、DigiCert）
• 種類のタグ：DV、OV、EV、ワイルドカード、マルチドメイン
• 有効期間（日数）と価格

執筆時点のカタログは次のとおりです。最新の情報はカタログページで確認してください。

選択の目安は次のとおりです。

• HTTPS 暗号化だけが必要な場合：DV を選択します。有効期間が 90 日の DV 証明書は定期的な更新が必要です。
• すべての第 1 レベルのサブドメインが必要な場合（例：*.example.com）：ワイルドカードを選択します。ワイルドカード証明書の認証には DNS のみ使用できます。
• 複数の異なる名前を 1 つの証明書で扱う場合：マルチドメインを選択します。
• 証明書に組織の身元情報を含めたい場合：OV または EV を選択し、会社情報を準備してください。

#注文して支払う

1. 製品カードの カートに追加 をクリックします。今すぐ購入 をクリックすると、カート (/billing/cart) に直接移動します。SSL 証明書は買い切りです。
2. カートを確認して注文を確定します。証明書の請求書が作成され、自分の証明書 に 処理待ち の証明書注文が表示されます。この時点ではドメインはまだ紐付けられていません。
3. 請求管理 → 請求書 (/billing/invoices) で請求書の支払いを行います。

#ドメインと認証方法を送信する

支払い後、注文に対して証明書のドメインと認証方法を送信すると、プラットフォームが CA にリクエストを送信します。現在、この手順はユーザー API で行います。認証にはコンソールのログイントークンを使用します。

curl -X POST https://api.yeap.cloud/api/user/ssl/orders/create \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{
    "order_id": 123,
    "domain": "example.com",
    "validation_method": "dns"
  }'

パラメーター：

成功すると注文は認証待ちになり、レスポンスの validation_data に公開が必要な情報が示されます。GET /api/user/ssl/orders/get?id=<order_id> でいつでも再取得できます。validation_token と validation_value にレコード名と値が格納されています。

#ドメイン認証を完了する

#DNS 認証（推奨）

DNS プロバイダーで TXT レコードを追加します。

• Let's Encrypt や ZeroSSL などの DV 証明書では、通常 _acme-challenge プレフィックスを使用します。ほかの CA では名前やレコードの種類が異なる場合があります。必ず注文で返されたデータを使用してください。
• ワイルドカード証明書には DNS 認証が必須です。
• ゾーンを Yeap Cloud DNS でホストしている場合は、コンソールでレコードを追加できます。DNS ドキュメントを参照してください。
• DNS の変更が確認できるようになるまで、通常は数分から 30 分ほどかかります。TTL が長い場合は、さらに時間がかかります。

#HTTP 認証

ウェブサイトで認証用ファイルを公開し、http://<domain>/.well-known/... からアクセスできるようにします。注文で返されたパスと内容をそのまま使用してください（例：/.well-known/acme-challenge/<token>）。次の点を確認します。

• ドメインがファイルをホストするサーバーに名前解決され、ポート 80 にアクセスできること。
• URL がファイルの内容をそのまま返し、ログインページ、ファイアウォール、リライトルールに遮られないこと。

#認証と発行を確認する

レコードが公開されたら、手動でチェックを実行できます。

# Re-check validation
curl -X POST https://api.yeap.cloud/api/user/ssl/orders/validate \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

# Refresh the order status from the CA; fetches the certificate if it has been issued
curl -X POST https://api.yeap.cloud/api/user/ssl/orders/refresh-status \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

ポーリングする必要はありません。プラットフォームは、CA に送信済みのすべての注文を定期的に（約 30 分ごとに）自動チェックします。証明書が発行されると自動的に保存され、注文は 有効 になり、自分の証明書 からダウンロードできるようになります。

発行までの時間は種類によって異なります。DV 証明書は通常、認証に成功するとまもなく発行されます。OV と EV の証明書では CA による組織審査も必要で、通常は数営業日かかります。CA から、提出した連絡先に連絡が来る場合があります。

#トラブルシューティング

• 認証が完了しない：dig TXT _acme-challenge.example.com でレコードが外部から確認できること、値が完全で余分な引用符や空白がないことを確認してください。HTTP 認証の場合は、ブラウザーまたは curl で認証 URL を開き、レスポンス本文を確認します。
• 注文に失敗と表示される：CA がリクエストを拒否しました（例：ドメインが発行ポリシーを満たしていない場合）。理由は注文に保存され、注文照会エンドポイントで返されます。
• 長時間進展がない：注文 ID を添えてお問い合わせください。