Show Menu
ARGOMENTI×

Utilizzo di cURL con AEM

Gli amministratori devono spesso automatizzare o semplificare le attività più comuni all'interno di qualsiasi sistema. In AEM, ad esempio, la gestione di utenti, l'installazione di pacchetti e la gestione di pacchetti OSGi sono attività che devono essere eseguite normalmente.
A causa della natura RESTful del framework Sling su cui è basato AEM, la maggior parte delle attività può essere ridotta a una chiamata URL. cURL può essere utilizzato per eseguire tali chiamate URL e può essere uno strumento utile per gli amministratori AEM.

Cos’è cURL

cURL è uno strumento della riga di comando open-source utilizzato per eseguire manipolazioni URL. Supporta un'ampia gamma di protocolli Internet tra cui HTTP, HTTPS, FTP, FTPS, SCP, SFTP, TFTP, LDAP, DAP, DICT, TELNET, FILE, IMAP, POP3, SMTP e RTSP.
cURL è uno strumento noto e ampiamente utilizzato per ottenere o inviare dati utilizzando la sintassi URL ed è stato originariamente rilasciato nel 1997. Il nome cURL in origine significava "see URL".
A causa della natura RESTful del framework Sling su cui è basato AEM, la maggior parte delle attività può essere ridotta a una chiamata URL, che può essere eseguita con cURL. Le attività di manipolazione dei contenuti, come l’attivazione delle pagine, l’avvio dei flussi di lavoro e le attività Comandi operativi comuni AEM cURL operative come la gestione dei pacchetti e la gestione degli utenti possono essere automatizzate tramite cURL. Inoltre, potete creare comandi cURL personalizzati per la maggior parte delle attività in AEM.
Qualsiasi comando AEM eseguito tramite cURL deve essere autorizzato come qualsiasi utente in AEM. Tutti gli ACL e i diritti di accesso vengono rispettati quando si utilizza cURL per eseguire un comando AEM.

Download di cURL

cURL è una parte standard di macOS e alcune distanze Linux. Tuttavia è disponibile per la maggior parte di tutti i sistemi operativi. Gli ultimi download sono disponibili all'indirizzo https://curl.haxx.se/download.html .
L'archivio di origine di cURL è disponibile anche su GitHub.

Creazione di un comando AEM CCURL-Ready

I comandi cURL possono essere creati per la maggior parte delle operazioni in AEM, ad esempio per attivare flussi di lavoro, controllare le configurazioni OSGi, attivare i comandi JMX, creare agenti di replica e molto altro ancora.
Per trovare il comando esatto necessario per una particolare operazione, è necessario utilizzare gli strumenti di sviluppo del browser per acquisire la chiamata POST al server quando si esegue il comando AEM.
Nei passaggi seguenti viene descritto come eseguire questa operazione utilizzando come esempio la creazione di una nuova pagina nel browser Chrome.
  1. Preparate l’azione da richiamare in AEM. In questo caso, alla fine della procedura guidata Crea pagina è stata completata l’operazione, ma non è stato ancora fatto clic su Crea .
  2. Avviate gli strumenti di sviluppo e selezionate la scheda Rete . Fate clic sull’opzione Mantieni registro prima di cancellare la console.
  3. Fate clic su Crea nella procedura guidata Crea pagina per creare il flusso di lavoro.
  4. Fate clic con il pulsante destro del mouse sull’azione POST risultante e selezionate Copia -> Copia come cURL .
  5. Copiate il comando cURL in un editor di testo e rimuovete tutte le intestazioni dal comando, che inizia con -H (evidenziato in blu nell’immagine di seguito) e aggiungete il parametro di autenticazione corretto, ad esempio -u <user>:<password> .
  6. Eseguite il comando cURL dalla riga di comando e visualizzate la risposta.

Comandi operativi comuni AEM cURL

Elenco dei comandi AEM cURL per le comuni attività amministrative e operative.
Gli esempi seguenti presuppongono che AEM sia in esecuzione sulla localhost porta 4502 e utilizzi l’utente admin con password admin . I segnaposto dei comandi aggiuntivi sono impostati tra parentesi angolari.

Gestione pacchetti

Elenca tutti i pacchetti installati

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>

Anteprima di un pacchetto

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

Contenuto pacchetto elenco

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

Creare un pacchetto

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

Riavvolgere un pacchetto

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

Rinominare un pacchetto

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

Caricare un pacchetto

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

Installare un pacchetto

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

Disinstallare un pacchetto

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

Eliminare un pacchetto

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

Download di un pacchetto

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

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

Aggiunta di una proprietà a un utente esistente

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

Creazione di un utente con un profilo

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

Creare un nuovo utente come membro di un gruppo

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

Aggiunta di un utente a un gruppo

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

Rimozione di un utente da un gruppo

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

Impostazione dell'appartenenza a un gruppo di utenti

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

Eliminare un utente

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


Eliminare un gruppo

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

Backup

Per informazioni dettagliate, consultate Backup e ripristino .

OSGi

Avvio di un pacchetto

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

Arresto di un pacchetto

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

Dispatcher

Annulla validità 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

Rimozione della 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

Agente replica

Verificare lo stato di un agente

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

Eliminare un agente

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

Creare un agente

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

Sospendi agente

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

Cancellare una coda agente

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

Communities

Assegnazione e revoca di badge

Per informazioni dettagliate, consultate Punteggio community e Badge .
Per informazioni dettagliate, consulta Punteggio e Badge Essentials .

Reindicizzazione MSRP

Per ulteriori informazioni, vedere MSRP - Provider risorse di storage MongoDB.

Sicurezza

Attivazione e disattivazione di CRX DE Lite

Archivio dati raccolta oggetti inattivi

Per informazioni dettagliate, consultate Raccolta di oggetti inattivi nell'archivio dati.

Integrazione di Analytics e Target

Single Sign On

Invia intestazione test

Per informazioni dettagliate, consultate Single Sign On .

Comandi comuni per la gestione dei contenuti di AEM cURL

Elenco dei comandi AEM cURL per la manipolazione del contenuto.
Gli esempi seguenti presuppongono che AEM sia in esecuzione sulla localhost porta 4502 e utilizzi l’utente admin con password admin . I segnaposto dei comandi aggiuntivi sono impostati tra parentesi angolari.

Gestione pagine

Attivazione pagina

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

Disattivazione pagina

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

Attivazione albero

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

Blocca pagina

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

Sblocca pagina

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

Copia pagina

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

Flussi di lavoro

Contenuto Sling

Create a Folder

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

Eliminare un nodo

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

Sposta un nodo

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

Copiare un nodo

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

Caricare i file tramite Sling PostServlet

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

Caricare i file utilizzando Sling PostServlet e specificando il nome del nodo

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

Caricare i file che specificano un tipo di contenuto

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

Manipolazione risorse

Per informazioni dettagliate, consultate Assets HTTP API .