Integration overview and prerequisites

この情報では、Adobe I/OとPlaces Serviceの統合を作成する方法を示します。

ユーザーアクセスの前提条件

組織のシステム管理者に、次のタスクが完了していることを確認します。

  • コアサービスを組織の管理コンソールに配置します。

  • 組織に追加されました。

  • 組織のPlacesコアサービスにユーザーとして追加されました。

    詳しくは、「Places Serviceへのア クセス権を取得する」の「Places Service and Experience Platform Launchプロファイルへのユーザーまたは開発者の追加を参照してください

  • 組織のPlacesコアサービスに開発者として追加されました。

    開発者の追加について詳しくは、「Places Serviceへのアクセス権を取得する」の「Places Service とExperience Platform Launchのプロファイルにユーザーまたは開発者を追加を参照してください

    開発者ロールについて詳しくは、開発者の管理を参照 してください

REST APIリクエスト

Places Service REST APIへの各リクエストには、次の項目が必要です。

  • 組織ID
  • APIキー
  • ベアラトークン

Adobe I/Oとの統合により、これらの項目と、JSON Web Token(JWT)を使用してベアラトークンをリクエストする方法が提供されます。

重要

Adobe I/Oコンソールにログインできない場合、または統合を作成ページの「Places Service」オプションが選択されていない場合は WebサービスAPIの概要で 「組織の要件 」を参照してください

Placesサービス統合の作成

Places Service統合を作成するには、次のタスクを実行します。

公開鍵と秘密鍵のペアを生成する

Places Serviceの統合を作成するには、公開鍵と秘密鍵のペアが必要です。 これらのペアは購入することも、独自の自己署名キーを生成することもできます。

独自の自己署名キーを生成するには:

  1. ターミナルウィンドウで、次の各行をコピーして貼り付け、各行を貼り付け Enter​た後にを押します。

       mkdir keys
       cd keys
       openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout places_integration_test_private.key -out    places_integration_test_public.crt
    
    重要

    キーを参照しやすいように名前を付けて、フォルダーに保存することをお勧めします。 複数の統合を作成する場合、どのキーがどの統合に属するかを簡単に識別し、管理できます。

  2. OpenSSLから要求された情報を入力します。

    Country Name (2 letter code:  // Example: US
    State or Province Name (full name):  // Example: California
    Locality Name (eg, city):  // Example: San Jose
    Organization Name (eg, company):  // Example: Places
    Organizational Unit Name (eg, section):  // Example: Engineering
    Common Name (eg, fully qualified host name):  // Example: places.com
    Email Address:  // Example:  poi@places.com
    

    OpenSSLについて詳しくは、OpenSSLを参照してく ださい

    重要

    指定した情報は、キーに組み込まれます。

  3. とファイルが存在するディレク .key トリ .crt に移動します。

    例えば、MacOSの場合は、/ Macintosh HD​に移​users 動し (your user name)​ます​Keys

次のビデオでは、キーペアの生成プロセスを示します。

統合ビデオ

Adobe I/OコンソールでのPlaces Service統合の作成

Places Serviceの統合を作成するには:

  1. https://console.adobe.ioに移動 、Adobe IDでサインインします。

  2. 「クイックス タート 」セクションで、「統合を作成」を クリックします

  3. を選択し、 Access an API​をクリックしま​Continue​す。

    Access an API​がデフォルトの場所です。

  4. 複数のExperience cloud組織にアクセスできる場合は、右上のドロップダウンリストから組織を選択します。

  5. Under Experience Cloud, select​Places Service as the Adobe service to which you want to integrate and click Continue.

  6. を選択し、 New integration​をクリックしま​Continue​す。

  7. 新しい統合を作成画面で、名前と説明を入力します。

  8. 上で作成したフ xxxx_public.crt ァイルをドロップゾーンにドラッグ&ドロ Public keys certificates​ップします。

  9. 製品プロファイルを選択します。

    選択するプロファイルが不明な場合は、システム管理者に問い合わせてください。

  10. At the bottom of the page, click Create integration.

  11. 数秒後、統合の作成画面で ** 、次のメッセージが表示されることを確認します。

    Your integration has been created.

  12. 統合の詳細ページが上部に統合の名前と共に表示されます。

    このタ Overview​ブはデフォルトで表示され、APIキー、組織ID、テクニカルアカウントID、および統合に関するその他の詳細が表示されます。

組織IDとAPIキーを記録します

  1. 統合の詳細ページで、タブをクリックし Services​て、がに表示されるこ​Places Service とを確認しま Configured Services​す。

  2. タブで、API Overview​キー(クライアントID)と組織IDを探して記録します。

    これらのIDは、各Places Service REST APIリクエストに必要です。

JWTトークンの生成

統合の詳細ページで、タブをクリック JWT​し、JWTを生成して交換URLを指定することで統合をテストできるようにします。

JWTトークンを生成するには:

  1. テキストエディターで、上で作成し private.key たファイルを開きます。

  2. On the JWT​tab, copy the contents of the key and paste it in the​Paste private key field.

  3. Generate JWT​をクリックします。

  4. In the Sample CURL command​section, click​Copy and paste the contents in your command prompt or terminal window.

  5. キーボードを押して、コマ Enter​ンドを実行します。

  6. との値 "token_type": "bearer" を探し "access_token" ます。

    bearerアクセストークンの値は、Places Service APIリクエストで使用するものです。

重要

アドビのアクセストークン 24時間のみ有効なので、サンプルのCURLコマンド(手順5)を保存します。 アクセストークンが無効になった場合は、トークンを再生成する必要があります。

このページ