Show Menu
トピック×

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の概要で 「組織の要件 」を参照してください Web Services 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)を保存します。 アクセストークンが無効になった場合は、トークンを再生成する必要があります。