Welcome to Ulteo "Apps on demand"!
This service provides you the capability to offer your web users a full online software service linked with your website. Ulteo App On Demand car interface with your web site that can be public or with a restricted access.
For instance: have your users deal with your online documents by using a real Office suite such as OpenOffice.org. They will just click on a document, it will launch OpenOffice online and the document will be saved at a place of your choice on your website.
We offer full-featured software, such as the OpenOffice.org office suite. No installation is needed for these software! Everything happens in the user's web browser (link to client prerequisites in term of browser and java plugin).
App On Demand information
How much does it cost ?
The cost is dependent on the number of concurrent online sessions you need. For instance, if you think that you'll have only one user working on an Office document online at a given time, you only need to purchase a "one session" offer. If you will have an average of 10 users working at the same time, you have to purchase a "10 sessions".
What is needed to install the system?
When you purchase sessions, Ulteo will send you a secret key that you need to use on your server, and keep secret. You need to set up web links on your online documents according to our API, and have a place where documents can be saved online. Document transfert happens through a HTTP or HTTPS session.
Legend:
- Your user's client
- Your web server
- Your file server
- HTTPS connection through Internet
- Ulteo Session Manager
- Ulteo Connectme Servers
- Document transiting from 1 to 6
- Secured Ulteo display through Internet
How to test before purchasing?
You can test the system for free. Use the following ID : Test and the following secret key: a3eb1fa5c67e3fdd726833b26d2d8938
By using it you can open an online editor session (kwrite) on a document of your choice for a 3 minutes session.
App On Demand API - Implementation steps on your website
- First of all, you need a running web server that can access Internet and be accessed from Internet, with PHP and CURL module for PHP installed and enabled. For security purpose, it is strongly recommended that your web server can be accessed through SSL (https). So in our example, we assume that it's available at https://myserver.com
- Copy the files of our sample PHP implementation somewhere in your public web site path. Here we consider you place them at the root of your web server, in the directory mydirectory.
- You need a place to store your documents which is accessible by your web server in read/write modes. It can be on the same server or on one other server than your webserver. Let call it files repository.
- For test purposes, place a document in your files repository. Say it is placed in a "data" folder into your website's folder, which is the default value of the example implementation.
- For security reasons, you must define a token to allow the App On Demand service to access this document, which may or may not be different to access it in read and in write modes (for this example needs, we will use the same token, so there will be no distinction between the rights a user has to read or write, however this is very simple to change this after.). A simple way to do this is to generate a random md5 stored associated with the file name thanks to a file. This is done by the function
generate_token() of the functions.php file.
- It is also necessary to check the association of the token with the data when the user wants to download or save the document. This is done by the function
verify_token() of the functions.php file.
- To communicate with the App On Demand service, you need to use the secret key and the ID given to you when you subscribed. ID example : 46545. Secret key example : e760668b6273d38c832c153fde5725da
- Note : you have to manage yourself the identification/authentication of your users on your website, if desired, because only your organisation is identified and authenticated to the service.
- You also need the address of the Session Manager which will give you the sessions. Let's say it's https://sessionmanager.
- Now that you have all this informations, you can set the variables in the config.php file to the correct values (they are self-explanatory), whithout forgetting to check the permissions of the place you choose to put the log to:
$config = array(
'id' => '46545',
'key' => 'e760668b6273d38c832c153fde5725da',
'server' => 'https://myserver.com/mydirectory',
'session_manager' => 'https://www.ulteo.com/main/organisations-launch.php',
'data_directory' => 'data',
'tokens_directory' => 'tokens',
'tokens_conservation_time' => '7200',
'logfile' => '/var/log/appondemand.log',
'locale' => 'autodetect'
);
- It is then necessary to generate a link which will allows users to open the document. For this purpose, the Ulteo Session Manager should be contacted first, to request a session. This is the task of the startsession.php file. So, to open a document, just create a link to this file giving him the name of the file and the application to start in the form of GET parameters (or use index.php to have App on demand open in a popup).
For example :
https://myserver.com/mydirectory?file=test.txt&start_app=kwrite
Congratulations, you have now completed the installation!
