カスタムホスト名

Sitecore Cloud Portal
カスタムホスト名
カスタムホスト名を設定する

カスタムホスト名を設定する

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このチュートリアルでは、カスタムホスト名を設定する方法について説明します。カスタムホスト名を使用すると、組織のドメインのサブドメインを使用してSitecore APIにアクセスできます。たとえば、<your-custom-hostname>.example.com.

カスタムホスト名を追加して、独自のドメインを使用してSitecore APIにアクセスできます。

カスタムホスト名を設定するには、まずSitecore Cloud Portalから、またはEdge Platform Admin REST APIを使用してホスト名を作成し、次にドメインプロバイダーで検証する必要があります。

このチュートリアルでは、次の方法について説明します。

始める前に

Sitecore Cloud Portal組織のOrganization AdminまたはOrganization Ownerである必要があります。
ドメイン名と、ドメインホストでTXTレコードを作成する権限が必要です。

カスタムホスト名を作成する

メモ

現在、カスタムホスト名は <your-custom-hostname>.example.comなどのサブドメインである必要があります。ワイルドカードとapexドメインはサポートされていません。

Sitecore Cloud PortalまたはEdge Platform APIを使用してカスタムホスト名を作成し、応答の情報を使用してドメインのDNSレコードにレコードを追加する必要があります。

作成できるホスト名の最大数は、契約によって決まります。この制限を増やすには、Sitecoreの担当者にお問い合わせください。

カスタムホスト名を作成するには:

Sitecore Cloud Portal

カスタムホスト名ページを開き、Create custom hostnameをクリックします。
Create custom hostnameダイアログのHostnameフィールドに、作成するカスタムホスト名を入力します。ワイルドカードとapexドメインはサポートされていません。
Default Context IDフィールドに、カスタムホスト名に関連付けられているデフォルトのコンテキストIDを入力します。

ここでデフォルトのコンテキストIDの値を指定しない場合は、ホスト名にリクエストを行うたびに、クエリパラメータまたはヘッダーにコンテキストIDを指定する必要があります。
Default site IDフィールドに、このホスト名にアタッチするサイトの名前を入力します。サイトIDは、デプロイアプリの開発者設定タブのSITECORE_SITE_NAME変数の値です。

ここでデフォルトのサイトIDの値を指定しない場合は、ホスト名にリクエストを行うたびに、クエリパラメータまたは本文にサイトIDを指定する必要があります。
「 Create」をクリックします。ホスト名が作成され、Hostname recordsダイアログがポップアップ表示されます。

エッジプラットフォームAPI

Sitecore Cloud Portal組織にログインし、メニューバーの右上隅にあるプロファイル > API tokensをクリックして、Bearer tokenをコピーします。

カスタムホスト名の作成APIエンドポイントを使用して、https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnamesへのPOSTリクエストを行います。

名前	形容	例
hostname	作成するカスタムホスト名。ワイルドカードとapexドメインはサポートされていません。	example.site.com
defaultContextId	カスタムホスト名に関連付けられたデフォルトのコンテキストID 。ここでデフォルトのコンテキストIDの値を指定しない場合は、ホスト名にリクエストを行うたびに、クエリパラメータまたはヘッダーにコンテキストIDを指定する必要があります。	4N1c0nt3xtjDksn997CRp9T
defaultSiteId	このホスト名にアタッチするサイトの名前。サイトIDは、デプロイアプリの開発者設定タブのSITECORE_SITE_NAME変数の値です。ここでデフォルトのサイトIDの値を指定しない場合は、ホスト名にリクエストを行うたびに、クエリパラメータまたは本文にサイトIDを指定する必要があります。	exampleSitecoreSite

名前

形容

例

hostname

作成するカスタムホスト名。ワイルドカードとapexドメインはサポートされていません。

example.site.com

defaultContextId

カスタムホスト名に関連付けられたデフォルトのコンテキストID 。

ここでデフォルトのコンテキストIDの値を指定しない場合は、ホスト名にリクエストを行うたびに、クエリパラメータまたはヘッダーにコンテキストIDを指定する必要があります。

4N1c0nt3xtjDksn997CRp9T

defaultSiteId

このホスト名にアタッチするサイトの名前。サイトIDは、デプロイアプリの開発者設定タブのSITECORE_SITE_NAME変数の値です。

ここでデフォルトのサイトIDの値を指定しない場合は、ホスト名にリクエストを行うたびに、クエリパラメータまたは本文にサイトIDを指定する必要があります。

exampleSitecoreSite

リクエストの例:

curl --location 'https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_BEARER_TOKEN>' \
--data '{
  "hostname": "example.site.com",
  "defaultSiteId": "exampleSitecoreSite",
  "defaultContextId": "4N1NYjlsn100VAsCNrRp9T"
}'

応答の例:

{
    "id": "9f848e0f-e12a-4e93-9989-0ff368033bb",
    "defaultContextId": "4N1NYjlsn100VAsCNrRp9T",
    "defaultSiteId": "exampleSitecoreSite",
    "hostname": "example.site.com",
    "ssl": {
        "method": "txt",
        "status": "pending_validation",
        "validation_errors": [],
        "validation_records": [
            {
                "txt_name": "_acme-challenge.example.site.com",
                "txt_value": "2_hWDRQIToMYxecCennD1WXLdhiou1cHV0meL0jUI"
            }
        ]
    },
    "ownership_verification": {
        "name": "_cf-custom-hostname.example.site.com",
        "type": "txt",
        "value": "45550fdb-1123-4b87-9ec8-htr1e2e3a39"
    },
    "created_at": "2069-09-03T14:26:51.518323Z",
    "status": "pending"
}

応答をコピーして保存します。これは、ドメインのDNSレコードにCNAMEレコードとTXTレコードを追加するために必要になります。

CNAMEレコードとTXTレコードをドメインのDNSレコードに追加する

ホスト名の検証とドメインの利用権確認(DCV)を行うには、ドメインのDNSレコードにTXTレコードを追加する必要があります。また、カスタムホスト名をSitecoreプロキシに関連付けるために、CNAMEレコードを追加する必要があります。

DNSレコードを追加する方法は、ドメインホストによって異なります。

一般に、DNSレコードを追加するには、次のようにします。

Sitecore Cloud Portal

ドメインの購入に使用したアカウントでドメインレジストラーにサインインします。
ドメインのTXTレコードとCNAMEレコードを更新できるセクションに移動します。これは通常、DNS設定、DNS管理、または詳細設定と呼ばれます。
ホスト名の検証では、Hostname recordsダイアログのTXT Hostname validationセクションの情報を使用してTXTレコードを追加します。ダイアログを閉じた場合は、Custom hostnamesページでAdd recordsをクリックします。
SSL検証の場合は、TXT SSL validationセクションの情報を使用してTXTレコードを追加します。
CNAMEセクションの情報を使用してCNAMEレコードを追加します。

いくつかの例については、多くの一般的なドメインレジストラーに関するGoogleのカスタム手順をご覧ください。

エッジプラットフォームAPI

ドメインの購入に使用したアカウントでドメインレジストラーにサインインします。
ドメインのTXTレコードとCNAMEレコードを更新できるセクションに移動します。これは通常、DNS設定、DNS管理、または詳細設定と呼ばれます。
ホスト名の検証では、前に生成した応答から次の情報を含むTXTレコードを追加します。
- Name - ownership_verification.nameの値 (apexドメインは含まれません)。たとえば、値が _acme-challenge.example.site.comの場合は、値として _acme-challenge.exampleを使用します。
- Value - ownership_verification.valueの値。
DCVの場合は、次の内容を含むTXTレコードを追加します。
- Name - ssl.validation_records.txt_nameの値 (apexドメインは含まれません)。
- Value - ssl.validation_records.txt_valueの値。
次の内容でCNAMEレコードを追加します。
- Name - hostnameの値。
- Target - sitecoreproxy.io

いくつかの例については、多くの一般的なドメインレジストラーに関するGoogleのカスタム手順をご覧ください。

カスタムホスト名のステータスを確認する

必要なDNSレコードをドメインレジストラに追加した後、通常、ホスト名は10分以内にアクティブになります。

カスタムホスト名のステータスを確認するには:

エッジプラットフォームAPI

GETリクエストを https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/<your-custom-hostname>

curl --location 'https://edge-platform-admin-api.sitecorecloud.io/api/admin/v1/hostnames/example.site.com' \
--header 'Authorization: Bearer <YOUR_BEARER_TOKEN>'

応答で、statusの値がactiveかどうかを確認します。これは、ホスト名を使用する準備ができていることを意味します。

カスタムホスト名を追加した後、それを使用してトラフィックを特定のSitecoreサービスにルーティングできます。

この記事を改善するための提案がある場合は、お知らせください!