Installare Aggrega
Aggrega richiede due cose: il binario aggrega installato e, per scrivere con un assistente di IA, il client del tuo assistente collegato al server MCP che il binario contiene. Prima vengono i comandi; seguono cosa fa ciascuno e gli altri modi di installare.
Installare il binario
Su Linux e macOS, in un terminale:
curl -fsSL https://aggrega.ai/install.sh | shSu Windows, in PowerShell:
irm https://aggrega.ai/install.ps1 | iexCon Homebrew, su macOS e Linux:
brew install aggrega-ai/tap/aggregaCon Scoop, su Windows:
scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucketscoop install aggregaCon winget, su Windows:
winget install Cognitio.AggregaPoi verifica che funzioni:
aggrega versionUna stringa di versione significa che il binario viene trovato ed è eseguibile. È tutto ciò che serve al server MCP. Ogni modo di installare, in dettaglio spiega cosa fa ogni comando, dove mette il binario e come installare con il programma di installazione per Windows o a mano.
Collegare un client MCP
Il client del tuo assistente di IA avvia il server MCP di Aggrega eseguendo aggrega mcp, e Collegare il server MCP indica il comando o la voce che lo aggiunge, client per client. In un assistente che installa plugin, il plugin di Aggrega aggiunge il server e la skill di Aggrega in un solo passaggio: vedi Installare il plugin.
Ogni modo di installare, in dettaglio
Aggrega viene distribuito come un singolo eseguibile. Un solo comando lo installa; i passaggi manuali che seguono fanno lo stesso a mano. Entrambi lo mettono in una cartella tua, sempre la stessa, e nessuno dei due richiede diritti di amministratore: ~/.local/bin/aggrega su Linux e macOS, e %LOCALAPPDATA%\Programs\aggrega\aggrega.exe su Windows. Su Windows, il programma di installazione per Windows e winget lo installano nella stessa cartella, anch’essi senza diritti di amministratore, e lo elencano tra le app installate: consulta Installare con il programma di installazione per Windows e Installare con winget. Anche Homebrew, su macOS e Linux, e Scoop, su Windows, lo installano, ciascuno nelle proprie cartelle: consulta Installare con un gestore di pacchetti.
Installare con un solo comando
Il comando di installazione è curl -fsSL https://aggrega.ai/install.sh | sh su Linux e macOS e irm https://aggrega.ai/install.ps1 | iex in PowerShell su Windows, i primi due comandi di Installare il binario. Questi due indirizzi reindirizzano agli script di installazione allegati all’ultima release, quindi gli stessi comandi funzionano anche con gli indirizzi della release stessa:
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.sh | shirm https://github.com/aggrega-ai/aggrega-cli/releases/latest/download/install.ps1 | iexChe cosa fa il comando:
- Sceglie il binario predefinito per la tua macchina dall’ultima release: Linux e macOS su x86 a 64 bit o ARM a 64 bit, Windows su x86 a 64 bit. Rifiuta qualsiasi altro sistema o processore con un messaggio che dice quale ha trovato o a cosa rivolgersi invece. Su un Mac con Apple silicon sceglie il binario Apple silicon, anche da una shell eseguita tramite Rosetta 2.
- Verifica il binario rispetto al
SHA256SUMSdella release prima di installare qualsiasi cosa. Un download il cui digest SHA-256 differisce da quello indicato nell’elenco viene eliminato, non viene installato nulla e il comando si interrompe con un messaggio che nomina entrambi i digest. - Installa il binario solo per te, come
~/.local/bin/aggregasu Linux e macOS e come%LOCALAPPDATA%\Programs\aggrega\aggrega.exesu Windows, creando la cartella se manca e sostituendo in un solo passaggio una copia precedente presente lì, così eseguire di nuovo il comando aggiorna quella che hai. Non usa maisudo. Su Windows rimuove anche il contrassegno che può portare un file scaricato da internet, come faUnblock-Filenei passaggi manuali. Su macOS scarica concurl, quindi il binario che installa non porta alcun contrassegno di quarantena (consulta Il binario precompilato per macOS). - Rende il comando raggiungibile. Su Linux e macOS, quando la cartella non è nel tuo
PATH, stampa un comando che aggiunge la cartella al file che la tua shell legge all’avvio:~/.zshrcper zsh,~/.bashrcper bash (~/.bash_profilesu macOS),~/.config/fish/config.fishper fish, con una rigafish_add_path, e~/.profileper qualsiasi altra shell. Non esegue da sé quel comando: eseguilo e apri un nuovo terminale. Su Windows aggiunge la cartella alPATHdel tuo utente quando non c’è, e alPATHdella finestra PowerShell in cui viene eseguito, cosìaggregafunziona in quella finestra e in ogni terminale aperto dopo, e segnala di aver aggiunto la cartella. - Verifica che il binario installato si avvii, e si ferma con un messaggio prima di configurare qualsiasi altra cosa quando non si avvia. Aggiunge una nota quando un altro
aggregaprecede nel tuoPATHquello che ha installato. - Stampa la versione installata, eseguendo tramite il suo percorso completo il binario che ha installato, così la versione compare ancora prima che il tuo
PATHincluda la cartella. - Termina con i passi successivi, sotto
Next:, una riga ciascuno: il comando che esegue il quickstart di IA, come descrive Primi passi;aggrega skills install --global, che aggiunge la skill di Aggrega agli assistenti di IA sulla tua macchina, come descrive Aggiungere la skill dell’assistente durante l’installazione; e l’indirizzo di questa pagina, per il completamento della shell e per Collegare un client MCP qui sopra. Quando un’opzione ha già installato la skill, la sua riga viene omessa.
Ciò che stampa è breve: la versione e il sistema per cui installa, una riga quando il download corrisponde al suo checksum, e il percorso in cui ha installato. Primi passi mostra un’esecuzione completa. --verbose, passato dopo sh -s -- come le opzioni qui sotto, stampa anche l’indirizzo dell’elenco dei checksum, il nome del file della release e l’indirizzo da cui lo scarica; install.ps1 ha lo stesso switch come -Verbose, per un’esecuzione dello script con argomenti, che irm … | iex non può fornirgli. Quando il comando rifiuta o un passo fallisce, lo dice in una riga, sullo standard error da install.sh e come l’errore o l’avviso che PowerShell mostra da install.ps1:
aggrega install: error: <what went wrong> - <what to do>install.sh, lo script per Linux e macOS, richiede curl o wget, uname, e sha256sum o shasum. install.ps1, quello per Windows, funziona in Windows PowerShell 5.1 e in PowerShell 7.
Due impostazioni cambiano ciò che installa, ciascuna letta dall’ambiente in cui viene eseguito lo script:
AGGREGA_VERSIONnomina la release da installare, come0.8.7, scritta con o senza laviniziale. Se non è impostata, il comando installa l’ultima release — quella che GitHub contrassegna come più recente, che non è mai una prerelease, quindi una prerelease viene installata solo nominandola qui.AGGREGA_INSTALL_DIRnomina la cartella in cui installare al posto di quella predefinita. Il binario lì èaggrega,aggrega.exesu Windows, e il comando rende quella cartella raggiungibile come sopra.
Su Linux e macOS, metti l’impostazione prima di sh, non prima di curl, così che lo script la riceva:
curl -fsSL https://aggrega.ai/install.sh | AGGREGA_VERSION=<version> shIn PowerShell, impostala prima nella finestra; resta impostata lì finché non la rimuovi con Remove-Item Env:AGGREGA_VERSION:
$env:AGGREGA_VERSION = "<version>"irm https://aggrega.ai/install.ps1 | iexConfigurare il completamento della shell durante l’installazione
Con --completion, install.sh configura anche il completamento della shell, in modo che il tasto Tab completi i comandi e i flag di aggrega. Le opzioni vanno dopo sh -s --, che le passa allo script che sh legge dalla pipe:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completionirm … | iex non passa alcuna opzione a uno script. In PowerShell, configura il completamento una volta terminata l’installazione, con lo script che scrive aggrega completion powershell, come descrive Completamento della shell. Anche install.ps1 accetta -Completion, per un’esecuzione dello script con argomenti.
Configura il completamento solo per te, senza diritti di amministratore, per la shell indicata dalla tua impostazione SHELL, o in PowerShell per il PowerShell in cui viene eseguito. Usa lo script che scrive aggrega completion del binario installato, e nomina ogni file che scrive o modifica:
- bash: scrive lo script in
~/.local/share/bash-completion/completions, la cartella da cui il pacchetto bash-completion legge i tuoi completamenti. Il completamento bash peraggregarichiede quel pacchetto. - zsh: scrive
_aggregain~/.local/share/zsh/site-functionse aggiunge a~/.zshrctre righe che mettono quella cartella nel percorso delle funzioni di zsh e lo caricano, eseguendocompinitdove nulla nel file lo ha eseguito prima. - fish: scrive
aggrega.fishin~/.config/fish/completions, che fish legge da sé. - PowerShell: scrive lo script come
%LOCALAPPDATA%\aggrega\completion.ps1e aggiunge due righe che lo caricano al tuo profilo per ogni host del PowerShell in cui viene eseguito,$PROFILE.CurrentUserAllHosts. Windows PowerShell e PowerShell 7 hanno profili separati, quindi eseguilo da ciascuno di quelli che usi. Un profilo viene eseguito solo dove il criterio di esecuzione che assume una nuova finestra èRemoteSigned,UnrestrictedoBypass; con qualsiasi altro, comeRestricted, non scrive nulla e dice quale criterio ha trovato. Non modifica mai il criterio.
XDG_DATA_HOME, XDG_CONFIG_HOME, BASH_COMPLETION_USER_DIR e ZDOTDIR spostano quelle cartelle e quei file così come li legge ciascuna shell. Un nuovo terminale o una nuova finestra carica il completamento. Eseguire di nuovo il comando riscrive uno script solo quando l’aggrega installato ne scrive uno diverso, e aggiunge le righe a ~/.zshrc o al profilo una sola volta; è anche il modo per aggiungere il completamento a un’installazione che hai già, poiché il comando reinstalla il binario lungo il percorso.
Aggiungere la skill dell’assistente durante l’installazione
Con --skills (-Skills in PowerShell), il comando di installazione installa anche la skill di Aggrega — le istruzioni che insegnano a un assistente di IA a installare e usare Aggrega — in ogni tuo progetto, per gli assistenti di IA sulla tua macchina. Le due opzioni possono essere date insieme:
curl -fsSL https://aggrega.ai/install.sh | sh -s -- --completion --skillsIn PowerShell, dove irm … | iex non passa alcuna opzione, esegui aggrega skills install --global una volta terminata l’installazione: è il comando che esegue -Skills.
Esegue aggrega skills install --global del binario installato, che cerca gli assistenti sulla tua macchina — ciascuno la cui cartella di configurazione si trova nella tua directory home, o il cui comando è nel tuo PATH — e stampa ciascuno di quelli che ha trovato e cosa lo ha trovato. Poi:
- In un terminale, chiede prima. Premi Invio per installare la skill per gli assistenti trovati, oppure digita gli identificatori di altri per aggiungerli, separati da spazi o virgole;
aggrega skills liststampa gli identificatori. Concurl … | shlo script legge sé stesso dalla pipe, quindi chiede invece tramite il tuo terminale. - Senza un terminale tramite cui chiedere, come in uno script, installa per gli assistenti che ha trovato.
- Per scegliere tu gli assistenti, indicali dopo l’opzione, separati da virgole:
--skills claude-code,cursor, oppure--skills=claude-code,cursor, e in PowerShell-Skills claude-code,cursor. Installa quindi per quelli e non ne cerca altri.
Stampa ogni cartella di skill che scrive, come ~/.claude/skills/aggrega per Claude Code, tutte sotto la tua directory home. Eseguire di nuovo il comando sostituisce le copie scritte da un’esecuzione precedente, ed è così che la skill segue il binario a una versione più recente. aggrega skills descrive il comando, la cartella che legge ogni assistente e cosa trova ciascuno.
Quando un passo non può essere compiuto
Quando il completamento non può essere configurato — una shell che non configura, come dash, una cartella in cui non può scrivere, o un criterio di esecuzione di PowerShell che non esegue alcun profilo — o la skill non può essere installata — nessun assistente trovato e nessuno indicato, un identificatore che non conosce, o un file in una cartella di skill che non è stato scritto da un’installazione — il binario è comunque installato e funziona. Il comando dice perché il passo è fallito, stampa i passi successivi e termina con uno stato che dice quale passo è fallito. Gli stati sono:
| Stato | Significato |
|---|---|
0 | aggrega è installato, e ogni passo richiesto da un’opzione è riuscito |
1 | non è stato installato nulla, oppure l’aggrega installato non è stato eseguito |
2 | al comando è stata data un’opzione che non accetta, o un elenco che non nomina alcun assistente; non ha fatto nulla |
3 | aggrega è installato e funziona, ma la configurazione del completamento della shell non è riuscita |
4 | aggrega è installato e funziona, ma l’installazione della skill non è riuscita |
5 | aggrega è installato e funziona, ma entrambe queste operazioni non sono riuscite |
Lo script PowerShell non chiude mai la finestra in cui viene eseguito, quindi lascia lo stato in $LASTEXITCODE, e ogni stato diverso da 0 termina con un errore, che powershell -Command e pwsh -Command riportano come stato di uscita 1.
Installare con il programma di installazione per Windows
Ogni release include un programma di installazione per Windows, aggrega-<version>-windows-amd64-setup.exe, nella pagina della release su https://github.com/aggrega-ai/aggrega-cli/releases. Scaricalo ed eseguilo. Installa il aggrega.exe predefinito solo per te, senza diritti di amministratore e senza chiederli, tramite una breve procedura guidata:
- Una pagina di benvenuto, poi la licenza, la Apache License 2.0 di Aggrega: non viene installato nulla finché non premi I Agree. Poi i componenti: Aggrega stesso, sempre installato, e Add to PATH, selezionato.
- La cartella di installazione,
%LOCALAPPDATA%\Programs\aggregaa meno che tu non ne scelga un’altra; è la cartella usata dal comando di installazione. - L’avanzamento, poi una pagina finale che indica la cartella e dice se questa installazione l’ha aggiunta al tuo
PATH, con i passi successivi: installare la skill di Aggrega conaggrega skills install --globale collegare il tuo client di IA come descrive Collegare un client MCP.
Che cosa fa:
- Con Add to PATH selezionato, aggiunge la cartella di installazione al
PATHdel tuo utente a meno che non ci sia già. Un terminale aperto dopo l’installazione trovaaggrega; uno già aperto mantiene ilPATHcon cui è stato avviato. Con l’opzione deselezionata, al tuoPATHnon viene aggiunto nulla e un terminale esegueaggrega.exetramite il suo percorso completo; una voce aggiunta da un’installazione precedente resta com’è. - Elenca Aggrega tra le app installate, con editore Cognitio s.r.l., quindi si disinstalla da Settings → Apps come qualsiasi altra app. Il programma di disinstallazione ti chiede di confermare, poi rimuove i file che il programma di installazione ha messo nella cartella, la voce del
PATHe la voce in quell’elenco, e rimuove la cartella quando non vi resta nient’altro. - Eseguito di nuovo, installa sopra ciò che c’è, proponendo la cartella in cui ha installato l’ultima volta, quindi il programma di installazione di una release successiva aggiorna la copia che hai, mantenendo una sola voce nel tuo
PATH. - Accanto a
aggrega.exe, la cartella contieneuninstall.exe,LICENSEcon il testo della licenza eEnVar.dll, il componente con cui il programma di installazione e quello di disinstallazione modificano il tuoPATH.
Quando aggrega.exe è in esecuzione — avviato da un editor o da un client IA — il programma di installazione non può sostituirlo e si interrompe con un messaggio che lo dice; chiudi ciò che lo ha avviato ed esegui di nuovo il programma di installazione. Il programma di disinstallazione si interrompe allo stesso modo, prima di aver rimosso qualcosa.
Per installare senza finestre, da uno script o da uno strumento che installa software su molte macchine, esegui il programma di installazione con /S, scritto in maiuscolo; installa allora senza finestra né domande, nella cartella usata da un’installazione precedente o altrimenti in quella predefinita, con Add to PATH, e segnala un errore tramite il suo codice di uscita, che non è 0. Il programma di disinstallazione accetta la stessa opzione:
.\aggrega-<version>-windows-amd64-setup.exe /S& "$env:LOCALAPPDATA\Programs\aggrega\uninstall.exe" /SIl programma di installazione è firmato come gli eseguibili, con l’editore Cognitio S.r.l. e un timestamp: le verifiche in Il binario precompilato per Windows si applicano a esso come ad aggrega.exe, e così anche ciò che lì si dice sulle richieste che Windows può mostrare per un file scaricato. SHA256SUMS ne elenca il digest come fa per ogni altro file della release.
Dove il programma di installazione non è adatto, il comando di installazione sopra e i passaggi manuali installano lo stesso aggrega.exe nella stessa cartella.
Installare con un gestore di pacchetti
Ogni release aggiorna anche una formula Homebrew e un manifest Scoop, così il gestore di pacchetti che già usi può installare Aggrega e mantenerlo aggiornato. Ciascuno installa lo stesso binario predefinito del comando di installazione, verificato rispetto al digest SHA-256 che gli assegna il SHA256SUMS della release.
Su macOS e Linux, brew install aggrega-ai/tap/aggrega lo installa con Homebrew. Homebrew aggiunge il tap aggrega-ai/tap la prima volta e installa il binario per il tuo sistema e processore: macOS su Apple silicon o su Intel, Linux su x86 a 64 bit o su ARM a 64 bit. Dopo una nuova release, brew upgrade lo aggiorna, insieme a ogni altra formula che hai installato.
Su Windows, con Scoop, aggiungi una volta il bucket di Aggrega, con scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket, e installa da esso con scoop install aggrega. Scoop installa il binario per Windows come aggrega.exe e lo rende raggiungibile come aggrega tramite la cartella degli shim che mantiene nel tuo PATH. Dopo una nuova release, scoop update aggiorna i bucket e scoop update aggrega lo aggiorna.
Homebrew e Scoop installano ciascuno nelle proprie cartelle anziché in ~/.local/bin o in %LOCALAPPDATA%\Programs\aggrega, e aggiornano solo la copia che hanno installato. Usa un solo modo di installazione su una macchina: una copia installata dal comando di installazione o a mano e un’altra installata da Homebrew o Scoop sono due copie, e la cartella che viene prima nel tuo PATH decide quale viene eseguita.
Installare con winget
Su Windows, winget install Cognitio.Aggrega lo installa con winget, il Windows Package Manager. winget scarica il programma di installazione per Windows della release dalla sua pagina della release, lo verifica rispetto al digest SHA-256 indicato dal manifest del pacchetto e lo esegue senza intervento. Il risultato è quello del programma di installazione stesso: aggrega.exe in %LOCALAPPDATA%\Programs\aggrega, o nella cartella usata da un’installazione precedente, quella cartella nel PATH del tuo utente e Aggrega nell’elenco delle app installate, il tutto senza diritti di amministratore. winget non modifica il PATH del terminale in cui viene eseguito, quindi apri un nuovo terminale prima di eseguire aggrega version.
winget upgrade Cognitio.Aggrega installa sopra di esso una release successiva, e winget uninstall Cognitio.Aggrega ne esegue il programma di disinstallazione. winget, il programma di installazione e il comando di installazione installano tutti nella stessa cartella, a meno che tu non ne scelga un’altra nel programma di installazione, quindi quello eseguito per ultimo vi mette il proprio aggrega.exe.
Installarlo a mano
Ogni release include binari precompilati per Linux su x86 a 64 bit e su ARM a 64 bit, per Windows su x86 a 64 bit e per macOS su Apple silicon e su Intel, nella pagina della release su https://github.com/aggrega-ai/aggrega-cli/releases. Scarica l’eseguibile per il tuo sistema operativo e processore — Scegliere il file più sotto li nomina tutti — e verificalo rispetto al SHA256SUMS della release, come descritto lì. Poi rendilo eseguibile e spostalo in ~/.local/bin/aggrega. Su Linux, dalla directory in cui si trova il download, con <version> sostituito dalla versione che hai scaricato, e amd64 con arm64 su ARM a 64 bit:
chmod +x aggrega-<version>-linux-amd64mkdir -p ~/.local/binmv aggrega-<version>-linux-amd64 ~/.local/bin/aggregaSu Windows, consulta Il binario precompilato per Windows più sotto; su macOS, consulta Il binario precompilato per macOS.
Quando ~/.local/bin non è nel tuo PATH, aggiungi questa riga al file che la tua shell legge all’avvio — ~/.zshrc per zsh, ~/.bashrc per bash (~/.bash_profile su macOS) — e apri un nuovo terminale:
export PATH="$HOME/.local/bin:$PATH"Dai sorgenti, con una toolchain Go installata, compila il comando aggrega dall’albero dei sorgenti e metti il binario risultante nella stessa cartella.
Conferma l’installazione con aggrega version, come alla fine di Installare il binario.
Scegliere il file
Una release nomina ogni eseguibile aggrega-<version>-<system>-<processor>, con .exe su Windows:
| Sistema | Processore | File |
|---|---|---|
| Linux | x86 a 64 bit (uname -m stampa x86_64) | aggrega-<version>-linux-amd64 |
| Linux | ARM a 64 bit (uname -m stampa aarch64) | aggrega-<version>-linux-arm64 |
| Windows | x86 a 64 bit | aggrega-<version>-windows-amd64.exe |
| macOS | Apple silicon | aggrega-<version>-darwin-arm64 |
| macOS | Intel | aggrega-<version>-darwin-amd64 |
Quel file è quello che installa il comando di installazione, e quello da scaricare a mano. Accanto a esso si trovano due sue varianti; il comando di installazione non installa nessuna delle due, e ciascuna si installa a mano allo stesso modo:
aggrega-debug-<version>-…è lo stesso programma con le sue informazioni di debug, che un debugger o un profiler legge. Si esegue e riporta la propria versione esattamente come il file predefinito, ed è più grande.aggrega-light-<version>-…è compilato senza i plugin incorporati: risolve ogni plugin attraverso la cascata dei plugin, come la configura il workspace, anziché trovare quelli core al proprio interno.
Per Windows la release include anche aggrega-<version>-windows-amd64-setup.exe, il programma di installazione per Windows, che installa il file predefinito per te.
Ogni release include anche SHA256SUMS, il digest SHA-256 di ogni altro file che allega, compresi i due script di installazione, nella forma che legge sha256sum. Il comando di installazione esegue questa verifica da sé. Per verificare a mano un download su Linux, con SHA256SUMS nella stessa directory:
sha256sum --check --ignore-missing SHA256SUMSIl file che hai scaricato viene riportato come OK; qualsiasi altro esito significa che non è il file pubblicato dalla release.
Il binario precompilato per Windows
L’eseguibile per Windows è aggrega-<version>-windows-amd64.exe (le varianti debug e light accanto a esso nella release si installano allo stesso modo). Rinominalo in aggrega.exe, spostalo in %LOCALAPPDATA%\Programs\aggrega, la cartella usata dal comando di installazione, e aggiungi quella cartella al PATH del tuo utente: Windows esegue un file che termina in .exe senza doverlo contrassegnare come eseguibile, e lo trova come comando aggrega con quel nome. Da PowerShell, ad esempio, con <version> sostituito dalla versione che hai scaricato:
$dir = "$env:LOCALAPPDATA\Programs\aggrega"New-Item -ItemType Directory -Force $dir | Out-NullMove-Item ".\aggrega-<version>-windows-amd64.exe" "$dir\aggrega.exe"Unblock-File "$dir\aggrega.exe"[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")Un terminale aperto dopo quel passaggio trova aggrega; uno già aperto mantiene il PATH con cui è stato avviato.
Gli eseguibili sono firmati. Ciascuno porta una firma Authenticode, la firma del codice che Windows controlla, e l’editore che Windows mostra per essa è Cognitio S.r.l. Ogni firma porta anche una marca temporale: il certificato dietro una firma è valido solo per pochi giorni, e la marca temporale è ciò che mantiene valida la firma dopo la scadenza di quel certificato. Per controllare un file scaricato prima di eseguirlo:
-
In Esplora file, apri le Properties del file e la sua scheda Digital Signatures. L’elenco delle firme riporta Cognitio S.r.l.; selezionala e poi Details, che riporta This digital signature is OK.
-
In PowerShell, con
$dircome nell’esempio sopra:Terminal window $signature = Get-AuthenticodeSignature "$dir\aggrega.exe"$signature.Status$signature.SignerCertificate.SubjectStatusriportaValid, e il soggetto inizia conCN=Cognitio S.r.l..NotSignedoHashMismatchsignifica che il file non è quello pubblicato dalla release, oppure che è stato modificato dopo la firma.
Una firma indica l’editore; non fa sparire ogni avviso. Quale incontri dipende da come è arrivato il file e da come lo avvii:
- Durante il download, un browser può avvisare che il file non viene scaricato comunemente e chiedere se conservarlo. Conservarlo salva il file così come è stato scaricato.
- Quando lo avvii da Esplora file o dal browser, Windows può mostrare Windows protected your PC. Quel messaggio proviene da Microsoft Defender SmartScreen, che valuta la reputazione costruita da un file e dal suo editore, perciò una versione appena rilasciata può ancora incontrarlo, pur essendo firmata, finché non si costruisce una reputazione propria. Per un file firmato il messaggio indica l’editore: seleziona More info, verifica che indichi Cognitio S.r.l. e il nome del file che hai scaricato, quindi seleziona Run anyway. Avviato invece da PowerShell o da un prompt dei comandi, lo stesso file può essere eseguito senza quel messaggio; che ciò accada dipende dalla versione di Windows e dalle sue impostazioni.
Unblock-Filerisponde in anticipo a quel messaggio. Un file scaricato è contrassegnato come proveniente da internet, ed è a quel contrassegno che risponde il controllo Windows protected your PC.Unblock-Filein PowerShell, come nell’esempio sopra, rimuove il contrassegno; lo stesso fa la casella Unblock nella scheda General delle Properties del file in Esplora file.- Dove Smart App Control è attivo (Windows 11), controlla un programma quando lo avvii. Come lo descrive Microsoft, Smart App Control chiede prima al servizio di sicurezza cloud di Microsoft se il programma è sicuro; quando quel servizio non riesce a fare una previsione affidabile, controlla la firma, lasciando eseguire un programma con una firma valida e bloccandone uno non firmato o con una firma non valida. Se è attivo lo mostra App & browser control in Sicurezza di Windows.
Il binario precompilato per macOS
Gli eseguibili per macOS sono aggrega-<version>-darwin-arm64, per un Mac con Apple silicon, e aggrega-<version>-darwin-amd64, per un Mac con processore Intel; About This Mac nel menu Apple mostra quale hai. Le varianti debug e light accanto a essi nella release si installano allo stesso modo. Un Mac con Apple silicon esegue anche il file Intel, tramite Rosetta 2 dove è installato, ma il file Apple silicon è quello compilato per esso.
Rinomina il file in aggrega, rendilo eseguibile e spostalo in ~/.local/bin, la cartella usata dal comando di installazione. Dal Terminale, nella directory in cui si trova il download, ad esempio, con <version> sostituito dalla versione che hai scaricato e arm64 con amd64 su un Mac Intel:
chmod +x aggrega-<version>-darwin-arm64mkdir -p ~/.local/binmv aggrega-<version>-darwin-arm64 ~/.local/bin/aggregaIl mkdir crea la cartella dove non esiste ancora. ~/.local/bin non è nel PATH che macOS assegna a un nuovo terminale, quindi aggiungi la riga di Installarlo a mano a ~/.zshrc, o a ~/.bash_profile per bash, a meno che non ci sia già.
Gli eseguibili sono firmati e notarizzati. Ciascuno porta una firma del codice realizzata con il Developer ID di Cognitio s.r.l. — il certificato che Apple rilascia a uno sviluppatore per il software distribuito al di fuori del Mac App Store — con il runtime rafforzato e un timestamp sicuro, e il servizio di notarizzazione di Apple ha verificato e notarizzato ciascuno di essi. Gatekeeper, il controllo di macOS sul software proveniente da internet, valuta un programma che porta il contrassegno di quarantena, il contrassegno che un browser web aggiunge a un file che scarica, e ne accetta uno che Apple ha notarizzato, quindi un file scaricato dalla pagina della release si esegue così com’è. Un ticket di notarizzazione non può essere allegato a un singolo file eseguibile, quindi Gatekeeper trova il ticket online la prima volta che il file viene eseguito; su un Mac che in quel momento è offline, Gatekeeper può bloccare il file finché il Mac non riesce a raggiungere Apple.
Per verificare un file scaricato prima di eseguirlo, dal Terminale, con il nome del file che hai scaricato:
codesign --verify --strict --verbose=2 aggrega-<version>-darwin-arm64codesign --display --verbose=2 aggrega-<version>-darwin-arm64Il primo riporta che il file è valid on disk e satisfies its Designated Requirement. Il secondo elenca le autorità della firma, la prima delle quali è Developer ID Application: COGNITIO SRL seguita dall’identificativo del team tra parentesi, e un Timestamp. Un file che non supera l’uno o l’altro non è quello pubblicato dalla release, o è stato modificato dopo essere stato firmato.
Un file scaricato con curl non porta alcun contrassegno di quarantena, quindi Gatekeeper non lo valuta affatto: curl non aggiunge il contrassegno che aggiunge un browser. È anche per questo che il binario messo al suo posto dal comando di installazione viene eseguito senza quella valutazione.