|
MARX® WEB API Online Demo - Help
Here you can get help about the WEB API Online Demo. If you need further help or want to know
how WEB API can be customized for your needs, please contact
MARX® CryptoTech LP.
Help Topics
System Requirements
Server side
- OS platform: Windows Server 2008/2003/2000, Linux, FreeBSD
- Server: JDK v1.4 and Tomcat v4.1.31 support
Client side
- OS platform: Windows 7/Vista/XP/2000 or Linux
- Browser: Microsoft® Internet Explorer 5.x (or higher) or Firefox 2.x (or higher)
MARX® Hardware Requirements
CRYPTO-BOX® USB, firmware v1.6 and higher, SmarxOS® - formatted
Login Page
Before you can use the login
page, you need to install the CRYPTO-BOX® drivers for your operating system and register client-side
WEB API component, which depends on the browser you use.( ActiveX COM for Internet Explorer
or plug-in for Firefox).
You can get client setup from the Protection Kit CD-ROM or from the WEB API download page.
To perform demonstration, you need a demo CRYPTO-BOX, which can be customized with
the democfg utility, which is available on the Protection Kit CD-ROM and at the download page.
This utility will program client info into demo partition (#999) of the CRYPTO-BOX. Later on, after successful
verification, client info will be transferred to server side and displayed on generated webpage.
Warning: this utility will change the content of demo partition, so these changes will affect other SmarxOS® API demo samples.
Now, you are ready to proceed by entering CRYPTO-BOX password ("demo" - by default) and pressing "Login" button.
To be sure that WEB API client component and hardware drivers are installed correctly, go to
diagnostics page.
Client Verification
After "Login" the CRYPTO-BOX is verified and if it is valid and properly formatted
this information is passed to the server.
Client is verified only in case if demo-formatted CRYPTO-BOX is attached to client computer.
The communications between server and client are possible only after successful verification. Secure transactions
are encrypted with usage of 1024-bit RSA (software implemented), 256-bit AES (software implemented) and 128-bit AES (hardware implemented).
Client verification fails if CRYPTO-BOX is not formatted as demo (corresponding RSA key pairs mismatch).
(For customized Web API solution, each MARX customer will receive hardware with customer specific RSA key pairs)
Memory Transaction Sample
This page demonstrates a simple memory transaction, reading client info from the demo CRYPTO-BOX.
This client info is written into demo partition of the CRYPTO-BOX with democfg utility.
WEB API supports a convenient interface, based on SmarxOS DataObjects API.
Different kinds of Data Objects, like counters, expiration dates, etc., or simple memory objects can be managed with this API.
To end the testing, choose "LOGOUT" and the secure connection between your locally attached CRYPTO-BOX
and the server will be closed. To repeat the test, you may logon again.
|