Pagero Payment seal HMAC

Pagero Payment seal HMAC proctects files from unauthorized changed when in transfer between the customer’s system and BGC. TO send a file, the customer needs an agreement with its bank, a bank customer number and a seal key created by BGC.

Pagero Payment seal HMAC uses a specific algorithm involving a cryptographic hash function combined with a shared secret key. The applicaction will seal the entire files; that is a “full file seal.”

To run the application a Java Runtime Environment (JRE), version 1.6 is required, which can be downloaded here.

The application is command line based and can be started using the following command and parameters. Scripting is obviously a favorable way of running the application in an automated environment.

java -jar BgcHmacSealer.jar

The following parameters can be used:

Parameter Description
-key Seal key
-input Payment file to be sealed
-output The sealed file
-dir Can be used instead of input and output. The application will sign all files in the directory, and put the sealed files in a subdirectory called ”signed”.
-silent No feedback on the command line except when errors occur.
-inputEncoding If the input file has another encoding than ISO-8859-1 (standard in Windows) use this parameter to make sure the seal algorithm produces correct output.
-excludeOpeningPost In order to test the seal on BGC home page the opening post of file must be excluded. Use this flag to create a file for testing.
-help Shows help and a number of examples of how to use the application.

Examples

Create seal on all files in a directiory (c:\HMAC) using the specified key and put the result in c:\HMAC\signed.

java -jar BgcHmacSealer.jar -key 1234567890ABCDEF1234567890ABCDEF -dir
c:\HMAC

Create seal on the file specified by input using the specified key.

java -jar BgcHmacSealer.jar -key 1234567890ABCDEF1234567890ABCDEF -input
c:\input.txt

Create seal on the file specified by input using the specified key and the silent option.

java -jar BgcHmacSealer.jar -key 1234567890ABCDEF1234567890ABCDEF -input
c:\input.txt -silent

Create seal on the file specified by input, exclude the opening post and use the specified key and the silent option.

java -jar BgcHmacSealer.jar -key 1234567890ABCDEF1234567890ABCDEF -input
c:\input.txt -silent -excludeOpeningPost

Create seal on the file specified by input using the specified key and write the result to the file given in –output. The file given in –input will be removed.

java -jar BgcHmacSealer.jar -key 1234567890ABCDEF1234567890ABCDEF -input
c:\input.txt -output c:\output.txt.hmac

Create seal on the file specified by input using the specified key and where the input file has encoding.

java -jar BgcHmacSealer.jar -key 1234567890ABCDEF1234567890ABCDEF -input
c:\input.txt -inputEncoding Cp850

Display help function.

java -jar BgcHmacSealer.jar -help