ウォークスルー:ローカル開発環境でのDAMコネクタの有効化

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

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

Sitecoreデジタル資産管理(DAM)をDockerコンテナ上で動作するローカルSitecoreAI開発環境で使用するには、DAMコネクタの設定と有効化が必要です。

このウォークスルーでは、以下の方法を説明します:

DAM接続の設定
DAMコネクタの設定と有効化
DAM用のCORS設定

前提条件

DAMコネクタを有効にする前に、以下の条件を満たす必要があります:

DAM接続の設定

大事な

コンテンツセキュリティポリシー(CSP)を持っていない場合は、クロスサイトスクリプト(XSS)やデータインジェクション攻撃を防ぐために作成することを強くお勧めします。すでにCSPを持っている場合は、関連するContent HubインスタンスURLを追加する必要があります。

DAM接続の設定とCSPの追加:

SitecoreAI環境にリンクされたソース管理リポジトリをクローンしてください。
SitecoreAIリポジトリフォルダ内に、以下のサブフォルダを作成します。
{Project Repo Name}/src/platform/App_Data/Xdts

XdtsサブフォルダOpen、Web.config.xdtという名前のファイルを作成し、編集のために開いてください。以下のコードを追加し、value属性値にCSPを追加します:

<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
    <location path="sitecore">
        <system.webServer>
            <httpProtocol>
                <customHeaders>	                            
                    <add xdt:Transform="SetAttributes" xdt:Locator="Match(name)" name="Content-Security-Policy" value="{Add your content security policy here}"/>
                </customHeaders>
            </httpProtocol>
        </system.webServer>
    </location>
</configuration>

Content-Security-PolicyタグにContent HubインスタンスのURL(例:content-hub-url.stylelabs.com)、他の配信ホスト名(例:content-hub-url-delivery.stylelabs.cloud)、生成された公開リンク(例:content-hub-url.stylelabs.com:8686)が含まれていることを確認してください。

注記

Content Hubでは、AssetExtensionDataConfigurationSetting設定を使ってパブリックリンクごとに異なる配信ホスト名を設定できます。

異なるホスト名を設定している場合は、img-src、child-src、connect-srcプロパティのContent-Security-Policyパラメータにすべてのホスト名をソースとして追加する必要があります。

ファイルを保存してください。
XDT変換をベース画像に適用してください。詳細については、配置変換の適用を参照してください。

DAMコネクタの設定と有効化

DAMコネクターはInsert from Sitecore DAMアイテムをRich Text EditorのRich Textデフォルトプロファイルに追加します。インサート機能を有効にするには、Sitecore DAMへの接続を設定する必要があります。

DAMコネクタの設定と有効化:

Githubで、Sitecore Cloud Portalで作成したプロジェクトリポジトリをクローンします。

SitecoreAIリポジトリフォルダで.envファイルを開き、以下の変数を追加します。

Variable	価値	概要
Sitecore_DAM_ContentHub	ClientId={client_id};ClientSecret={client_secret};UserName={username};Password={password};URI={uri}; 例: Sitecore_DAM_ContentHub=ClientId=App;ClientSecret=a51a8fb6-4f57-1234;UserName=john;Password=hunter2;URI=https://example.com/;	コネクターのOAuthクライアントのClient IDとClient Secret 。 Content Hubで作成したユーザーのusernameとpasswordです。 uriあなたのContent Hubインスタンスのことです。
Sitecore_DAM_SearchPage	Sitecore Content Hub search page URI 例: Sitecore_DAM_SearchPage=https://sitecore-contenthub-dam-uri/en-us/sitecore-dam-connect/approved-assets	IFrameでDAMを開くページのURIです。
Sitecore_DAM_ExternalRedirectKey	Sitecore
SITECORE_DAM_ENABLED	yes	デフォルトでは、DAMコネクタは無効化されています。コネクタを有効にするには、この値をyesに設定してください。

docker-compose.override.ymlファイルをOpenし、services > cm > environment属性に以下のキー-値ペアを追加します。

Sitecore_ConnectionStrings_DAM_dot_ContentHub: ${Sitecore_DAM_ContentHub}
Sitecore_ConnectionStrings_DAM_dot_SearchPage: ${Sitecore_DAM_SearchPage}
Sitecore_ConnectionStrings_DAM_dot_ExternalRedirectKey: ${Sitecore_DAM_ExternalRedirectKey}
SITECORE_AppSettings_damEnabled__define: ${SITECORE_DAM_ENABLED}

リポジトリフォルダでWindowsコンソールを開き、次のコマンドを実行します:
docker compose up -d
注記

ローカル環境の設定に関する情報は「Full Stack SitecoreAI local development environmentの設定」をご覧ください

DAM用のCORS設定

Content Hub DAMのiframeをContent EditorおよびPage Builderのメディアアイテムピッカーで正常表示できるようにするには、Content Hub CORS設定にPagesおよび環境のホスト名URLを追加する必要があります。

DAM用のCORSを設定するには:

Sitecore DAMメインメニューでManageをクリックし、Settings。
Settingsページで「PortalConfiguration」をクリックし、次にCORSConfigurationをクリックします。
URL欄にページビルダーのURLを入力してください:https://pages.sitecorecloud.io/、そしてAddをクリックします。
URL欄でhttps://を入力し、次にローカル環境のホスト名を入力します。例えば、https://xmcloudcm.localhost/、Addをクリックします。

XM Cloudは現在SitecoreAIとなっています

一部のコード例、画像、UIラベルは、エンジニアリング資産の更新中もXM Cloudを使用している場合があります。

DAMアセットをContent Editorで表示できるようになりました。

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