자격 증명 구성 만들기

중요

API 엔드포인트: platform.adobe.io/data/core/activation/authoring/credentials

이 페이지는 를 사용하여 자격 증명 구성을 만드는 데 사용할 수 있는 API 요청 및 페이로드를 예시합니다. /authoring/credentials API 엔드포인트.

사용 시기 /credentials API 엔드포인트

중요

대부분의 경우 금지 을(를) 사용해야 함 /credentials API 엔드포인트. 대신 를 통해 대상에 대한 인증 정보를 구성할 수 있습니다. customerAuthenticationConfigurations 매개 변수 /destinations 엔드포인트.

읽기 고객 인증 구성 를 참조하십시오.

이 API 끝점을 사용하여 Adobe과 대상 플랫폼 및 Platform 고객은 대상에 연결하기 위해 인증 자격 증명을 제공할 필요가 없습니다. 이 경우 다음을 사용하여 자격 증명 구성을 만들어야 합니다. /credentials API 엔드포인트.

글로벌 인증 시스템을 사용하는 경우 다음을 설정해야 합니다. "authenticationRule":"PLATFORM_AUTHENTICATION" 다음에서 대상 게재 구성, 시기 새 대상 구성 만들기.

중요

Destination SDK에서 지원하는 모든 매개변수 이름 및 값은 다음과 같습니다. 대소문자 구분. 대소문자 구분 오류를 방지하려면 설명서에 표시된 대로 매개 변수 이름과 값을 정확히 사용하십시오.

자격 증명 API 작업 시작

계속하기 전에 다음을 검토하십시오. 시작 안내서 필수 대상 작성 권한 및 필수 헤더를 가져오는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보입니다.

자격 증명 구성 만들기

다음을 수행하여 새 자격 증명 구성을 만들 수 있습니다. POST 에 대한 요청 /authoring/credentials 엔드포인트.

API 형식

POST /authoring/credentials

다음 요청은 페이로드에 제공된 매개 변수에 의해 정의된 새 자격 증명 구성을 만듭니다.

아래에서 각 탭을 선택하여 해당 페이로드를 확인합니다.

기본 자격 증명 구성 만들기

 요청
curl -X POST https://platform.adobe.io/data/core/activation/authoring/credentials \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
    "basicAuthentication":{
      "url":"string",
      "username":"string",
      "password":"string"
   }
}
매개변수 유형 설명
url 문자열 인증 공급자의 URL
username 문자열 자격 증명 구성 로그인 사용자 이름
password 문자열 자격 증명 구성 로그인 암호
 응답

성공한 응답은 새로 만든 자격 증명 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다.

만들기 Amazon S3 자격 증명 구성

 요청
curl -X POST https://platform.adobe.io/data/core/activation/authoring/credentials \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "s3Authentication":{
      "accessId":"string",
      "secretKey":"string"
   }
}
매개변수 유형 설명
accessId 문자열 Amazon S3 액세스 ID
secretKey 문자열 Amazon S3 비밀 키
 응답

성공한 응답은 새로 만든 자격 증명 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다.

SSH 자격 증명 구성 만들기

 요청
curl -X POST https://platform.adobe.io/data/core/activation/authoring/credentials \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
    "sshAuthentication":{
      "username":"string",
      "sshKey":"string"
   }
}
매개변수 유형 설명
username 문자열 자격 증명 구성 로그인 사용자 이름
sshKey 문자열 SSH 인증을 사용하는 SFTP용 SSH 키
 응답

성공한 응답은 새로 만든 자격 증명 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다.

만들기 Azure Data Lake Storage 자격 증명 구성

 요청
curl -X POST https://platform.adobe.io/data/core/activation/authoring/credentials \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
    "azureAuthentication":{
      "url":"string",
      "tenant":"string",
      "servicePrincipalId":"string",
      "servicePrincipalKey":"string"
   }
}
매개변수 유형 설명
url 문자열 인증 공급자의 URL
tenant 문자열 Azure Data Lake 저장소 테넌트
servicePrincipalId 문자열 Azure 데이터 레이크 스토리지에 대한 Azure 서비스 사용자 ID
servicePrincipalKey 문자열 Azure 데이터 레이크 스토리지에 대한 Azure 서비스 사용자 키
 응답

성공한 응답은 새로 만든 자격 증명 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다.

만들기 Azure Blob Storage 자격 증명 구성

 요청
curl -X POST https://platform.adobe.io/data/core/activation/authoring/credentials \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
    "azureConnectionStringAuthentication":{
      "connectionString":"string"
   }
}
매개변수 유형 설명
connectionString 문자열 Azure Blob Storage 연결 문자열
 응답

성공한 응답은 새로 만든 자격 증명 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다.

API 오류 처리

Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 을(를) 참조하십시오 API 상태 코드 및 요청 헤더 오류 플랫폼 문제 해결 안내서에서 확인할 수 있습니다.

다음 단계

이 문서를 읽고 나면 이제 자격 증명 끝점을 사용할 시점과 를 사용하여 자격 증명 구성을 설정하는 방법을 알 수 있습니다. /authoring/credentials API 끝점 읽기 Destination SDK을 사용하여 대상을 구성하는 방법 대상을 구성하는 프로세스에 이 단계가 어디에 적합한지 이해할 수 있습니다.

이 페이지에서는