統合の概要と前提条件

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

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

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

Places コアサービスが組織の Admin Console に表示されます。
組織に追加されました。
組織の Places コアサービスにユーザーとして追加されている。

詳しくは、 Places サービスと開発者プロファイルへのExperience Platform Launchまたは開発者の追加 in Places Service へのアクセス権を取得.
組織の Places コアサービスに開発者として追加されている。

開発者の追加について詳しくは、 Places サービスと開発者プロファイルへのExperience Platform Launchまたは開発者の追加 in Places Service へのアクセス権を取得.

開発者の役割について詳しくは、開発者の管理.

REST API リクエスト

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

組織 ID
API キー
bearer トークン

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

JWT について詳しくは、 JSON Web トークンの概要.
Places Service の統合を作成するには、 Places Service 統合の作成 」の節を参照してください。
API キーの統合、JWT および公開鍵証明書の生成について詳しくは、 Adobe I/O認証の概要.

重要

Adobe I/Oコンソールにログインできない場合、または 統合を作成ページを参照してください。 組織の要件 in Web サービス API の概要.

Places サービス統合の作成

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

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

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

独自の自己署名付きキーを生成するには：

ターミナルウィンドウで、次の各行をコピーして貼り付け、を押します。入力各行を貼り付けた後：
```
   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
```
重要

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

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.

重要

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

を含むディレクトリに移動します。 .key および .crt ファイルが見つかります。

例えば、MacOSで、 Macintosh HD > ユーザー > （ユーザー名） > キー.

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

統合ビデオ

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

Places Service 統合を作成するには、次の手順を実行します。

に移動します。 https://console.adobe.io をクリックし、Adobe IDでログインします。
内 クイックスタート セクションで、 統合の作成.
「API にアクセス」を選択し、「続行」をクリックします。

API へのアクセス はデフォルトの場所です。
複数の組織にアクセスできる場合は、右上のExperience Cloudドロップダウンリストから組織を選択します。
の下 Experience Cloudを選択します。 Places Service を統合するAdobe サービスとして選択し、続行.
選択 新しい統合 をクリックし、続行.
「新しい統合を作成」画面で、名前と説明を入力します。
をドラッグ&ドロップします。 xxxx_public.crt 上で作成したファイルを 公開鍵証明書 ドロップゾーン。
製品プロファイルの選択.

選択するプロファイルが不明な場合は、システム管理者に問い合わせてください。
ページの下部で、 統合の作成.
数秒後、 統合が作成されました 画面で、次のメッセージが表示されることを確認します。

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

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

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

統合の詳細ページで、 サービス タブで確認し、 Places Service が 構成済みサービス.
の概要タブで、API キー（クライアント ID）と組織 ID を探して記録します。

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

JWT トークンの生成

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

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

テキストエディターで、 private.key 上で作成したファイル。
「JWT」タブで、キーの内容をコピーし、「秘密鍵を貼り付け」フィールドに貼り付けます。
クリック JWT を生成.
「CURL コマンドの例」セクションで、「コピー」をクリックし、コマンドプロンプトまたはターミナルウィンドウに内容を貼り付けます。
を押して、コマンドを実行します。入力キーボードで
を "token_type": "bearer" そして "access_token" の値です。

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