셀프서비스 소스에 대한 인증 사양 구성(일괄 SDK)

마지막 업데이트: 2025년 4월 4일
  • 주제:

작성 대상:

  • 개발자

인증 사양은 Adobe Experience Platform 사용자가 소스에 연결하는 방법을 정의합니다.

authSpec 배열에는 원본을 Experience Platform에 연결하는 데 필요한 인증 매개 변수에 대한 정보가 포함되어 있습니다. 지정된 모든 소스는 서로 다른 여러 유형의 인증을 지원할 수 있습니다.

인증 사양

셀프 서비스 소스(일괄 SDK)는 OAuth 2 새로 고침 코드 및 기본 인증을 지원합니다. OAuth 2 새로 고침 코드 및 기본 인증 사용에 대한 지침은 아래 표를 참조하십시오

OAuth 2 새로 고침 코드

OAuth 2 새로 고침 코드는 임시 액세스 토큰 및 새로 고침 토큰을 생성하여 애플리케이션에 안전하게 액세스할 수 있도록 합니다. 액세스 토큰을 사용하면 다른 자격 증명을 제공할 필요 없이 리소스에 안전하게 액세스할 수 있으며, 새로 고침 토큰을 사용하면 액세스 토큰이 만료되면 새 액세스 토큰을 생성할 수 있습니다.

OAuth 2 새로 고침 코드의 보기 예
{
  "name": "OAuth2 Refresh Code",
  "type": "OAuth2RefreshCode",
  "spec": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "description": "Define auth params required for connecting to generic rest using oauth2 authorization code.",
    "properties": {
      "authorizationTestUrl": {
        "description": "Authorization test url to validate accessToken.",
        "type": "string"
      },
      "clientId": {
        "description": "Client id of user account.",
        "type": "string"
      },
      "clientSecret": {
        "description": "Client secret of user account.",
        "type": "string",
        "format": "password"
      },
      "accessToken": {
        "description": "Access Token",
        "type": "string",
        "format": "password"
      },
      "refreshToken": {
        "description": "Refresh Token",
        "type": "string",
        "format": "password"
      },
      "expirationDate": {
        "description": "Date of token expiry.",
        "type": "string",
        "format": "date",
        "uiAttributes": {
          "hidden": true
        }
      },
      "accessTokenUrl": {
        "description": "Access token url to fetch access token.",
        "type": "string"
      },
      "requestParameterOverride": {
        "type": "object",
        "description": "Specify parameter to override.",
        "properties": {
          "accessTokenField": {
            "description": "Access token field name to override.",
            "type": "string"
          },
          "refreshTokenField": {
            "description": "Refresh token field name to override.",
            "type": "string"
          },
          "expireInField": {
            "description": "ExpireIn field name to override.",
            "type": "string"
          },
          "authenticationMethod": {
            "description": "Authentication method override.",
            "type": "string",
            "enum": [
              "GET",
              "POST"
            ]
          },
          "clientId": {
            "description": "ClientId field name override.",
            "type": "string"
          },
          "clientSecret": {
            "description": "ClientSecret field name override.",
            "type": "string"
          }
        }
      }
    },
    "required": [
      "accessToken"
    ]
  }
}
속성설명예
authSpec.name지원되는 인증 유형의 이름을 표시합니다.oAuth2-refresh-code
authSpec.type소스에서 지원하는 인증 유형을 정의합니다.oAuth2-refresh-code
authSpec.spec인증의 스키마, 데이터 유형 및 속성에 대한 정보를 포함합니다.
authSpec.spec.$schema인증에 사용되는 스키마를 정의합니다.http://json-schema.org/draft-07/schema#
authSpec.spec.type스키마의 데이터 유형을 정의합니다.object
authSpec.spec.properties인증에 사용되는 자격 증명에 대한 정보를 포함합니다.
authSpec.spec.properties.description자격 증명에 대한 간단한 설명을 표시합니다.
authSpec.spec.properties.type자격 증명의 데이터 유형을 정의합니다.string
authSpec.spec.properties.clientId응용 프로그램과 연결된 클라이언트 ID입니다. 클라이언트 ID는 액세스 토큰을 검색하기 위해 클라이언트 암호와 함께 사용됩니다.
authSpec.spec.properties.clientSecret응용 프로그램과 연결된 클라이언트 암호입니다. 클라이언트 암호는 액세스 토큰을 검색하기 위해 클라이언트 ID와 함께 사용됩니다.
authSpec.spec.properties.accessToken액세스 토큰은 애플리케이션에 대한 보안 액세스를 승인합니다.
authSpec.spec.properties.refreshToken새로 고침 토큰은 액세스 토큰이 만료될 때 새 액세스 토큰을 생성하는 데 사용됩니다.
authSpec.spec.properties.expirationDate액세스 토큰의 만료 날짜를 정의합니다.
authSpec.spec.properties.refreshTokenUrl새로 고침 토큰을 검색하는 데 사용되는 URL입니다.
authSpec.spec.properties.accessTokenUrl새로 고침 토큰을 검색하는 데 사용되는 URL입니다.
authSpec.spec.properties.requestParameterOverride인증 시 재정의할 자격 증명 매개 변수를 지정할 수 있습니다.
authSpec.spec.required인증에 필요한 자격 증명을 표시합니다.accessToken