Import infrastructure inventory data into PrivX from CSV and other external sources.
The tool normalizes imported records, validates them, compares the desired state against current PrivX configuration, and produces a safe execution plan before applying changes.
- CSV-based inventory import
- Configurable field catalog
- Structured and nested field support
- Validation and normalization pipeline
- Safe plan/apply workflow
- Scope-restricted updates
- PrivX API integration
- Human ↔ machine value translators
📖 Usage Guide — Setup, authentication, commands, and examples.
🏗️ Architecture — Detailed diagrams of data flow and components.
📖 Documentation Index — Architecture, development, and technical documentation.
Input files
-> normalize
-> validate
-> build target specification
-> fetch current PrivX state
-> create change plan
-> apply changes
go run cmd/privx-import/main.go plan testdata/simple.csvgo run cmd/privx-import/main.go apply testdata/simple.csv- PrivX API is strict about format, so if PrivX complains of a misformed request, it is up to the user to check that the values are exactly in the right format in the CSV.
- switching to delete mode will not delete hosts that are already disabled.
- if a host has new services, principals or other multivalue list items added manually in PrivX between already existing ones, the update can corrupt those lines.
This is a public open-source project licensed under Apache 2.0 and not covered by standard support SLA. Community feedback and contributions are welcome. Support is provided on a best-effort basis only. For dedicated support, customisations, or enterprise assistance, please raise a ticket via our support portal ( https://care.ssh.com) or via your local support partner. Any requests would be assigned to your account manager.