[Alpha]{class="badge informative"}

`edgeCredentials` （Server SDK）

最終更新日： 2026年10月30日

トピック：
Data Collection

作成対象：

Developer

edgeCredentials オブジェクトには、Server SDKがAdobeでの認証に使用するOAuth Server-to-Server資格情報が含まれています。 SDKは、アクセストークンの資格情報を交換し、そのトークンを使用して、認証されたEdge Network Server APIにイベントを送信します。 このプロパティは必須です。 Web SDKでは、クライアントの秘密鍵を保持できないため、このプロパティは使用されません。

Adobe Developer Consoleで資格情報を作成する方法と、SDKで資格情報を使用する方法については、認証を参照してください。

プロパティ properties

プロパティ

タイプ

必須

説明

clientId

文字列

○

OAuth サーバー間の資格情報のクライアント ID。 SDKは、認証済みリクエストのx-api-key ヘッダーにも送信します。

clientSecret

文字列

○

資格情報のクライアント秘密鍵。

scopes

文字列の配列

はい

スコープがAdobe Developer Consoleの資格情報に一覧表示されます。少なくとも1つの範囲を含めます。

imsHost

文字列

アクセストークンを発行するAdobe Identity Management サービス（IMS）ホスト。デフォルト値は ims-na1.adobelogin.com です。 Adobeが指示した場合にのみ変更します。

コード例

configureを呼び出すときにedgeCredentials オブジェクトを設定します。ソースコードに配置する代わりに、環境変数またはシークレットマネージャーから値を読み取ります。

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  }
});

この例では、ADOBE_SCOPES環境変数には、Adobe Developer Consoleが資格情報に対して示す一覧など、スコープのコンマ区切りリストが格納されています。

検証とエラー errors

edgeCredentialsが見つからない場合、configureはSDKにedgeCredentialsが必要であることを示すエラーで拒否します。
clientId、clientSecret、またはscopesが見つからないか空の場合、configureは見つからないプロパティの名前を付けるエラーで拒否します。
configureは、資格情報が有効かどうかを確認しません。 SDKは、認証済みイベントを初めて送信したときに、アクセストークンをリクエストします。 Adobeが資格情報を拒否すると、メッセージにFailed to acquire an IMS access tokenが含まれるエラーが発生して、そのメソッドが拒否されます。

SDKは、デバッグログおよびgetLibraryInfoが返すコンフィギュレーションでclientSecretを[REDACTED]に置き換えます。

recommendation-more-help

experience-platform-help-collection

edgeCredentials （Server SDK）

プロパティ properties

コード例

検証とエラー errors

`edgeCredentials` （Server SDK）