org.owasp.esapi.reference.crypto

Class EncryptedPropertiesUtils

java.lang.Object

org.owasp.esapi.reference.crypto.EncryptedPropertiesUtils

public class EncryptedPropertiesUtils
extends Object

Command line utilities for reading, writing and creating encrypted properties files.

Usage:
java org.owasp.esapi.reference.crypto.EncryptedPropertiesUtils [--in file] [--out file] [--in-encrypted true|false] [--verbose true|false]

Command line parameters:

• --in (Optional) Encrypted or plaintext file to read from. If no input file is specified, a new properties file will be created.
• --out (Optional) Encrypted file to output to. Default: Overwrite input file
• --in-encrypted (Optional) True if the input file is encrypted. Default: true
• --verbose (Optional) If true, output (potentially unencrypted) information to the terminal. Default: false

Since:

October 8, 2010

Author:

August Detlefsen (augustd at codemagi dot com) CodeMagi, Inc.

See Also:

EncryptedProperties

Constructor Summary

Constructors

Constructor and Description
EncryptedPropertiesUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static Object	addProperty(Properties props, String key, String value) Adds a new key-value property to the passed Properties object
static Properties	loadProperties(String inFile, Boolean inFileEncrypted) Loads a Properties file from a filename.
static void	main(String[] args) Loads encrypted or plaintext properties file based on the location passed in args then prompts the user to input key-value pairs.
static void	storeProperties(String outFile, Properties props, String message) Stores a Properties object to a file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EncryptedPropertiesUtils

public EncryptedPropertiesUtils()

Method Detail

main

public static void main(String[] args)
                 throws Exception

Loads encrypted or plaintext properties file based on the location passed in args then prompts the user to input key-value pairs. When the user enters a null or blank key, the values are stored to the properties file.

Throws:

Exception - Any exception thrown

loadProperties

public static Properties loadProperties(String inFile,
                        Boolean inFileEncrypted)
                                 throws IOException

Loads a Properties file from a filename. If the filename is unspecified or the file could not be found, a new Properties is returned.

Parameters:

inFile - Filename to load Properties from.

inFileEncrypted - If true, the input file is assumed to be already encrypted. Default true.

Returns:

Either the loaded Properties object or a new one if the file could not be found.

Throws:

IOException

storeProperties

public static void storeProperties(String outFile,
                   Properties props,
                   String message)
                            throws Exception

Stores a Properties object to a file.

Parameters:

outFile - Filename to store to

props - Properties to store

message - A message to add to the comments in the stored file

Throws:

Exception

addProperty

public static Object addProperty(Properties props,
                 String key,
                 String value)

Adds a new key-value property to the passed Properties object

Parameters:

props - The Properties object to add to

key - The key to add

value - The value to set

Returns:

The previous value of the property, or null if it is newly added.