この情報では、Adobe I/Oと Places Service の統合の作成方法を示します。
組織のシステム管理者に問い合わせて、次のタスクが完了していることを確認します。
Places コアサービスが組織の Admin Console に表示されます。
組織に追加されました。
組織の Places コアサービスにユーザーとして追加されている。
詳しくは、 Places サービスと開発者プロファイルへのExperience Platform Launchまたは開発者の追加 in Places Service へのアクセス権を取得.
組織の Places コアサービスに開発者として追加されている。
開発者の追加について詳しくは、 Places サービスと開発者プロファイルへのExperience Platform Launchまたは開発者の追加 in Places Service へのアクセス権を取得.
開発者の役割について詳しくは、 開発者の管理.
Places Service REST API への各リクエストには、次の項目が必要です。
Adobe I/Oとの統合により、これらの項目と、JSON Web トークン (JWT) を使用して bearer トークンをリクエストする方法が提供されます。
Adobe I/Oコンソールにログインできない場合、または 統合を作成ページを参照してください。 組織の要件 in Web サービス API の概要.
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 > ユーザー > (ユーザー名) > キー.
次のビデオでは、キーペアを生成するプロセスを説明します。
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、統合に関するその他の詳細が表示されます。
統合の詳細ページで、 サービス タブで確認し、 Places Service が 構成済みサービス.
の 概要 タブで、API キー(クライアント ID)と組織 ID を探して記録します。
これらの ID は、Places Service REST API リクエストごとに必要です。
統合の詳細ページで、 JWT 」タブをクリックし、JWT を生成して exchange URL を指定することで統合をテストできるようにします。
JWT トークンを生成するには:
テキストエディターで、 private.key
上で作成したファイル。
「JWT」タブで、キーの内容をコピーし、「秘密鍵を貼り付け」フィールドに貼り付けます。
クリック JWT を生成.
「CURL コマンドの例」セクションで、「コピー」をクリックし、コマンドプロンプトまたはターミナルウィンドウに内容を貼り付けます。
を押して、コマンドを実行します。 入力 キーボードで
を "token_type": "bearer"
そして "access_token"
の値です。
bearer アクセストークンの値は、Places Service API リクエストで使用する値です。
Adobeアクセストークンが有効です のみ 24 時間の場合は、サンプルの CURL コマンド(手順 5)を保存します。 アクセストークンが無効になった場合は、トークンを再生成する必要があります。