| Table of Contents |
|---|
Overview
Currently we are using
...
node.js
...
0.4.9
...
and
...
Openssl.
...
You
...
may
...
need
...
to
...
download
...
and
...
install
...
openssl.
...
Installation
...
of
...
Required Software
- Download the node.js
...
- 0.4.9
...
- tar
...
- file,
...
- unpack
...
- it.
...
- Running
...
- a
...
- newer
...
- version?
...
...
...
...
...
- downgrade.
- Navigate to the download folder to make and install node.
- ./configure
- make
- sudo make install
Certificate Installation
These certificates are used to proxy to the test server using your credentials.
- Go to Firefox/Preferences/Advanced/Encryption/View
...
- Certificates
...
- and
...
- click
...
- on
...
- your
...
- certificate
...
- and
...
- click
...
- the
...
- Backup
...
- button.
...
- In
...
- the
...
- Save
...
- Dialog
...
- box,
...
- save
...
- your
...
- certificate
...
- as
...
- a
...
- pks12
...
- (.p12)
...
- file
...
- in
...
- your
...
- server
...
- directory
...
- (neatest
...
- if
...
- you
...
- save
...
- it
...
- in
...
- a
...
- cert
...
- subdirectory).
...
- Using
...
- your
...
- terminal,
...
- CD
...
- to
...
- the
...
- cert
...
- subdirectory.
...
- Create
...
- a
...
- .pem
...
- file:
...
- openssl
...
- pkcs12
...
- -nodes
...
- -in
...
- yourcert.p12
...
- -out
...
- yourcert.pem
...
Now
...
remove
...
the
...
password
...
from
...
your
...
.pem
...
file
...
this
...
way:
...
openssl
...
rsa
...
-in
...
yourcert.pem
...
-out
...
yourcertNoPassword.pem
...
From the Authorities tab in FF, export and save the "MIT Certification Authority..."
...
certification
...
to
...
a
...
file
...
name
...
mitCA.pem
...
in
...
/zend_framework/public/server
...
/certs
...
folder
...
.- If using the older proxy only, {{put
...
- the
...
- correct
...
- paths
...
- to
...
- your
...
- certs
...
- in
...
- the
...
- proxy.js
...
- file
...
- (roughly
...
- lines
...
- 21-23
...
- /
...
- see
...
- example
...
- below).}}Proxy.js
...
- example:
...
Code Block
...
var KEY = fs.readFileSync('./certs/yourcert.pem').toString(); var CERT = fs.readFileSync('./certs/yourcertNoPassword.pem').toString(); var CA = fs.readFileSync('./certs/mitCA.pem').toString();
...
Install Required Node Module Dependencies
- Navigate to /zend_framework/public/server/
...
- Execute
...
- npm
...
- (node
...
- package
...
- manager)
...
- which
...
- will
...
- read
...
- the
...
- package.json
...
- file
...
- and
...
- install
...
- the
...
- listed
...
- dependencies.
...
-
- npm install
Configure auth.json
...
Old
...
Method:
...
Create /zend_framework/public/server/auth.json
...
with
...
your
...
username
...
and
...
password
...
in
...
the
...
following
...
format,
...
substituting your actual credentials:
| Code Block |
|---|
}{ "username": "jresig", "password": "jQuery2006" }{code} h3. New Method: Edit |
New Method:
Edit /zend_framework/public/server/auth_yours.json
...
and
...
rename
...
this
...
file
...
to
...
auth_me.json
...
or
...
whatever
...
you
...
like:
| Code Block |
|---|
}{ "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", "certsFile": ".pem file containing your cert with password removed", "caFile": "certs/mitCA.pem" }{code} h2. Testing The Local Server h3. Old Method: # Navigate to |
Testing The Local Server
Old Method:
- Navigate to zend_framework/public/server
...
- Start
...
- the
...
- server
...
- via
...
- command
...
- ./bin/mitserv
...
New
...
Method:
...
- Navigate
...
- to
...
- zend_framework/public/server
...
- Start
...
- the
...
- server
...
- via
...
- command
...
- node
...
- bin/mitserv.js
...
- -a
...
- auth_me.json
...
Possible
...
Issues
...
- 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.