aepctl

Access Control API 지원

Adobe Experience Platform의 Access Control API를 통해 권한 및 액세스 관리를 수행할 수 있습니다.

Offer Decisioning 지원

Offer Decisioning API를 활용하여 오퍼 결정 및 관리 기능을 제공합니다.

Schema Registry 지원

doc/sr.md에 문서화된 Schema Registry 관련 명령을 통해 데이터 모델 및 스키마를 관리할 수 있습니다.

Identity Service 지원

doc/is.md에 문서화된 Identity Service 명령을 통해 사용자 ID 및 식별자 관리가 가능합니다.

Query Service 지원

doc/qs.md에 문서화된 Query Service 명령을 통해 AEP 내 데이터 쿼리 및 분석을 수행할 수 있습니다.

Windows 설치 방법

Windows에서 aepctl을 설치하려면 PowerShell을 사용합니다. 먼저 다음 명령을 실행하여 최신 버전의 aepctl.exe를 다운로드합니다:

Invoke-WebRequest https://www.bungenstock.de/aepctl/releases/latest/windows/amd64/aepctl.exe -OutFile aepctl.exe

다운로드 후, 파일의 무결성을 검증하려면 SHA256 파일을 받아 비교할 수 있습니다:

Invoke-WebRequest https://www.bungenstock.de/aepctl/releases/latest/windows/amd64/aepctl.exe.sha256 -OutFile aepctl.exe.sha256

다음 명령으로 해시 값을 비교하여 검증합니다 (결과가 True여야 함):

(Get-FileHash aepctl.exe).Hash -eq (Get-Content aepctl.exe.sha256)

검증이 완료되면 aepctl.exe를 시스템 PATH에 추가합니다. 그런 다음 다음 명령을 실행하여 설치 및 구성을 테스트합니다:

aepctl –help

기본 사용법/명령어

설치 및 PATH 설정 후, aepctl을 사용하기 위해 먼저 Adobe I/O 프로젝트를 생성해야 합니다. 자세한 방법은 doc/new_project.md를 참조하십시오.

Adobe I/O 프로젝트 생성 후, 다음 명령을 실행하여 초기 구성을 시작합니다:

aepctl configure

이 명령은 인증 자격 증명을 입력하도록 프롬프트를 표시합니다. Adobe I/O 콘솔에서 Service Account(JWT)를 클릭하여 얻은 자격 증명과 개인 키 파일을 붙여넣으십시오. 자세한 내용은 doc/configuration.md를 참조하십시오.

구성이 완료되면 다음 명령을 실행하여 액세스 토큰을 얻어 구성을 테스트할 수 있습니다:

aepctl get token

성공적으로 토큰이 발급되면, 각 API별 명령어를 사용하여 AEP 기능을 제어할 수 있습니다. 예를 들어, Access Control API 관련 명령은 aepctl access-control 형태로 사용됩니다.

이런 경우에 유용합니다

Adobe Experience Platform을 자주 사용하는 개발자나 시스템 관리자가 반복적인 API 작업을 명령줄로 자동화하고자 할 때 유용합니다. 예를 들어, 스키마 등록, 사용자 ID 관리, 오퍼 결정 설정 등을 스크립트화하여 배포 파이프라인에 통합할 수 있습니다. 또한, AEP의 REST API를 학습 중인 개발자가 명령줄 인터페이스를 통해 빠르게 실험하고 결과를 확인하는 데 도움이 됩니다.

지원 환경·시스템 요구사항

Windows에서 사용하려면 PowerShell이 필요합니다. 설치 과정에서 PowerShell을 통해 파일을 다운로드하고, 해시 검증 및 PATH 설정을 수행해야 합니다. macOS에서는 Homebrew를 통해 설치할 수 있으나, 본 스토어는 Windows 사용자를 대상으로 하므로 Windows 환경에서의 사용을 기준으로 설명합니다.