<h2 id="apigateway%E3%81%AE%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E6%A6%82%E8%A6%81" data-line="1" class="code-line">
<a class="header-anchor-link" href="#apigateway%E3%81%AE%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E6%A6%82%E8%A6%81" aria-hidden="true"></a> Apigatewayのカスタムドメイン概要</h2>
<p data-line="3" class="code-line">AWS API Gateway を使うと、デフォルトでは</p>
<div class="code-block-container"><pre><code class="code-line" data-line="4">https://{apiId}.execute-api.{region}.amazonaws.com/{stage}/…
</code></pre></div><p data-line="7" class="code-line">という execute-api ドメイン 付き URL が自動払い出しされます。<br>
しかし実運用では下記のようなニーズがあります。</p>
<ul data-line="9" class="code-line">
<li data-line="9" class="code-line">サービスのブランディング: api.example.com など覚えやすい URL を使いたい</li>
<li data-line="10" class="code-line">HTTPS 証明書の名義: 独自ドメインに合わせた証明書を返したい</li>
<li data-line="11" class="code-line">パス構成: /prod /v1 を隠蔽してシンプルにしたい</li>
</ul>
<p data-line="13" class="code-line">これを実現する仕組みが API Gateway のカスタムドメイン です。</p>
<p data-line="15" class="code-line">カスタムドメインを利用すれば</p>
<div class="code-block-container"><pre><code class="code-line" data-line="16">https://api.example.com/users
</code></pre></div><p data-line="19" class="code-line">のように 独自ドメイン + 任意のパス で呼び出せます。</p>
<h2 id="apigateway%E3%81%AEexecute-api%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B" data-line="21" class="code-line">
<a class="header-anchor-link" href="#apigateway%E3%81%AEexecute-api%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B" aria-hidden="true"></a> Apigatewayのexecute-apiドメインとは何か</h2>
<p data-line="23" class="code-line">API Gateway が自動発行するデフォルトエンドポイントです。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="24">https://abc12345.execute-api.ap-northeast-1.amazonaws.com/prod
</code></pre></div><ul data-line="28" class="code-line">
<li data-line="28" class="code-line">固定 IP は無く、CloudFront のディストリビューションが裏側で動いている</li>
<li data-line="29" class="code-line">HTTPS で返される証明書は <code>*.execute-api.ap-northeast-1.amazonaws.com</code> などの ワイルドカード証明書</li>
</ul>
<h2 id="%E3%82%A8%E3%82%A4%E3%83%AA%E3%82%A2%E3%82%B9%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E3%81%A8%E3%81%AF%EF%BC%88a%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E3%83%BBc%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E9%81%95%E3%81%84%EF%BC%89" data-line="32" class="code-line">
<a class="header-anchor-link" href="#%E3%82%A8%E3%82%A4%E3%83%AA%E3%82%A2%E3%82%B9%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E3%81%A8%E3%81%AF%EF%BC%88a%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E3%83%BBc%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E9%81%95%E3%81%84%EF%BC%89" aria-hidden="true"></a> エイリアスレコードとは（Aレコード・Cレコード違い）</h2>
<table data-line="34" class="code-line">
<thead data-line="34" class="code-line">
<tr data-line="34" class="code-line">
<th>レコード種別</th>
<th>変換対象</th>
<th>主な用途</th>
<th>ルートドメイン (<code>example.com</code>) に使えるか</th>
</tr>
</thead>
<tbody data-line="36" class="code-line">
<tr data-line="36" class="code-line">
<td>A レコード</td>
<td>ドメイン ▶ IPアドレス</td>
<td>静的ウェブサーバ、EC2 など</td>
<td>✅</td>
</tr>
<tr data-line="37" class="code-line">
<td>CNAME レコード</td>
<td>ドメイン ▶ 別ドメイン名</td>
<td>
<code>www</code> → ルートへ転送など</td>
<td>❌（RFCで禁止）</td>
</tr>
<tr data-line="38" class="code-line">
<td>Alias レコード (Route 53 独自)</td>
<td>ドメイン ▶ AWS サービスのドメイン名</td>
<td>ALB, CloudFront, API Gateway など</td>
<td>✅</td>
</tr>
</tbody>
</table>
<h2 id="%E3%82%A8%E3%82%A4%E3%83%AA%E3%82%A2%E3%82%B9%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E3%81%ABexecute-api%E3%82%92%E7%B4%90%E3%81%A5%E3%81%91%E3%82%8B%E3%81%A0%E3%81%91%E3%81%A0%E3%81%A8%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AB%E3%81%AA%E3%82%8B%EF%BC%9F" data-line="40" class="code-line">
<a class="header-anchor-link" href="#%E3%82%A8%E3%82%A4%E3%83%AA%E3%82%A2%E3%82%B9%E3%83%AC%E3%82%B3%E3%83%BC%E3%83%89%E3%81%ABexecute-api%E3%82%92%E7%B4%90%E3%81%A5%E3%81%91%E3%82%8B%E3%81%A0%E3%81%91%E3%81%A0%E3%81%A8%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AB%E3%81%AA%E3%82%8B%EF%BC%9F" aria-hidden="true"></a> エイリアスレコードにexecute-apiを紐づけるだけだとエラーになる？</h2>
<p data-line="42" class="code-line">処理の遷移は下記です</p>
<div class="code-block-container"><pre><code class="code-line" data-line="43">api.example.com -&gt; Alias -&gt; abc12345.execute-api.ap-northeast-1.amazonaws.com
</code></pre></div><p data-line="47" class="code-line">この場合、ブラウザで<code>NET::ERR_CERT_COMMON_NAME_INVALID</code>など 証明書不一致エラー を返します。</p>
<h3 id="%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%81%A3%E3%81%A6%E4%BD%95%EF%BC%9F" data-line="49" class="code-line">
<a class="header-anchor-link" href="#%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%81%A3%E3%81%A6%E4%BD%95%EF%BC%9F" aria-hidden="true"></a> 証明書って何？</h3>
<p data-line="50" class="code-line">HTTPS では、サーバーと通信する際にSSL/TLS証明書を使って安全性を担保します。<br>
たとえば、ブラウザが <a href="https://api.example.com" target="_blank" rel="nofollow noopener noreferrer">https://api.example.com</a> にアクセスすると、こうチェックされます：</p>
<ol data-line="52" class="code-line">
<li data-line="52" class="code-line">サーバーが「このドメイン用の証明書」を持っているか</li>
<li data-line="53" class="code-line">その証明書が信頼できる認証局（CA）から発行されているか</li>
<li data-line="54" class="code-line">証明書の「CN（Common Name）」や「SAN（Subject Alternative Name）」 に<strong>api.example.com が含まれているか</strong>
</li>
</ol>
<h3 id="%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%8C%E8%B5%B7%E3%81%8D%E3%82%8B%E5%8E%9F%E5%9B%A0" data-line="56" class="code-line">
<a class="header-anchor-link" href="#%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%8C%E8%B5%B7%E3%81%8D%E3%82%8B%E5%8E%9F%E5%9B%A0" aria-hidden="true"></a> 証明書エラーが起きる原因</h3>
<p data-line="58" class="code-line">仮に次のように設定したとします：</p>
<div class="code-block-container"><pre><code class="code-line" data-line="59">api.example.com → Alias → abc12345.execute-api.ap-northeast-1.amazonaws.com
</code></pre></div><p data-line="62" class="code-line">この場合、アクセスは api.example.com ですが、実際に証明書を持ってるのは execute-api.ap-northeast-1.amazonaws.com です。<br>
abc12345.execute-api.ap-northeast-1.amazonaws.com が返す証明書には、api.example.com が含まれていないです。（execute-api.ap-northeast-1.amazonaws.comは、api.example.comの証明書を知りません。）</p>
<h2 id="%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E3%81%AE%E5%BF%85%E8%A6%81%E6%80%A7" data-line="65" class="code-line">
<a class="header-anchor-link" href="#%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E3%81%AE%E5%BF%85%E8%A6%81%E6%80%A7" aria-hidden="true"></a> カスタムドメインの必要性</h2>
<h3 id="%E2%91%A0-%E8%A6%8B%E3%81%9F%E7%9B%AE%E3%81%8C%E6%95%B4%E3%81%A3%E3%81%9F-url-%E3%82%92%E6%8F%90%E4%BE%9B%E3%81%A7%E3%81%8D%E3%82%8B" data-line="67" class="code-line">
<a class="header-anchor-link" href="#%E2%91%A0-%E8%A6%8B%E3%81%9F%E7%9B%AE%E3%81%8C%E6%95%B4%E3%81%A3%E3%81%9F-url-%E3%82%92%E6%8F%90%E4%BE%9B%E3%81%A7%E3%81%8D%E3%82%8B" aria-hidden="true"></a> ① 見た目が整った URL を提供できる</h3>
<p data-line="68" class="code-line">デフォルトだと <a href="https://abc12345.execute-api.ap-northeast-1.amazonaws.com/prod/" target="_blank" rel="nofollow noopener noreferrer">https://abc12345.execute-api.ap-northeast-1.amazonaws.com/prod/</a> のような長くて無機質なURLになるが、<a href="https://api.example.com" target="_blank" rel="nofollow noopener noreferrer">https://api.example.com</a> ならわかりやすく信頼感もある</p>
<h3 id="%E2%91%A1-%E7%8B%AC%E8%87%AA%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E7%94%A8%E3%81%AEhttps%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%81%8C%E4%BD%BF%E3%81%88%E3%82%8B" data-line="70" class="code-line">
<a class="header-anchor-link" href="#%E2%91%A1-%E7%8B%AC%E8%87%AA%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E7%94%A8%E3%81%AEhttps%E8%A8%BC%E6%98%8E%E6%9B%B8%E3%81%8C%E4%BD%BF%E3%81%88%E3%82%8B" aria-hidden="true"></a> ② 独自ドメイン用のHTTPS証明書が使える</h3>
<p data-line="71" class="code-line">execute-api ドメインだと AWS の汎用証明書になる。api.example.com に対してはそのドメインに合った証明書が必要で、それはカスタムドメインでしか対応できない</p>
<h3 id="%E2%91%A2-%E3%82%B9%E3%83%86%E3%83%BC%E3%82%B8%E5%90%8D%EF%BC%88%2Fprod%E3%81%AA%E3%81%A9%EF%BC%89%E3%82%92%E9%9A%A0%E3%81%9B%E3%82%8B%EF%BC%8F%E6%95%B4%E7%90%86%E3%81%A7%E3%81%8D%E3%82%8B" data-line="73" class="code-line">
<a class="header-anchor-link" href="#%E2%91%A2-%E3%82%B9%E3%83%86%E3%83%BC%E3%82%B8%E5%90%8D%EF%BC%88%2Fprod%E3%81%AA%E3%81%A9%EF%BC%89%E3%82%92%E9%9A%A0%E3%81%9B%E3%82%8B%EF%BC%8F%E6%95%B4%E7%90%86%E3%81%A7%E3%81%8D%E3%82%8B" aria-hidden="true"></a> ③ ステージ名（/prodなど）を隠せる／整理できる</h3>
<p data-line="74" class="code-line"><a href="https://api.example.com/users" target="_blank" rel="nofollow noopener noreferrer">https://api.example.com/users</a> のようにアクセスさせつつ、内部的には /prod/users にルーティングできる（ベースパスマッピング機能）</p>
<h3 id="%E2%91%A3-%E3%83%9E%E3%83%AB%E3%83%81%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%EF%BC%8F%E3%83%9E%E3%83%AB%E3%83%81%E3%82%B9%E3%83%86%E3%83%BC%E3%82%B8%E5%AF%BE%E5%BF%9C%E3%81%8C%E3%81%97%E3%82%84%E3%81%99%E3%81%84" data-line="76" class="code-line">
<a class="header-anchor-link" href="#%E2%91%A3-%E3%83%9E%E3%83%AB%E3%83%81%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%EF%BC%8F%E3%83%9E%E3%83%AB%E3%83%81%E3%82%B9%E3%83%86%E3%83%BC%E3%82%B8%E5%AF%BE%E5%BF%9C%E3%81%8C%E3%81%97%E3%82%84%E3%81%99%E3%81%84" aria-hidden="true"></a> ④ マルチバージョン／マルチステージ対応がしやすい</h3>
<p data-line="77" class="code-line">/v1, /v2 のようにベースパスを分けることで、複数のAPIステージを1つのドメインで柔軟に管理できる</p>


Apigatewayのカスタムドメインとは何か・なぜ必要か

Apigatewayのカスタムドメイン概要

Apigatewayのexecute-apiドメインとは何か

エイリアスレコードとは（Aレコード・Cレコード違い）

エイリアスレコードにexecute-apiを紐づけるだけだとエラーになる？

① 見た目が整った URL を提供できる

② 独自ドメイン用のHTTPS証明書が使える

③ ステージ名（/prodなど）を隠せる／整理できる

④ マルチバージョン／マルチステージ対応がしやすい

Discussion