Skip to main content

VIDAR: Secure Encrypted Packaging

VIDAR (Valkyr Integrated Data Archive and Repository) is a powerful data encryption utility included with ValkyrAI. Named after the Norse god known for guarding and securing valuable assets, VIDAR is designed to zip up and encrypt file system data, creating self-extracting encrypted jar files.

Overview​

VIDAR provides a secure way to package and transport sensitive data or entire project directories. It combines compression and strong encryption to ensure that your data remains protected both at rest and during transit.

Key Features​

  • Strong Encryption: Uses AES-256 encryption to protect your data
  • Compression: Reduces file size while maintaining data integrity
  • Self-Extracting Archives: Creates jar files that can be easily extracted with the correct password
  • Cross-Platform Compatibility: Works on any system that supports Java
  • Command-Line Interface: Simple and scriptable interface for automation

Use Cases​

VIDAR is particularly useful in the following scenarios:

  • Secure Project Packaging: Package entire ValkyrAI projects for secure storage or transfer
  • Sensitive Data Protection: Encrypt configuration files containing sensitive information
  • Backup Security: Create encrypted backups of critical data
  • Secure Distribution: Distribute code or data to clients or team members securely
  • Compliance Requirements: Meet regulatory requirements for data protection during storage and transfer

How VIDAR Works​

VIDAR operates in two main phases:

  1. Compression Phase: The specified directory or files are compressed into a zip archive
  2. Encryption Phase: The compressed archive is encrypted using a password-derived key

The result is a self-extracting jar file that can only be decrypted and extracted with the correct password.

Using VIDAR​

Basic Usage​

To use VIDAR for encrypting a directory, run:

./vidar

You will be prompted to enter a password for encryption:

Enter a password for encryption:
Zipping the payload directory...

By default, VIDAR will encrypt the current directory. The encrypted jar file will be created in the parent directory.

Advanced Usage​

VIDAR supports several command-line options for more advanced use cases:

./vidar [options] [directory]

Options:

  • -o, --output <file>: Specify the output file name
  • -p, --password <password>: Provide the encryption password (not recommended for security reasons)
  • -e, --exclude <pattern>: Exclude files matching the specified pattern
  • -v, --verbose: Enable verbose output
  • -h, --help: Display help information

Examples:

# Encrypt a specific directory
./vidar /path/to/directory

# Specify an output file
./vidar -o secure-package.jar

# Exclude temporary files
./vidar -e "*.tmp" -e "*.log"

Extracting VIDAR Archives​

To extract a VIDAR archive, simply run the jar file:

java -jar vidar-archive.jar

You will be prompted to enter the password used for encryption. If the password is correct, the contents will be extracted to the current directory.

Security Considerations​

Password Strength​

The security of your encrypted data depends largely on the strength of your password. Always use strong, unique passwords that:

  • Are at least 12 characters long
  • Include a mix of uppercase and lowercase letters, numbers, and special characters
  • Are not based on easily guessable information
  • Are not reused across different archives

Password Management​

Since VIDAR uses password-based encryption, it's crucial to manage your passwords securely:

  • Consider using a password manager to generate and store strong passwords
  • Document passwords securely for critical archives (e.g., in a company password vault)
  • Establish a secure method for sharing passwords when necessary

Secure Storage​

Even encrypted archives should be stored securely:

  • Limit access to encrypted archives on a need-to-know basis
  • Use secure channels when transferring encrypted archives
  • Regularly verify the integrity of stored archives

Best Practices​

Regular Testing​

Periodically test the extraction process to ensure that your archives remain accessible:

  1. Create a test archive
  2. Extract the archive to verify it works correctly
  3. Verify the integrity of the extracted files

Documentation​

Maintain documentation for your encrypted archives:

  • What the archive contains
  • When it was created
  • Who has access to the password
  • Any special extraction instructions

Backup Strategy​

Incorporate VIDAR into your backup strategy:

  • Create encrypted backups of critical data
  • Store backups in multiple secure locations
  • Regularly test backup restoration

Integration with ValkyrAI​

VIDAR integrates seamlessly with other ValkyrAI components:

  • Use VIDAR to securely package generated code from ThorAPI
  • Encrypt configuration files containing sensitive information
  • Secure backups of database dumps containing encrypted SecureField data
  • Package and distribute ValkyrAI projects to clients or team members

Troubleshooting​

Common Issues​

"Invalid password" error when extracting​

  • Ensure you're using the correct password
  • Check for typos or case sensitivity issues
  • Verify that the archive hasn't been corrupted

"File not found" error when running VIDAR​

  • Ensure the VIDAR script is executable (chmod +x vidar)
  • Verify that you're in the correct directory
  • Check that the Java runtime is installed and accessible

Archive corruption​

  • Verify the integrity of the archive file
  • Ensure the archive wasn't modified after creation
  • Try recreating the archive with a fresh copy of the data

Future Enhancements​

The VIDAR roadmap includes:

  • Multiple Encryption Algorithms: Support for additional encryption algorithms
  • Key File Support: Option to use key files instead of or in addition to passwords
  • Split Archives: Ability to split large archives into multiple files
  • Incremental Backups: Support for incremental encrypted backups
  • Cloud Integration: Direct upload to cloud storage services