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