관리자 API 키 소개

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 2분
  • 관리자 API 호출을 사용하여 관리자 UI 인터페이스와 브라우저를 사용하지 않고 관리자 기능에 액세스할 수 있습니다.

    CPQ는 브라우저와 관리자 인터페이스를 사용하는 대신 API 호출을 통해 관리자 기능에 액세스하는 데 사용할 수 있는 관리자 API 키를 제공합니다.CPQ

    관리자 API 키에 대한 CPQ 소개는 다음 비디오를 참조하십시오.

    관리자 API 키

    관리자 API 키 페이지

    에서 관리자 API 키 페이지 CPQ로 이동하려면 화살표를 클릭하여 관리자에서 CPQ 유틸리티 섹션을 확장합니다. 메뉴에 관리자 API 키 탭이 나타납니다.

    관리자 키

    새 관리자 API 키 추가

    새 관리자 API 키를 추가하려면 화면 상단에서 새로 만들기 를 클릭합니다.

    관리자 키 추가

    모든 매개변수가 필요합니다.

    1. 이름: 관리자 API 키의 이름
    2. 사용자 ID
    3. 만료 날짜: 키의 만료 날짜
    4. 권한: 키에 할당된 권한

    저장을 클릭하기 전에 사용 케이스에 맞는 권한을 선택합니다.

    관리자 API 키 권한

    API 키 권한

    1. 읽기(필수, 기본값): 일반적으로 GET 요청에 대한 읽기 전용 액세스 권한입니다
    2. 편집: 필드 및 규칙을 포함하여 대부분의 객체에 대한 생성, 읽기, 업데이트 및 삭제 액세스
    3. 배포: Blueprint를 배포하고 배포 기록에 액세스할 수 있습니다.
    4. 대량: 관리되는 테이블과 같은 데이터를 주고받을 수 있습니다. CPQ
    5. 관리자: 모든 관리자 기능에 대한 전체 권한
    6. 최종 사용자 데이터: 최종 사용자 데이터 API에 대한 액세스

    권한 할당을 마치면 저장을 클릭합니다. 대화 상자가 업데이트되어 새 관리자 API 키가 표시됩니다.

    API 키 추가

    1. 관리자 API 키 보기
    2. 클립보드에 키 복사
    3. 대화 상자 닫기
    중요사항:
    관리자 API 키는 생성될 때만 복사할 수 있습니다. 키를 복사하여 저장해야 합니다.

    API 키를 사용하여 관리자 API에 액세스

    API 요청에서 관리자 API 키를 사용하려면 전달자 토큰 인증과 함께 API 키를 사용합니다.

    • 헤더: 인증 헤더
    • 키: 권한 부여
    • 값: 전달자<관리자 API 키>

    예시 헤더:

    권한 부여: 전달자 Qda_UdoiYipb15Le11En8axEuN71FA6Vt_cw

    관리자 API 키를 사용하는 경우 다른 엔드포인트를 사용하여 관리자 API에 액세스합니다.

    • 일반 관리자 엔드포인트(/a/Admin/...)의 경우 사용할 엔드포인트는 (/api/Admin/...)입니다.

      예를 들어 (규칙 목록 검색):

      • 관리자 UI의 API 호출: /a/Admin/v3/rules?page=0&size=100&sort=modified%2CDESC
      • 관리자 키를 사용한 API 호출: /api/Admin/v3/rules?page=0&size=100&sort=modified%2CDESC
    • 관리형 테이블 엔드포인트(/a/managed_tables/...)의 경우 API 키로 액세스할 때 사용할 엔드포인트는 (/api/managedTables/...)입니다.

      예를 들어 (관리되는 테이블의 스키마 검색):

      • 관리자 UI의 API 호출: /a/managed_tables/v1/managedTables/{tableName}/metadata
      • 관리자 키를 사용한 API 호출: /api/managedTables/v1/managedTables/{tableName}/metadata