actk-Kommandozeilenreferenz

actk ist das Toolkit auf der Kommandozeile: dieselben Werkzeuge wie in der Desktop-App, für Skripte, geplante Scans und Server ohne Desktop. Laden Sie actk-windows-amd64.exe aus der Übersicht herunter und speichern Sie es als actk.exe in einem Ordner, der im PATH liegt.

actk <befehl> [optionen]
actk <befehl> --help
actk --version

Passwörter werden abgefragt. Für den unbeaufsichtigten Betrieb gibt es zu jedem Passwort eine Option --...-env VAR, die es aus einer Umgebungsvariablen liest. Ein Passwort wird nie als Argument angenommen, wo es in der Shell-Historie und der Prozessliste landen würde.

Exit-Codes: 0 Erfolg; 1 der Befehl lief, das Ergebnis ist aber negativ (ein CSR, den eine CA ablehnen würde, eine fehlgeschlagene Signatur, ein Security Scan, der nicht abgeschlossen wurde, ein abgelehntes Löschen); 2 ein Fehler, etwa eine fehlende Datei oder ein falsches Argument.

Die Ausgabe ist farbig, wenn sie in ein Terminal geht; NO_COLOR schaltet die Farben ab.

actk csrCopy Anchor Link

actk csr --cn <name> [optionen]

Schreibt <name>.csr und <name>.key nach --out-dir, benannt nach dem Common Name (aus www.example.com wird www_example_com). Die Kommandozeile schreibt den Schlüssel immer als Datei; Schlüssel im Windows-Schlüsselspeicher erzeugt die Desktop-App mit CSR erstellen.

# Server-CSR mit SANs und IP, Schlüssel verschlüsselt
actk csr --cn www.example.com --san example.com --ip 10.0.0.15 --org "Example GmbH" `
  --locality München --state Bayern --country DE --key rsa2048 --encrypt-key

# Benutzerzertifikat (S/MIME + Client-Authentifizierung)
actk csr --profile user --cn "Erika Mustermann" --email [email protected] --upn [email protected]

# Selbstsigniertes Code-Signing-Zertifikat zum Testen, mit PFX
actk csr --profile codesign --cn "Example GmbH" --org "Example GmbH" --country DE --key rsa3072 `
  --self-signed --days 365 --pfx

actk decodeCopy Anchor Link

actk decode <datei>

Zeigt Antragsteller, SANs, Schlüssel, beantragte Verwendung, den Besitznachweis und jeden Befund. PEM oder DER. Endet mit 1, wenn ein Befund ein Fehler ist - so kann ein Skript anhalten, bevor es einen Antrag einreicht, den eine CA ablehnen würde. Siehe CSR prüfen.

actk pfxCopy Anchor Link

actk pfx --cert <datei> --key <datei> --out <datei> [optionen]

Der Schlüssel wird gegen das Zertifikat geprüft, bevor etwas geschrieben wird.

actk pfx --cert issued.pem --chain intermediate.pem --key www_example_com.key --out www.pfx

actk exportCopy Anchor Link

actk export --cert <datei> | --pfx <datei> [ausgaben] [optionen]

actk export --cert issued.pem --chain intermediate.pem --cer www.cer --fullchain fullchain.pem
actk export --pfx from-iis.pfx --crt www.crt --chain-out chain.pem --key-out www.key

actk signCopy Anchor Link

actk sign <dateien...> --thumbprint <sha1> | --pfx <datei> [optionen]

Jede Datei wird nach dem Signieren geprüft, mit denselben Exit-Codes wie actk verify. Nur Windows.

actk sign Setup.exe deploy.ps1 package.msi --thumbprint 0123ABCD...
actk sign tool.exe --pfx codesign.pfx --timestamp http://timestamp.sectigo.com

actk verifyCopy Anchor Link

actk verify <dateien...>

Zeigt Signaturstatus, Signierer und Zeitstempel jeder Datei. Endet mit 1, wenn eine Datei nicht signiert ist, nach dem Signieren verändert wurde oder Windows einen Fehler meldet; eine gültige Signatur, deren Stamm dieser Computer nicht vertraut, wird angezeigt, gilt aber nicht als Fehler. Nur Windows.

actk certsCopy Anchor Link

actk certs

Listet die Zertifikate, mit denen Windows Code signieren kann - Zweck „Codesignatur“ und ein privater Schlüssel, im Speicher des Benutzers und des Computers, einschließlich USB-Token und HSM - mit ihren Fingerabdrücken für actk sign. Nur Windows.

actk storeCopy Anchor Link

actk store list [--machine]
actk store import <datei> [--key <datei>] [optionen] [--machine]
actk store export <fingerabdruck> [ausgaben] [optionen] [--machine]
actk store delete <fingerabdruck> [--yes] [--machine]

Der persönliche Speicher des aktuellen Benutzers (CurrentUser\My) oder mit --machine der des Computers (LocalMachine\My). Änderungen am Computerspeicher erfordern eine Eingabeaufforderung mit Administratorrechten. Nur Windows.

import - ein ausgestelltes Zertifikat (.cer, .crt, .pem, .p7b) mit dem Schlüssel aus actk csr, oder eine .pfx/.p12. Zwischenzertifikate kommen unter Zwischenzertifizierungsstellen; ein Stammzertifikat wird nie installiert.

export - ein Zertifikat per Fingerabdruck, mit Kette, und mit Schlüssel für --pfx und --key-out.

delete - entfernt das Zertifikat und seinen privaten Schlüssel. Fragt nach, sofern nicht --yes angegeben ist.

actk store list
actk store import issued.p7b --key www_example_com.key
actk store export 0123ABCD... --pfx www.pfx --fullchain fullchain.pem
actk store delete 0123ABCD...

actk scanCopy Anchor Link

actk scan <ziele...> [optionen]

Ziele sind Hosts, CIDR-Netze (bis /16) und Bereiche: 10.0.0.0/24, 10.0.0.10-50, srv01.corp.local. Höchstens 65.536 Adressen und 262.144 Prüfungen pro Scan.

actk scan 10.0.0.0/24 10.0.1.10-50 srv01.corp.local -p 443,636,3389,8443 `
  --csv inventory.csv --json inventory.json

Siehe Zertifikatscanner.

actk securityCopy Anchor Link

actk security <ziel> [optionen]

Das Ziel ist host, host:port oder https://host:port/pfad.

actk security intranet.corp.local:8443 --json report.json
actk security 10.0.0.25:25           # SMTP STARTTLS, am Port erkannt

Endet mit 1, wenn der Scan nicht abgeschlossen werden konnte. Siehe Security Scan.