자격 증명 안내서

마지막 업데이트: 2023-11-04
  • 주제:
  • Queries
    이 항목에 대한 자세한 내용 보기
  • 작성 대상:
  • Developer
    User
    Admin
    Leader

Adobe Experience Platform Query Service를 사용하면 외부 클라이언트와 연결할 수 있습니다. 만료 자격 증명 또는 만료되지 않는 자격 증명을 사용하여 이러한 외부 클라이언트에 연결할 수 있습니다.

노트

모든 사용자가 자격 증명 패널을 자동으로 사용할 수 있는 것은 아닙니다. Adobe 계정 팀에 문의하여 다음을 요청하십시오. 자격 증명 필요한 경우 쿼리 서비스 작업 영역에 포함할 탭입니다. 요청할 경우 이 변경은 조직 전체에 적용되며 Adobe 엔지니어링 팀에서 수행합니다. 사용자가 제어하는 설정이 아닙니다.

자격 증명 만료

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

만료 자격 증명 섹션이 강조 표시된 쿼리 대시보드 자격 증명 탭입니다.

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

  • 호스트: 클라이언트를 연결할 호스트의 이름입니다. Platform UI의 상단 리본에 표시된 조직 이름이 통합됩니다.
  • 포트: 연결할 호스트의 포트 번호입니다.
  • 데이터베이스: 클라이언트를 연결할 데이터베이스의 이름입니다.
  • 사용자 이름: 쿼리 서비스에 연결하는 데 사용되는 사용자 이름입니다.
  • 암호: 쿼리 서비스에 연결하는 데 사용되는 암호입니다. 보안을 위해 UI의 암호가 해시되었습니다. 복사 아이콘(복사 아이콘)을 클릭하여 해시되지 않은 전체 자격 증명을 클립보드에 복사합니다.
  • PSQL 명령: 명령줄에서 PSQL을 사용하여 쿼리 서비스에 연결할 모든 관련 정보를 자동으로 삽입하는 명령입니다.
  • 만료: 만료될 자격 증명의 만료일 및 시간입니다. 토큰의 기본 유효 기간은 24시간이지만 Admin Console의 고급 설정에서 변경할 수 있습니다.

만료되는 자격 증명 연결의 세션 수명을 쿼리 서비스로 변경하려면 다음 위치로 이동합니다. Admin Console 화면에 표시할 옵션을 선택하십시오. 설정 > 개인 정보 보호 및 보안 > 인증 설정 > 고급 설정 > 최대 세션 수명.

개인 정보 및 보안, 인증 설정 및 최대 세션 수명이 강조 표시된 Admin Console 설정 탭입니다.

에 대한 자세한 내용은 Adobe 도움말 설명서 를 참조하십시오. 고급 설정 Admin Console 제공.

만료되지 않는 자격 증명

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

노트

만료되지 않는 자격 증명에는 다음과 같은 제한이 있습니다.

  • 사용자는 다음으로 구성된 사용자 이름 및 암호로 로그인해야 합니다. {technicalAccountId}:{credential}. 자세한 내용은 자격 증명 생성 섹션.
  • 만료되는 자격 증명을 만들 때 사용자가 스키마 및 데이터 세트를 볼 수 있는 기본 권한 집합이 있는 새 역할이 만들어집니다. 쿼리 서비스와 함께 사용할 수 있도록 '쿼리 관리' 권한도 이 역할에 할당됩니다.
  • 서드파티 클라이언트는 쿼리 개체를 나열할 때 예상과 다르게 수행할 수 있습니다. 예를 들어 다음과 같은 일부 타사 클라이언트 DB Visualizer 왼쪽 패널에 보기 이름이 표시되지 않습니다. 그러나 SELECT 쿼리 내에서 를 호출한 경우에는 보기 이름에 액세스할 수 있습니다. 마찬가지로, PowerUI 대시보드 생성을 위해 선택할 SQL을 통해 생성된 임시 뷰를 나열하지 않을 수 있습니다.

전제 조건

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

  1. 에 로그인 Adobe Admin Console 맨 위 탐색 막대에서 관련 조직을 선택합니다.
  2. 제품 프로필을 선택합니다.
  3. 두 구성 샌드박스쿼리 서비스 통합 관리 권한 제품 프로필.
  4. 제품 프로필에 새 사용자 추가 따라서 구성된 권한이 부여됩니다.
  5. 사용자를 제품 프로필 관리자로 추가 모든 활성 제품 프로필에 대한 계정 만들기를 허용합니다.
  6. 사용자를 제품 프로필 개발자로 추가 통합을 만들려면.

권한을 할당하는 방법에 대한 자세한 내용은 다음 설명서를 참조하십시오. 액세스 제어.

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

자격 증명 생성

만료되지 않는 자격 증명 세트를 만들려면 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의 탭입니다.

만료되는 자격 증명 섹션이 강조 표시된 쿼리 작업 영역 자격 증명 탭입니다.

아래 표에는 일반적으로 외부 클라이언트에 연결하는 데 필요한 매개 변수가 나와 있습니다.

노트

만료되지 않는 자격 증명을 사용하여 호스트에 연결할 때에도 목록에 있는 모든 매개 변수를 사용해야 합니다 자격 증명 만료 암호와 사용자 이름을 제외한 섹션입니다.
사용자 이름과 암호를 입력하는 형식은 이 예제와 같이 콜론으로 구분된 값을 사용합니다 username:{your_username}password:{password_string}.

매개변수 설명
서버/호스트 접속 중인 서버/호스트의 이름입니다.
  • 이 값은 만료 중인 자격 증명과 만료되지 않는 자격 증명 모두에 사용되며 다음 형식을 사용합니다. server.adobe.io. 값은 다음에서 찾을 수 있습니다. 호스트 다음에서 자격 증명 만료 섹션.
acme.platform.adobe.io
포트 연결 중인 서버/호스트의 포트입니다.
  • 이 값은 만료 중인 자격 증명과 만료되지 않는 자격 증명 모두에 사용되며 아래에 있습니다. 포트 다음에서 자격 증명 만료 섹션.
80
데이터베이스 연결 중인 데이터베이스입니다.
  • 이 값은 만료 중인 자격 증명과 만료되지 않는 자격 증명 모두에 사용되며 아래에 있습니다. 데이터베이스 다음에서 자격 증명 만료 섹션.
prod:all
사용자 이름 외부 클라이언트에 연결하는 사용자의 사용자 이름입니다.
  • 이 값은 만료되는 자격 증명과 만료되지 않는 자격 증명 모두에 사용됩니다. 다음 앞에 영숫자 문자열 형식을 사용합니다. @AdobeOrg. 이 값은 다음에서 찾을 수 있습니다 사용자 이름.
ECBB80245ECFC73E8A095EC9@AdobeOrg
암호 외부 클라이언트에 연결하는 사용자의 암호입니다.
  • 만료되는 자격 증명을 사용하는 경우 다음에서 찾을 수 있습니다. 암호 다음 범위 내 자격 증명 만료 섹션.
  • 만료되지 않는 자격 증명을 사용하는 경우 이 값은 technicalAccountID의 연결된 인수와 구성 JSON 파일에서 가져온 자격 증명입니다. 암호 값은 다음 형식을 사용합니다. {technicalAccountId}:{credential}.
  • 만료될 자격 증명 암호는 1,000자 이상의 영숫자 문자열입니다. 예시는 제공되지 않을 것입니다.
  • 만료되지 않는 자격 증명 암호는 다음과 같습니다.
    4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee

다음 단계

만료될 때까지 및 만료되지 않는 자격 증명이 모두 작동하는 방식을 이해했으므로 이러한 자격 증명을 사용하여 외부 클라이언트에 연결할 수 있습니다. 외부 클라이언트에 대한 자세한 내용은 클라이언트를 Query Service에 연결 안내서.

이 페이지의