Test Proxy Server

A single user SVMP proxy server intended for connecting one instance of the client to one backend SVMP virtual machine for testing purposes.

Building

Prerequisites:

• Oracle JDK 6 (make sure JAVA_HOME is set properly)
• ant
• Protocol Buffers 2.5.0

Build Steps:

1. Download the Protocol Buffers distribution and unpack it to a directory we'll call PROTOBUF_DIR

2. Compile and install the protoc compiler, then add it to your PATH. cd $PROTOBUF_DIR ./configure make install

3. Prepare the protocol buffer java runtime cd $PROTOBUF_DIR/java protoc --java_out=src/main/java -I../src ../src/google/protobuf/descriptor.proto

4. Checkout the SVMP protocol to a directory of your choice we'll call SVMP_PROTO git clone https://github.com/SVMP/svmp-protocol-def.git $SVMP_PROTO

5. Checkout the SVMP test proxy to a directory we'll call SVMP_PROXY git clone https://github.com/SVMP/test-proxy-server.git $SVMP_PROXY

6. Generate the SVMP protocol source and link in the protobuf runtime ln -s $PROTOBUF_DIR/java/src/main/java/com $SVMP_PROXY/src/com protoc -I$SVMP_PROTO --java_out=$SVMP_PROXY/src $SVMP_PROTO/svmp.proto

7. Update the VM_ADDRESS, USE_SSL, and other static variables in TestProxy.java to suit your testing environment. Generate a keystore using the java keytool if you intend to test with SSL enabled.

   A self-signed test key can be created with a command similar to: keytool -genkey -keyalg RSA -alias svmp-test-proxy -keystore test.keystore.jks
   -storepass changeme -keypass changeme -validity 360 -keysize 2048
   -dname "CN=svmp.test, OU=svmp"

8. Build the test proxy using ant. For example: cd $SVMP_CLIENT ant

If the protocol definition file is changed, re-run the protoc command in step 6 and recompile.

License

Copyright (c) 2012-2013, The MITRE Corporation, All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.