PureKit

This guide shows how to manage your Virgil PureKit credentials using Virgil CLI.

Virgil CLI allows you to execute only the offline commands related to Pure. Use Pure CLI for online commands.

Update keys

This command is used to update the App Secret Key and Service Public Key of a Pure application if your database has been compromised or you need to carry out regular rotation of keys and records:

virgil pure update-keys <Service Public Key> <App Secret Key> <Update Token>

You can get your Update Token at Virgil Dashboard by clicking "BEGIN ROTATION PROCESS" button at your application page.

Example

Alice needs to update her Pure application keys. Firstly, she navigates to Virgil Dashboard and clicks the "BEGIN ROTATION PROCESS" button. As a result, she gets an Update Token. Secondly, she uses the update-keys command to get her new App Secret Key and Service Public Key:

> virgil pure update-keys PK.1.BFGA3bGvIT...ZBPI4eaISBXi+sA= SK.1.aob9fNEq6...UqCD/wUPvOzfE= UT.2.CiD6g/LR.../3qy7qFPh4XEp0Q=

New server public key:
PK.2.BGDUzYngmv0Doaj...pYa0axg7h8WOzvfrWgLysYww4=
New client private key:
SK.2.yAhSCl0od...szUMVTl3aQd5A=

Generate a secret key

This command is used to generate a new App Secret Key for an application:

virgil pure keygen secret

Example

Alice generates a secret key for her Pure application:

> virgil pure keygen secret
SK.1.aob9fNEq6...UqCD/wUPvOzfE=

Generate an auth key

This command is used to generate a new Auth Key for an application:

$ virgil pure keygen auth

Generate a backup key pair

This command is used to generate a Backup key pair for an application:

$ virgil pure keygen backup

Generate a hashes key pair

This command is used to generate a Hashes key pair for an application:

$ virgil pure keygen hashes

Generate a Virgil Storage key pair

This command is used to generate a Virgil Storage key pair for an application:

$ virgil pure keygen signing

Generate own signing Key

This command is used to generate own Signing Key for an application:

$ virgil pure keygen own

Generate all pure key pairs

This command is used to generate all Pure key pairs for an application:

$ virgil pure keygen all


export const _frontmatter = {"tab_title":"PureKit - CLI - Platform | Virgil Security","meta_description":"This guide shows how to manage your Virgil PureKit credentials using Virgil CLI.","meta_keywords":["Virgil CLI","PureKit"]}