
Servizio di geoprocessing di ArcGIS Enterprise che pubblica un toolbox Python per l'esecuzione di comandi.
Questo repository contiene una definizione di servizio di geoprocessing ArcGIS che pubblica un toolbox Python come attività di esecuzione di comandi. È destinato a test di sicurezza autorizzati.
Non pubblicare o utilizzare questo servizio su sistemi per i quali non si dispone di esplicita autorizzazione. Un servizio di geoprocessing esegue codice lato server con l'account di servizio di ArcGIS Server, quindi questo progetto può creare un'interfaccia simile a una web-shell verso l'host.
L'artefatto principale è ArcGIS_Shell, un'attività di toolbox Python con un parametro di input:
command
Quando l'attività viene eseguita, il server esegue quel comando tramite la shell del sistema operativo e restituisce il normale output della console attraverso il risultato dell'attività ArcGIS.
Il repository include due file di definizione del servizio ArcGIS precompilati:
ArcGIS_Shell_10.9.1_and_earlier.sd
ArcGIS_Shell_11_or_later.sd
Include anche cartelle di definizione dei servizi estratte:
ArcGIS_Shell_10.9.1_and_earlier/
ArcGIS_Shell_11_or_later/
Queste cartelle contengono i file che ArcGIS impacchetta negli archivi .sd, inclusi i file ArcGIS_Shell.pyt incorporati. Modifica le cartelle estratte quando cambi la definizione del servizio, quindi ricostruisci i file .sd con package_sd.py.
Una definizione di servizio ArcGIS (.sd) è un artefatto di distribuzione impacchettato. Contiene metadati del servizio, configurazione, risorse di toolbox o mappe e i file di supporto necessari ad ArcGIS Server per pubblicare un servizio.
In questo repo, ogni .sd è un archivio 7-Zip che utilizza impostazioni di compressione compatibili con ArcGIS:
-ms=off
-m0=LZMA:d=14
Le due cartelle di definizione del servizio differiscono principalmente per la versione di packaging di ArcGIS:
10.9.1 and earlier: p20 paths, offlineSDVersion10x, ArcGIS 2.9 schema
11 or later: p30 paths, offlineSDVersion11, ArcGIS 3.1 schema
La logica della toolbox Python incorporata è la stessa in entrambi i casi.
I servizi di geoprocessing di ArcGIS vengono normalmente utilizzati per esporre flussi di lavoro di analisi GIS tramite HTTP. Un flusso di lavoro comune è:
Esempi legittimi includono il ritaglio di feature, l'esecuzione di analisi di rete, l'elaborazione di raster, la generazione di report e l'esecuzione di trasformazioni GIS in batch.
La proprietà di sicurezza importante è che le attività di geoprocessing eseguono Python lato server. Se un'attività pubblicata accetta input controllati dall'utente e li passa a primitive pericolose come subprocess.run(..., shell=True), l'attività di geoprocessing diventa un'interfaccia di esecuzione di comandi. È ciò che questo progetto dimostra.
L'attività Shell accetta un parametro stringa denominato command. La toolbox Python esegue quel comando sull'host di ArcGIS Server e restituisce stdout/stderr nel risultato dell'attività.
Ciò significa che un operatore con il permesso di pubblicare o amministrare i servizi di geoprocessing di ArcGIS può creare un servizio simile a una web-shell tramite la normale funzionalità di ArcGIS. Il comando viene eseguito nel contesto di sicurezza dell'account del processo di ArcGIS Server.
Il servizio abilita anche la funzionalità Uploads di ArcGIS. Questo espone gli endpoint di upload del servizio:
/arcgis/rest/services/ArcGIS_Shell/GPServer/uploads
/arcgis/rest/services/ArcGIS_Shell/GPServer/uploads/upload
Gli upload vengono archiviati da ArcGIS Server nella directory di sistema del sito, in genere sotto un percorso simile a:
<arcgisserver>/directories/arcgissystem/arcgisuploads/<itemID>
Il percorso esatto dipende dalla configurazione della directory di ArcGIS Server. Gli amministratori possono visualizzare gli elementi caricati tramite:
https://<server>/arcgis/admin/uploads?f=pjson
Non modificare o eliminare manualmente i file in arcgissystem. Elimina gli elementi caricati tramite REST o la Administrator Directory.
Utilizza il file .sd corrispondente alla versione di ArcGIS di destinazione:
ArcGIS_Shell_10.9.1_and_earlier.sd
ArcGIS_Shell_11_or_later.sd
Flusso tipico di Server Manager:
Apri ArcGIS Server Manager:
https://<server>/arcgis/manager
Accedi con un account autorizzato a pubblicare servizi. Questo in genere include portaladmin.
Vai su Services.
Fai clic su Publish Service.
Carica il file .sd appropriato per la versione di ArcGIS. Fai clic su Next.
Nella pagina "Specify properties for your new service", modifica il nome del servizio se lo desideri. Fai clic su Next.
Nella pagina "Share your services with", non è necessario selezionare alcuna casella. Fai clic su Publish.
Il servizio si avvia automaticamente. Fai clic sul nome del servizio, poi su Capabilities, quindi sull'REST URL.
Per eliminare il servizio, fai clic sulla "X" accanto al nome del servizio.
I file .sd precompilati includono già:
"capabilities": "Uploads"
Includono anche ampie impostazioni di caricamento per i test:
"maxUploadFileSize": "2048",
"allowedUploadFileTypes": "<broad explicit extension list>"
maxUploadFileSize è espresso in MB. L'elenco delle estensioni è intenzionalmente ampio per le attività di assessment, ma rimane comunque un'allowlist esplicita, non un vero carattere jolly "consenti tutto".
Dopo la pubblicazione, aprire il servizio nella ArcGIS REST Services Directory:
https://<server>/arcgis/rest/services/ArcGIS_Shell/GPServer
Se il servizio è pubblicato all'interno di una cartella, includere il nome della cartella:
https://<server>/arcgis/rest/services/<folder>/ArcGIS_Shell/GPServer
Apri l'attività:
https://<server>/arcgis/rest/services/ArcGIS_Shell/GPServer/Shell
Fai clic su Execute Task.
Imposta il tuo comando e invia il modulo. Il risultato dell'attività dovrebbe contenere l'output del comando.
L'output è formattato in JSON, quindi i caratteri di nuova riga sono sottoposti a escape (\r\n). Sarà necessario post-elaborare l'output su più righe.
Poiché l'attività utilizza la shell del sistema operativo, i comandi integrati della shell funzionano:
dir
echo test
whoami /groups
Su target Linux, usa i comandi Linux:
id
uname -a
pwd
Apri la risorsa uploads:
https://<server>/arcgis/rest/services/ArcGIS_Shell/GPServer/uploads
Clicca su Upload Item, oppure vai direttamente a:
https://<server>/arcgis/rest/services/ArcGIS_Shell/GPServer/uploads/upload
La GUI web REST dovrebbe mostrare un selettore di file se i caricamenti sono abilitati.
Usa il modulo per scegliere un file e inviare il caricamento. La risposta include un itemID.
Ispeziona l'elemento caricato con:
https://<server>/arcgis/rest/services/ArcGIS_Shell/GPServer/uploads/<itemID>
Elimina l'elemento caricato con:
https://<server>/arcgis/rest/services/ArcGIS_Shell/GPServer/uploads/<itemID>/delete
Usa il modulo web REST su quella pagina per inviare l'operazione di eliminazione.
Anche i file caricati sono soggetti alla politica di pulizia della directory di sistema di ArcGIS Server. L'età predefinita per la pulizia della directory di sistema è comunemente di 24 ore, ma gli amministratori possono modificarla.