...

The following set up will allow you to work on the Raft3 app in your local environment (http://localhost) while connecting by using a node.js proxy server to connect to the dev servers for authentication and services.

Note: This environment will not work until you have a valid Kerberos account and have been created as a Raft user.

Installation of Required Software 

...

Create a new project in PHPStorm (or your favorite IDE) and pull the code.

svn root: svn+ssh://svn.mit.edu/mitbi

project: php/trunk

You'll get more than just the front end app but this allows us to be consistent when merging

...

{
	"what_do_I_do_with_this_file": "Rename this file to auth_me.json or whatever you like then reference it on the command line with the '-a' parameter",
	"keyFile": ".pem file containing your key cert with password removed",
	"certsFile": ".pem file containing your cert with password removedkey",
	"caFile": "certs/mitCA.pem"
}

...

1. Navigate to /zend_framework/public/local_server/
2. Execute npm (node package manager) which will read the package.json file and install the listed dependencies. 
   1. npm install

...

1. Navigate to zend_framework/public/local_server
2. Start the server via command: node bin/mitserv.js -a auth_me.json
3. In a browser, navigate to http:/localhost:8080/app.html

Possible Issues

• Issue:
  • Proxy starts but errors related to .pem files seen
• Fix:
  • Make sure you did not mix up the key and cert files in your auth.json file.

• Issue:
  • Proxy starts but no response is returned at all
• Fix:
  • Make sure you have been added everywhere required to be a valid Raft user (Amon knows)

• Issue:
  • Proxy starting but never returning
• Fix:
  • Make sure you're connecting using either the MIT N or MIT SECURE N wireless network

• Issue: 
  • Seeing GET http://localhost:8080/rest/v1/user/auth 403 (Forbidden)
  • With body content including: "SyntaxError: Unexpected token ILLEGAL"
• Fix:
  • The Apache server needs to include the username

• Issue:
  • Error: EBADF, Bad file descriptor './certs/hij1nx.pem'
• Fix:
  • The certs are missing and/or misconfigured. See the section on installing certificates.