자격 증명 안내서

Adobe Experience Platform 쿼리 서비스를 통해 외부 클라이언트와 연결할 수 있습니다. 만료 자격 증명 또는 만료되지 않은 자격 증명을 사용하여 이러한 외부 클라이언트에 연결할 수 있습니다.

만료 자격 증명

만료 자격 증명을 사용하여 외부 클라이언트에 대한 연결을 빠르게 설정할 수 있습니다.

만료 자격 증명 섹션에서는 다음 정보를 제공합니다.

  • 호스트: 연결할 호스트의 이름입니다. 쿼리 서비스에 연결하려면 현재 사용 중인 IMS 조직의 이름이 포함됩니다.
  • 포트: 연결할 호스트의 포트 번호입니다.
  • 데이터베이스: 연결할 데이터베이스의 이름입니다.
  • 사용자 이름: Query Service에 연결하는 데 사용할 사용자 이름입니다.
  • 암호: Query Service에 연결하는 데 사용할 암호입니다.
  • PSQL 명령: 명령줄에서 PSQL을 사용하여 Query Service에 연결할 관련 정보를 모두 자동으로 삽입한 명령입니다.
  • 만료: 만료 자격 증명에 대한 만료 날짜입니다. 자격 증명은 생성된 후 24시간 후에 만료됩니다.

만료되지 않은 자격 증명

만료되지 않은 자격 증명을 사용하여 외부 클라이언트에 보다 영구적인 연결을 설정할 수 있습니다.

전제 조건

만료되지 않은 자격 증명을 생성하려면 먼저 Adobe Admin Console에서 다음 단계를 완료해야 합니다.

  1. Adobe Admin Console에 로그인하고 위쪽 탐색 모음에서 관련 조직을 선택합니다.
  2. 제품 프로필을 선택합니다.
  3. 제품 프로필에 ​대한 Sandboxes 및 Manage Query Service IntegrationPermissions를 모두 구성합니다.
  4. 구성된 권한이 부여되도록 새 사용자를 제품 프로필에 추가합니다.
  5. 사용자를 제품 프로필 관리자 로 추가하여 활성 제품 프로필에 대해 계정을 만들 수 있습니다.
  6. 통합을 만들려면 사용자를 제품 프로필 개발자로 추가합니다.

권한을 할당하는 방법에 대한 자세한 내용은 access control에서 설명서를 참조하십시오.

이제 사용자가 만료 자격 증명 기능을 사용할 수 있도록 필요한 모든 권한이 Adobe 개발자 콘솔에 구성됩니다.

자격 증명 생성

만료되지 않은 자격 증명 세트를 만들려면 Platform UI로 돌아가서 왼쪽 탐색에서 쿼리​를 선택하여 쿼리 작업 영역에 액세스합니다. 다음으로 자격 증명 탭 다음에 자격 증명 생성​을 선택합니다.

자격 증명을 생성할 수 있는 대화 상자가 나타납니다. 만료되지 않은 자격 증명을 만들려면 다음 세부 정보를 제공해야 합니다.

  • 이름: 생성 중인 자격 증명의 이름입니다.
  • 설명: (선택 사항) 생성 중인 자격 증명에 대한 설명입니다.
  • ​에 할당됨: 자격 증명을 할당할 사용자입니다. 이 값은 자격 증명을 만드는 사용자의 이메일 주소여야 합니다.
  • 암호 (선택 사항) 자격 증명을 위한 선택적 암호입니다. 암호를 설정하지 않으면 Adobe에서 자동으로 암호를 생성합니다.

필요한 세부 정보를 모두 제공했으면 자격 증명 생성​을 선택하여 자격 증명을 생성합니다.

중요

자격 증명 생성 단추를 선택하면 구성 JSON 파일이 로컬 시스템에 다운로드됩니다. Adobe은 생성된 자격 증명을 기록하지 하지 않으므로 다운로드한 파일을 안전하게 저장하고 자격 증명 레코드를 유지해야 합니다.

또한 자격 증명이 90일 동안 사용되지 않으면 자격 증명이 만료됩니다.

구성 JSON 파일에는 기술 계정 이름, 기술 계정 ID 및 자격 증명과 같은 정보가 포함되어 있습니다. 다음 형식으로 제공됩니다.

{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}

생성된 자격 증명을 저장한 후 닫기​를 선택합니다. 이제 만료되지 않은 자격 증명 목록을 볼 수 있습니다.

만료되지 않은 자격 증명을 편집하거나 삭제할 수 있습니다. 만료되지 않은 자격 증명을 편집하려면 연필 아이콘()을 선택합니다. 만료되지 않은 자격 증명을 삭제하려면 삭제 아이콘()을 선택합니다.

만료되지 않은 자격 증명을 편집할 때 모달이 나타납니다. 업데이트할 다음 세부 정보를 제공할 수 있습니다.

  • 이름: 생성 중인 자격 증명의 이름입니다.
  • 설명: (선택 사항) 생성 중인 자격 증명에 대한 설명입니다.
  • ​에 할당됨: 자격 증명을 할당할 사용자입니다. 이 값은 자격 증명을 만드는 사용자의 이메일 주소여야 합니다.

필요한 세부 정보를 모두 제공했으면 계정 업데이트​를 선택하여 자격 증명에 대한 업데이트를 완료합니다.

자격 증명을 사용하여 외부 클라이언트에 연결

만료되거나 만료되지 않은 자격 증명을 사용하여 Aqua Data Studio, Looker 또는 Power BI과 같은 외부 클라이언트와 연결할 수 있습니다. 이러한 자격 증명에 대한 입력 방법은 외부 클라이언트에 따라 달라집니다. 이러한 자격 증명 사용에 대한 특정 지침은 외부 클라이언트의 설명서를 참조하십시오.

이 이미지는 만료되지 않은 자격 증명의 암호를 제외하고 UI에 있는 각 매개 변수의 위치를 나타냅니다. 만료되지 않은 자격 증명은 JSON 구성 파일에서 제공되지만, UI의 자격 증명 탭에서 만료되는 자격 증명을 볼 수 있습니다.

아래 표에서는 외부 클라이언트에 연결하는 데 일반적으로 필요한 매개 변수를 간략하게 설명합니다.

노트

만료되지 않은 자격 증명을 사용하여 호스트에 연결할 때 암호 및 사용자 이름을 제외하고 EXPIRING CREDENTIALS 섹션에 나열된 모든 매개 변수를 사용해야 합니다.

매개 변수 설명
서버/호스트 연결할 서버/호스트의 이름입니다.
  • 이 값은 만료 자격 증명과 만료 전 자격 증명 모두에 사용되며 server.adobe.io 형식을 갖습니다. 이 값은 만료 자격 증명 섹션의 호스트 아래에 있습니다.
포트 연결할 서버/호스트의 포트입니다.
  • 이 값은 만료 자격 증명과 만료 전 자격 증명 모두에 사용되며 만료 자격 증명 섹션의 포트​에서 찾을 수 있습니다. 포트의 예제 값은 80입니다.
데이터베이스 연결할 데이터베이스입니다.
  • 이 값은 만료 자격 증명과 만료 전 자격 증명 모두에 사용되며 만료 자격 증명 섹션의 데이터베이스​에 있습니다. 데이터베이스의 예제 값은 prod:all입니다.
사용자 이름 외부 클라이언트에 연결하는 사용자의 사용자 이름입니다.
  • 만료 자격 증명을 사용하는 경우 @AdobeOrg 앞에 영숫자 문자열을 사용합니다. 이 값은 사용자 이름​에 있습니다.
  • 만료되지 않은 자격 증명을 사용 중인 경우, a1/>은(는) 구성 JSON 파일에 있는 technicalAccountID 값과 동일할 수 없지만 선택하는 문자열입니다.
암호 외부 클라이언트에 연결하는 사용자의 암호입니다.
  • 만료 자격 증명을 사용하는 경우 만료 자격 증명 섹션 내에서 암호​에서 찾을 수 있습니다.
  • 만료되지 않은 자격 증명을 사용하는 경우 이 값은 technicalAccountID에서 연결된 인수와 구성 JSON 파일에서 가져온 자격 증명입니다. 암호 값은 다음 형식을 사용합니다. {technicalAccountId}:{credential}

다음 단계

만료 자격 증명과 만료 전 자격 증명이 모두 작동하는 방식을 이해하므로 이러한 자격 증명을 사용하여 외부 클라이언트에 연결할 수 있습니다. 외부 클라이언트에 대한 자세한 내용은 클라이언트 연결을 Query Service 안내서를 참조하십시오.

이 페이지에서는