Guides
Learn how to use Piiano Vault
Follow our step-by-step guide to get started with Piiano Vault, or level up your skills with the following guides.
Get started
In the cloud
Discover Piiano Vault basics in a cloud sandbox using the REST API
On your computer
Learn the Piiano Vault basics on your computer using the CLI and create collections, add data, use tokens, and make queries that return transformed data.
Install
Run in Piiano SaaS
Learn how to run a fully managed instance of Piiano Vault and use the SaaS Console.
Requirements (self-hosted)
Learn about the software and hardware requirement for installing and running Piiano Vault for development and production.
Install (self-hosted)
Learn how to self-host Piiano Vault by installing an edition from a pre-built, publicly available Docker image.
Develop
Official SDKs
Get links to the Piiano Vault client SDKs for Java, TypeScript, and ORM and instructions on how to generate an SDK for other languages.
ORM SDKs
Learn how to use a Piiano Vault Object Relational Mapping (ORM) client for a language of your choice.
Auto-generate SDKs
Learn how Piiano Vault provides for auto-generating an SDK that you can integrate with your codebase.
Manage collections and schemas
About collections
Learn about collections, the mechanism for defining and storing personal and sensitive data in Piiano Vault.
Create a collection
Learn how to create different types of collections in Piiano Vault to store personal and other sensitive data.
List collections
Learn how to list the collections in Piiano Vault using the CLI or REST API.
Write and read personal data
About objects
Learn about the personal data objects Piiano Vault uses to hold data values for records within a collection.
Add an object
Learn how to add an object in Piiano Vault to store personal or sensitive data values in a collection.
Retrieve an object
Learn how to retrieve a personal data object from a collection in Piiano Vault using the CLI or REST API.
Tokenize personal data
About tokens
Learn how Piiano Vault provides personal data tokens so you can send a non-sensitive reference to a value instead of the actual data.
Create a token
Learn how to create tokens in Piiano Vault to send a non-sensitive reference to a value instead of the actual data.
Retrieve a token
Learn how to retrieve token data from Piiano Vault using token IDs, object IDs, and tags you added to tokens.
Use third-party services
About the http_call action
Learn about the http_call action Piiano Vault provides so you can call trusted third-party services with least privilege access.
Use the http_call action
Learn how to send HTTP requests to third-party services using the `http_call` action provided in Piiano Vault.
Create custom data types
Create a data type
Learn how to create a custom data type to store business-specific personal and other sensitive data in collections in Piiano Vault.
Resources
Discover the resources available to can help you create robust and maintainable a custom data types in Piiano Vault.
Manage transformations
About transformations
An overview of transformations, a mechanism to present the data held in Piiano Vault in a way that reduces data exposure.
Built-in transformations
Learn about the mask, size, and token transformations built into Piiano Vault, including examples of their effect.
Manage users and policies
How IAM work
Learn about Piiano Vault's identity and access management (IAM), the feature Vault uses to govern access to APIs and data.
Update the IAM configuration
Learn how to update the users, roles, and policies of the Piiano Vault IAM configuration using its TOML file from this step-by-step guide.
Define users
Learn how to define a user with a role as part of the Piiano Vault identity and access management (IAM) configuration.
Backup and restore
Important precautions for your data
Learn about important precautions in relation to backup and restore of your Vault.
Using the AWS infrastructure
Learn how to use AWS Relational Database Service (RDS) and Key Management Service (KMS) features to backup and restore your Vault.
Database-level backup and restore
Learn how the pvault-dump and pvault-restore command-line utilities enable you to backup and restore your Vault.
Operate
License management
Learn about the Piiano Vault software licenses, and how to obtain, activate, status check, and renew your license key.
Vault migration options
Learn how to upgrade and downgrade your installation of Piiano Vault using the automatic process and pvault-migrate CLI command.
Data import and export
Learn how to export data from and import data to Piiano Vault and discover the export file format.
Monitor
About system logs
Learn how Piiano Vault collects system logs and how to turn off logging. Piiano uses these logs to improve your experience, identify faults, and enhance Vault.
About audit logs
Learn how Piiano Vault collects JSON format audit logs for all requests to access and change data, which you can stream to a service of your choice.
About telemetry
Learn how Piiano Vault collects telemetry to understand your needs better and assist with product planning and feature prioritization.
Configure
Configuration files
Learn how to configure Piiano Vault using files for system, identity and access management (IAM), data types, and collections.
Environment variables
Learn how to configure Piiano Vault features such as operation mode, database, logs, and more using environment variables.
TLS for clients
Learn how to protect data in transit by configuring Piiano Vault to connect to clients using Transport Layer Security (TLS).
Secure
Configure a KMS
Learn how to configure a Key management service (KMS) to provide the keys used by Piiano Vault when it encrypts data.
Anti-tampering
Learn how to detect tampering attempts, find reports of detected events, and enable your system after a suspected tampering attempt.
Reference
Vault naming rules
Discover the naming rules for entities (including collections, properties, policies, roles, and users), transformation bindings, and resources in Piiano Vault.
Metadata cache
Learn how Piiano Vault caches structural information and metadata and the impact when you make breaking changes to collection schemas.
Metadata handling
Learn about the best practices for setting the values of the metadata used in Piiano Vault to avoid the use of PII