[Alpha]{class="badge informative"}

`edgeCredentials`(서버 SDK)

마지막 업데이트: 2026년 10월 30일

주제:
Data Collection

작성 대상:

Developer

edgeCredentials 개체에는 서버 SDK에서 Adobe을 인증하는 데 사용하는 OAuth 서버 간 자격 증명이 포함되어 있습니다. SDK은 액세스 토큰에 대한 자격 증명을 교환한 다음 토큰을 사용하여 인증된 Edge Network Server API로 이벤트를 전송합니다. 이 속성은 필수입니다. 브라우저는 클라이언트 암호를 비공개로 유지할 수 없기 때문에 웹 SDK은 이 속성을 사용하지 않습니다.

Adobe Developer Console에서 자격 증명을 만드는 방법과 SDK에서 자격 증명을 사용하는 방법을 알아보려면 인증을 참조하세요.

속성 properties

속성

유형

필수 여부

설명

clientId

문자열

예

OAuth 서버 간 자격 증명의 클라이언트 ID. SDK은 인증된 요청의 x-api-key 헤더에서도 보냅니다.

clientSecret

문자열

예

자격 증명의 클라이언트 암호.

scopes

문자열 배열

예

Adobe Developer Console에 자격 증명에 대해 나열된 범위입니다. 범위를 하나 이상 포함하십시오.

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(서버 SDK)

속성 properties

코드 예

유효성 검사 및 오류 errors

`edgeCredentials`(서버 SDK)