설명서AEM 6.5사용 안내서

AEM에서 cURL 사용 using-curl-with-aem

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager 6.5

작성 대상:

  • 개발자

관리자는 시스템 내에서 일반적인 작업을 자동화하거나 단순화해야 하는 경우가 많습니다. 예를 들어 AEM에서 사용자 관리, 패키지 설치 및 OSGi 번들 관리는 일반적으로 수행해야 하는 작업입니다.

AEM이 구축된 Sling 프레임워크의 RESTful 특성으로 인해 대부분의 작업은 URL 호출로 수행할 수 있습니다. cURL은 이러한 URL 호출을 실행하는 데 사용할 수 있으며 AEM 관리자에게 유용한 도구가 될 수 있습니다.

cURL이란 what-is-curl

cURL은 URL 조작을 수행하는 데 사용되는 오픈 소스 명령줄 도구입니다. HTTP, HTTPS, FTP, FTPS, SCP, SFTP, TFTP, LDAP, DAP, DICT, TELNET, FILE, IMAP, POP3, SMTP, RTSP 등 다양한 인터넷 프로토콜을 지원합니다.

cURL은 URL 구문을 사용하여 데이터를 가져오거나 보내는 데 널리 사용되는 도구로서 1997년에 처음 출시되었습니다. cURL이라는 이름은 원래 "URL 참조"를 의미했습니다.

AEM이 빌드된 Sling 프레임워크의 RESTful 특성으로 인해 대부분의 작업을 cURL로 실행할 수 있는 URL 호출로 줄일 수 있습니다. 페이지 활성화, 워크플로 시작과 같은 콘텐츠 조작 작업 과 패키지 관리 및 사용자 관리와 같은 운영 작업은 cURL을 사용하여 자동화할 수 있습니다. 또한 AEM에서 대부분의 작업에 대해 고유한 cURL🔗 명령을 만들 수 있습니다.

NOTE
cURL을 통해 실행된 모든 AEM 명령은 AEM에 대한 모든 사용자와 마찬가지로 인증을 받아야 합니다. cURL을 사용하여 AEM 명령을 실행할 때에는 모든 ACL 및 액세스 권한이 적용됩니다.

cURL 다운로드 downloading-curl

cURL은 macOS 및 일부 Linux 배포판의 표준 부분입니다. 그러나 대부분의 모든 운영 체제에서 사용할 수 있습니다. 최신 다운로드는 https://curl.haxx.se/download.html 에서 찾을 수 있습니다.

cURL의 소스 저장소는 GitHub에서도 찾을 수 있습니다.

cURL 지원 AEM 명령 작성 building-a-curl-ready-aem-command

cURL 명령은 워크플로우 트리거, OSGi 구성 확인, JMX 명령 트리거, 복제 에이전트 만들기 등과 같은 AEM 대부분의 작업에 대해 빌드할 수 있습니다.

특정 작업에 필요한 정확한 명령을 찾으려면 브라우저의 개발자 도구를 사용하여 AEM 명령을 실행할 때 서버에 대한 POST 호출을 캡처해야 합니다.

다음 단계에서는 크롬 브라우저 내에서 새 페이지 만들기를 예로 들어 이 작업을 수행하는 방법을 설명합니다.

  1. AEM 내에서 호출할 작업을 준비합니다. 이 경우 만들기 페이지 마법사의 끝까지 진행했지만 아직 만들기 ​를 클릭하지 않았습니다.

    chlimage_1-66

  2. 개발자 도구를 시작 하고 네트워크​ 탭 을 선택합니다. 콘솔을 지우기 전에 로그 보존 옵션을 클릭합니다.

    chlimage_1-67

  3. 실제로 작업 과정 만들려면 만들기 페이지 마법사에서 [만들기]를 클릭합니다​ .

  4. 결과 POST 작업을 마우스 오른쪽 단추로 클릭하고 복사 > cURL 로 복사를 선택합니다. ​

    chlimage_1-68

  5. cURL 명령을 텍스트 편집기 편집기에 복사하고 (아래 이미지에서 파란색으로 강조 표시됨)으로 -H 시작하는 모든 헤더를 명령에서 제거하고 와 같은 -u <user>:<password>적절한 인증 매개 변수를 추가합니다.

    chlimage_1-69

  6. 명령줄을 통해 cURL 명령을 실행하고 응답을 확인합니다.

    chlimage_1-70

일반적인 작동 AEM cURL 명령 common-operational-aem-curl-commands

다음은 일반적인 관리 및 운영 작업에 대한 AEM cURL 명령 목록입니다.

NOTE
다음 예제에서는 AEM이 포트 4502의 localhost에서 실행 중이며 암호가 admin인 사용자 admin을(를) 사용한다고 가정합니다. 추가 명령 자리 표시자는 꺾쇠 괄호로 설정됩니다.

패키지 관리 package-management

설치된 모든 패키지 나열

curl -u <user>:<password> http://<host>:<port>/crx/packmgr/service.jsp?cmd=ls

패키지 만들기 create-a-package

curl -u <user>:<password> -X POST http://localhost:4502/crx/packmgr/service/.json/etc/packages/mycontent.zip?cmd=create -d packageName=<name> -d groupName=<name>

패키지 미리 보기 preview-a-package

curl -u <user>:<password> -X POST http://localhost:4502/crx/packmgr/service/.json/etc/packages/mycontent.zip?cmd=preview

패키지 콘텐츠 나열 list-package-content

curl -u <user>:<password> -X POST http://localhost:4502/crx/packmgr/service/console.html/etc/packages/mycontent.zip?cmd=contents

패키지 빌드 build-a-package

curl -X POST http://localhost:4502/crx/packmgr/service/.json/etc/packages/mycontent.zip?cmd=build

패키지 다시 래핑 rewrap-a-package

curl -u <user>:<password> -X POST http://localhost:4502/crx/packmgr/service/.json/etc/packages/mycontent.zip?cmd=rewrap

패키지 이름 바꾸기 rename-a-package

curl -u <user>:<password> -X POST -Fname=<New Name> http://localhost:4502/etc/packages/<Group Name>/<Package Name>.zip/jcr:content/vlt:definition

패키지 업로드 upload-a-package

curl -u <user>:<password> -F cmd=upload -F force=true -F package=@test.zip http://localhost:4502/crx/packmgr/service/.json

패키지 설치 install-a-package

curl -u <user>:<password> -F cmd=install http://localhost:4502/crx/packmgr/service/.json/etc/packages/my_packages/test.zip

패키지 제거 uninstall-a-package

curl -u <user>:<password> -F cmd=uninstall http://localhost:4502/crx/packmgr/service/.json/etc/packages/my_packages/test.zip

패키지 삭제 delete-a-package

curl -u <user>:<password> -F cmd=delete http://localhost:4502/crx/packmgr/service/.json/etc/packages/my_packages/test.zip

패키지 다운로드 download-a-package

curl -u <user>:<password> http://localhost:4502/etc/packages/my_packages/test.zip

패키지 복제 replicate-a-package

curl -u <user>:<password> -X POST http://localhost:4502/crx/packmgr/service/.json/etc/packages/my_packages/test.zip?cmd=replicate

사용자 관리 user-management

새 사용자 만들기 create-a-new-user

curl -u <user>:<password> -FcreateUser= -FauthorizableId=hashim -Frep:password=hashim http://localhost:4502/libs/granite/security/post/authorizables

새 그룹 만들기 create-a-new-group

curl -u <user>:<password> -FcreateGroup=group1 -FauthorizableId=testGroup1 http://localhost:4502/libs/granite/security/post/authorizables

기존 사용자에게 속성 추가 add-a-property-to-an-existing-user

curl -u <user>:<password> -Fprofile/age=25 http://localhost:4502/home/users/h/hashim.rw.html

프로필로 사용자 만들기 create-a-user-with-a-profile

curl -u <user>:<password> -FcreateUser=testuser -FauthorizableId=hashimkhan -Frep:password=hashimkhan -Fprofile/gender=male http://localhost:4502/libs/granite/security/post/authorizables

새 사용자를 그룹의 구성원으로 만들기 create-a-new-user-as-a-member-of-a-group

curl -u <user>:<password> -FcreateUser=testuser -FauthorizableId=testuser -Frep:password=abc123 -Fmembership=contributor http://localhost:4502/libs/granite/security/post/authorizables

그룹에 사용자 추가 add-a-user-to-a-group

curl -u <user>:<password> -FaddMembers=testuser1 http://localhost:4502/home/groups/t/testGroup.rw.html

그룹에서 사용자 제거 remove-a-user-from-a-group

curl -u <user>:<password> -FremoveMembers=testuser1 http://localhost:4502/home/groups/t/testGroup.rw.html

사용자 그룹 구성원 자격 설정 set-a-user-s-group-membership

curl -u <user>:<password> -Fmembership=contributor -Fmembership=testgroup http://localhost:4502/home/users/t/testuser.rw.html

사용자 삭제 delete-a-user

curl -u <user>:<password> -FdeleteAuthorizable= http://localhost:4502/home/users/t/testuser

그룹 삭제 delete-a-group

curl -u <user>:<password> -FdeleteAuthorizable= http://localhost:4502/home/groups/t/testGroup

백업 backup

자세한 내용은 백업 및 복원🔗을 참조하십시오.

OSGi osgi

번들 시작 starting-a-bundle

curl -u <user>:<password> -Faction=start http://localhost:4502/system/console/bundles/<bundle-name>

번들 중지 stopping-a-bundle

curl -u <user>:<password> -Faction=stop http://localhost:4502/system/console/bundles/<bundle-name>

Dispatcher dispatcher

캐시 무효화 invalidate-the-cache

curl -H "CQ-Action: Activate" -H "CQ-Handle: /content/test-site/" -H "CQ-Path: /content/test-site/" -H "Content-Length: 0" -H "Content-Type: application/octet-stream" http://localhost:4502/dispatcher/invalidate.cache

캐시 제거 evict-the-cache

curl -H "CQ-Action: Deactivate" -H "CQ-Handle: /content/test-site/" -H "CQ-Path: /content/test-site/" -H "Content-Length: 0" -H "Content-Type: application/octet-stream" http://localhost:4502/dispatcher/invalidate.cache

복제 에이전트 replication-agent

에이전트의 상태 확인 check-the-status-of-an-agent

curl -u <user>:<password> "http://localhost:4502/etc/replication/agents.author/publish/jcr:content.queue.json?agent=publish"
http://localhost:4502/etc/replication/agents.author/publish/jcr:content.queue.json?agent=publish

에이전트 삭제 delete-an-agent

curl -X DELETE http://localhost:4502/etc/replication/agents.author/replication99 -u <user>:<password>

에이전트 만들기 create-an-agent

curl -u <user>:<password> -F "jcr:primaryType=cq:Page" -F "jcr:content/jcr:title=new-replication" -F "jcr:content/sling:resourceType=/libs/cq/replication/components/agent" -F "jcr:content/template=/libs/cq/replication/templates/agent" -F "jcr:content/transportUri=http://localhost:4503/bin/receive?sling:authRequestLogin=1" -F "jcr:content/transportUser=admin" -F "jcr:content/transportPassword={DES}8aadb625ced91ac483390ebc10640cdf"http://localhost:4502/etc/replication/agents.author/replication99

에이전트 일시 중지 pause-an-agent

curl -u <user>:<password> -F "cmd=pause" -F "name=publish"  http://localhost:4502/etc/replication/agents.author/publish/jcr:content.queue.json

에이전트 큐 지우기 clear-an-agent-queue

curl -u <user>:<password> -F "cmd=clear" -F "name=publish"  http://localhost:4502/etc/replication/agents.author/publish/jcr:content.queue.json

커뮤니티 communities

배지 할당 및 취소 assign-and-revoke-badges

자세한 내용은 Communities 점수 및 배지를🔗 참조하십시오.

자세한 내용은 점수 및 배지 필수 사항을🔗 참조하십시오.

MSRP 재인덱싱 msrp-reindexing

자세한 내용은 MSRP - MongoDB 저장소 리소스 공급자🔗를 참조하세요.

보안 security

CRX DE Lite 활성화 및 비활성화 enabling-and-disabling-crx-de-lite

자세한 내용은 AEM🔗에서 CRXDE Lite 활성화를 참조하십시오.

데이터 저장소 가비지 컬렉션 data-store-garbage-collection

자세한 내용은 데이터 저장소 가비지 수집🔗을 참조하십시오.

Analytics 및 Target 통합 analytics-and-target-integration

자세한 내용은 Adobe Analytics 및 Adobe Target🔗 선택을 참조하십시오.

단일 사인온 single-sign-on

테스트 헤더 전송 send-test-header

자세한 내용은 단일 사인온🔗을 참조하십시오.

일반적인 컨텐츠 조작 AEM cURL 명령 common-content-manipulation-aem-curl-commands

다음은 컨텐츠 조작을 위한 AEM cURL 명령 목록입니다.

NOTE
다음 예제에서는 AEM이 포트 4502의 localhost에서 실행 중이며 암호가 admin인 사용자 admin을(를) 사용한다고 가정합니다. 추가 명령 자리 표시자는 꺾쇠 괄호로 설정됩니다.

페이지 관리 page-management

페이지 활성화 page-activation

curl -u <user>:<password> -X POST -F path="/content/path/to/page" -F cmd="activate" http://localhost:4502/bin/replicate.json

페이지 비활성화 page-deactivation

curl -u <user>:<password> -X POST -F path="/content/path/to/page" -F cmd="deactivate" http://localhost:4502/bin/replicate.json

트리 Activation tree-activation

curl -u <user>:<password> -F cmd=activate -F ignoredeactivated=true -F onlymodified=true -F path=/content/geometrixx http://localhost:4502/etc/replication/treeactivation.html

페이지 잠금 lock-page

curl -u <user>:<password> -X POST -F cmd="lockPage" -F path="/content/path/to/page" -F "_charset_"="utf-8" http://localhost:4502/bin/wcmcommand

페이지 잠금 해제 unlock-page

curl -u <user>:<password> -X POST -F cmd="unlockPage" -F path="/content/path/to/page" -F "_charset_"="utf-8" http://localhost:4502/bin/wcmcommand

페이지 복사 copy-page

curl -u <user>:<password> -F cmd=copyPage -F destParentPath=/path/to/destination/parent -F srcPath=/path/to/source/location http://localhost:4502/bin/wcmcommand

간단 롤아웃 수행 방법 shallow-rollout

AEM as a Cloud Service을 사용할 때 하위 페이지를 전파하지 않고 특정 단일 페이지를 롤아웃해야 하는 경우가 있을 수 있습니다. 올바르게 구성되지 않은 경우 페이지 롤아웃을 위한 일반적인 curl 명령에 실수로 하위 페이지가 포함될 수 있습니다. 이 섹션에서는 curl 명령을 조정하여 지정된 페이지의 얕은 롤아웃을 달성하고 추가 하위 페이지를 제외하는 방법을 설명합니다.

단순 롤아웃 수행하려면 다음 단계를 팔로우하십시오.

  1. 매개 변수를 type=deep 에서 로 변경하여 기존 curl 명령을 수정합니다 type=page.
  2. curl 명령에 대해 다음 구문을 사용합니다.
curl -H "Authorization: Bearer <token>" "https://<instance-url>/bin/asynccommand" \
   -d type=page \
   -d operation=asyncRollout \
   -d cmd=rollout \
   -d path="/content/<your-path>"

또한 다음을 확인하십시오.

  1. <token>을(를) 실제 인증 토큰으로 바꾸고 <instance-url>을(를) 특정 인스턴스 URL로 바꾸십시오.
  2. /content/<your-path>을(를) 롤아웃할 특정 페이지의 경로로 바꿉니다.

type=page을(를) 설정하면 명령은 하위 페이지를 제외하고 지정된 페이지만 대상으로 합니다. 따라서 이 구성을 사용하면 컨텐츠 배포를 정확하게 제어할 수 있으므로 의도한 변경 사항만 환경 전체에 전파됩니다. 또한 이 조정은 개별 페이지를 선택할 때 AEM GUI를 통해 롤아웃을 관리하는 방식에도 적용됩니다.

워크플로 workflows

자세한 내용은 프로그래밍 방식으로 워크플로와 상호 작용을 참조하십시오.

Sling 콘텐츠 sling-content

폴더 만들기 create-a-folder

curl -u <user>:<password> -F jcr:primaryType=sling:Folder http://localhost:4502/etc/test

노드 삭제 delete-a-node

curl -u <user>:<password> -F :operation=delete http://localhost:4502/etc/test/test.properties

노드 이동 move-a-node

curl -u <user>:<password> -F":operation=move" -F":applyTo=/sourceurl"  -F":dest=/target/parenturl/" https://localhost:4502/content

노드 복사 copy-a-node

curl -u <user>:<password> -F":operation=copy" -F":applyTo=/sourceurl"  -F":dest=/target/parenturl/" https://localhost:4502/content

Sling PostServlet을 사용하여 파일 업로드 upload-files-using-sling-postservlet

curl -u <user>:<password> -F"*=@test.properties"  http://localhost:4502/etc/test

Sling PostServlet을 사용하고 노드 이름을 지정하여 파일 업로드 upload-files-using-sling-postservlet-and-specifying-node-name

curl -u <user>:<password> -F"test2.properties=@test.properties"  http://localhost:4502/etc/test

컨텐트 유형 지정 파일 업로드 upload-files-specifying-a-content-type

curl -u <user>:<password> -F "*=@test.properties;type=text/plain" http://localhost:4502/etc/test

자산 조작 asset-manipulation

자세한 내용은 Assets HTTP API를 참조하십시오.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2