1. 開発者向けのドキュメント

展開環境でDAMコネクタを有効にする SitecoreAI

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

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

SitecoreAIに展開された環境でSitecore DAMを使用するには、DAMコネクタを設定して有効化する必要があります。

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

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

  2. DAM接続の設定

  3. DAM用のCORS設定

前提条件

SitecoreAIに展開された環境でDAMコネクタを有効にする前に、以下の条件を満たす必要があります:

DeployアプリでDAMコネクタを設定し有効化します

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

  1. Deployアプリにログインしてください。

  2. DeployアプリのナビゲーションペインでProjectsをクリックします。

  3. Projectsページで、DAMコネクタを有効にしたい環境を含むプロジェクトをクリックします。

  4. プロジェクトページで、DAMコネクタを有効にしたい環境をクリックしてください。

  5. 環境ページで「 Variables」をクリックし、次に「 Create variable」をクリックします。

  6. 以下の変数を作成します。各変数について、ターゲットをCMに設定します。

    Variable

    価値

    概要

    Sitecore_ConnectionStrings_DAM_dot_ContentHub

    ClientId={client_id};ClientSecret={client_secret};UserName={username};Password={password};URI={uri};

    例: 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_ConnectionStrings_DAM_dot_SearchPage

    Sitecore Content Hub search page URI

    例: https://sitecore-contenthub-dam-uri/en-us/sitecore-dam-connect/approved-assets

    IFrameでDAMを開くページのURIです。

    Sitecore_ConnectionStrings_DAM_dot_ExternalRedirectKey

    Sitecore

    SITECORE_AppSettings_damEnabled__define

    yes

    デフォルトでは、環境をSitecoreAIにデプロイすると、DAMコネクターは無効化されます。コネクタを有効にするには、この値をyesに設定してください。

DAM接続の設定

大事な

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

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

  1. SitecoreAI環境にリンクされたソース管理リポジトリをクローンしてください。

  2. SitecoreAIリポジトリフォルダ内に、以下のサブフォルダを作成します:

    {Project Repo Name}/authoring/platform/App_Data/Xdts

  3. 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パラメータにすべてのホスト名をソースとして追加する必要があります。

  4. ファイルを保存してください。

  5. web.configファイル変換をSitecoreAIビルド設定に含めるには、ルートフォルダに移動し、xmcloud.build.jsonファイルを開いて編集してください。以下の特性を加えます:

    "transforms": [
    {
        "xdtPath": "/app_data/xdts/web.config.xdt",
        "targetPath": "/web.config"
    }
]
    XM Cloudは現在SitecoreAIとなっています

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

  6. authoring/platformフォルダでPlatform.csprojファイルを開き、以下を追加してください:

    <ItemGroup>
    <Content Include="App_Data\**" />
</ItemGroup>

  7. 変更をコミットしてリモートリポジトリにプッシュしてください。

  8. Deployアプリで ビルドを作成し、環境にデプロイします。

DAM用のCORS設定

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

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

  1. Sitecore DAMメインメニューでManageをクリックし、Settings。

  2. Settingsページで「PortalConfiguration」をクリックし、次にCORSConfigurationをクリックします。

  3. URL欄にページビルダーのURLを入力してください:https://pages.sitecorecloud.io/、そしてAddをクリックします。

  4. URL欄でhttps://を入力し、次にSitecoreAI環境のホスト名を入力します。例えば、https://my-xmc-environment-host-name.cloud/、そしてAddをクリックします。環境ホスト名は環境詳細で確認できます。

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

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

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

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