トップ
操作マニュアル

メディアのカスタムドメイン設定

最終更新日:2023年06月26日

microCMSで配信されるメディアのURLに、カスタムドメインを設定することができます。
（ご利用できるプランについては料金表の「カスタムドメイン」欄をご参照ください）

機能の詳細

microCMSで配信されるメディアのURLは、通常共通のドメインとなっています。

画像：images.microcms-assets.io
ファイル：files.microcms-assets.io

カスタムドメイン機能を設定することで、お客様が所有している独自のドメインを割り当てて、画像やファイルを配信することができます。

画像の設定例

・設定前
https://images.microcms-assets.io/assets/xxxxx/xxxxx/image.png

・設定後
https://images.example.com/assets/xxxxx/xxxxx/image.png

ファイルの設定例

・設定前
https://files.microcms-assets.io/assets/xxxxx/xxxxx/file.pdf

・設定後
https://files.example.com/assets/xxxxx/xxxxx/file.pdf

なお、共通のドメインに対してアクセスした際のリダイレクトも設定されますので、公開済みのURLに対しての考慮は必要ございません。

設定方法

本機能は管理画面からは設定できず、お問い合わせにてご対応しております。
設定にあたっては、ユーザーさまと当社の両者にて作業が発生いたしますので、設定をご希望される場合、事前にご連絡をお願いいたします。

ユーザーさま作業

DNSサーバの設定

DNSサーバにて、任意のドメイン(例:imges.example.com / files.example.com)に対する CNAMEレコードを設定し、microCMSで管理するドメインを参照するように、設定します。

images.example.com. IN CNAME cname.microcms-dns.io.
files.example.com. IN CNAME cname.microcms-dns.io.

当社作業

証明書の発行・配置

SSL証明書（DV証明書）を当社にて発行し、当社サーバに配置します。

Information

Enterpriseプランをご利用の場合、OV/EV証明書の利用が可能です。その場合、以下の点についてご留意ください。

OV/EV証明書を利用する場合は、ユーザーさまにて証明書を発行いただく必要がございます。当社で作成したCSRファイルをもとに、証明書を発行いただき、受領後、弊社サーバに配置します。詳しい進め方については、個別でご調整を実施いたします。
OV/EV証明書を利用される場合は、定期的に証明書の再発行を実施いただく必要がございます。また当社作業による再配置が必要になります。つきましては、証明書の有効期間は1年以上のものを発行いただきますようお願いします。
ワイルドカード証明書やマルチドメイン証明書など、当社にて管理しないドメインが含まれる証明書は、セキュリティの関係上、受け入れすることができません。あらかじめご了承ください。

配信設定の変更

メディアの配信ドメインを変更いたします。この時点で、以下の情報が変更されます。

APIのレスポンスに含まれるメディアURL（画像/ファイル）
Webhookのリクエストボディに含まれるメディアURL
管理画面内のメディアURL

また旧URLにアクセスした際に、新URLへの302リダイレクトが有効化されます。

Caution

URLを直接指定している箇所については、配信設定の変更を行なっても、カスタムドメインは適用されません。リダイレクトの処理がかかるため、表示には問題ありませんが、リンクのURLとしては旧URLが残る可能性がありますので、ご注意ください。

適用されない例としては、以下のようなケースが考えられます。

リッチエディタ内のリンクに、PDFなどのメディアURLを指定している
テキストフィールドにてメディアURLを入力して管理している
フロントエンドのコードから、直接メディアURLを呼び出している

Caution: 複数環境機能にて作成した環境には、カスタムドメインは適用されません。

設定の確認方法

設定されたカスタムドメインは、サービス設定 -> カスタムドメインから確認することができます。