データシステムや分析モデルへの接続に名前を付けて認証する

リクエストを設定する前に、接続に名前を付け、認証方法を選択し、テストする必要があります。

接続に名前を付けて認証するには:

1. ナビゲーションメニューで「 開発者センター 」> 「Connections」をクリックしてください。

2. 接続画面で**「AIまたはデータシステム>作成**」をクリックします。

3. 「名前&説明」画面で、以下のフィールドに記入してください:

   • Name - データシステムまたは分析モデルの一意で直感的な名称を入力する。

     !警告名前にハイフンは使わないでください。決定モデルのバリアントを作成する際にプログラム可能な決定で接続を参照すると問題を引き起こす可能性があります。

   • Description - データシステムまたはモデルの簡潔な説明を入力する。

   • Icon - ユーザーがデータシステムや分析モデルを意思決定モデルのバリアントに追加した際に見られる、ドロップダウンリストからアイコンを選択すること。

4. 「次へ」をクリックします。認証画面が表示されます。

5. 認証画面で、以下のいずれかの認証方法を選択してください:

   • オース2:

     • アクセストークンURL - データシステムまたは分析モデルのアクセストークンのURLを入力します。アクセストークンはデータシステムまたは分析モデルプラットフォームによって生成されます。アクセストークンはhttps:// URLを使用しなければなりません。これにより安全な接続が確保されます。

     • Authentication option- 認証認証情報をヘッダー内のものに渡すにはヘッダーオプションを選択し、リクエストの本文に認証情報を渡すにはBodyオプションを選択する。

     • Client ID - データシステムまたは分析モデルプラットフォームのクライアントIDを入力。

     • Client Secret - データシステムまたは分析モデルプラットフォームのクライアント秘密を入力する。

     • Headers- オプションで「ヘッダー表示」をクリックし、最初のフィールドに鍵、2番目のフィールドに値を入力してください。追加のヘッダーを入力するには、「ヘッダーを追加」をクリックします。認証オプションでヘッダーを選択した場合、ここに認証パラメータと値を入力する必要があります。

     • URLエンコードフォーム - オプションで「 URLエンコードフォームを表示 」をクリックし、最初のフィールドにキー、2番目のフィールドに値を入力してください。追加項目を入力するには、「 フォームアイテムを追加」をクリックしてください。このオプションでは、キーや値を有効なURL形式に変換し、Sitecore Personalizeに送信できます。

     • Mutual TLSで設定 - クリックしてMutual Transport Layer Security(mTLS)を有効にしてください。これにより、Sitecore Personalizeと接続先がTLSプロトコルを使って互いに認証できます。

       Sitecore PersonalizeのmTLS JSON Web Key Set(JWKS)エンドポイントを見るには、 アイコンをクリックしてください。JWKSは、任意のJSON Web Tokens(JWT)を検証するために使われる公開鍵を含む鍵の集合体です。

   • 基本:

     • ユーザー名 - データシステムや分析モデルプラットフォームへの認証用ユーザー名を入力してください。
     • パスワード - データシステムや分析モデルプラットフォームへの認証認証用のパスワードを入力します。

   • None - これは公開APIにのみ使用され、データシステムや分析モデルプラットフォームへの接続には推奨されません。

6. テスト **認証をクリックします。**テスト結果は レスポンス ウィンドウに表示され、関連するステータスコードが表示されます。

   !ヒント認証エラーが出た場合は、前のステップで入力した認証情報を確認してください。

7. 「次へ」をクリックします。「リクエストの設定」画面が表示されます。

   リクエストの設定を続けなければ接続は保存されません。リクエストをGETメソッドで取得するか、POSTやPUTメソッドでデータを送信する設定が可能です。