kaleo is an application framework which provides sample location (proxy/registrar) and presence services. Kaleo is compliant with the following specifications:
- RFC3261 RFC 3261 - SIP: Session Initiation Protocol
- RFC3265 RFC 3265 - Session Initiation Protocol (SIP)-Specific Event Notification
- RFC3903 RFC 3680 - A Session Initiation Protocol (SIP) Extension for Event State PublicationRFC3863 Event Package for Registrations
- RFC 3856 - A Presence Event Package for the Session Initiation Protocol (SIP)
- RFC 3857 - A Watcher Information Event Template-Package for the Session Initiation Protocol (SIP)
- RFC 3858 - An Extensible Markup Language (XML) Based Format for Watcher Information
- RFC 3863 - Presence Information Data Format (PIDF)
- RFC 3903 - Session Initiation Protocol (SIP) Extension for Event State Publication
- RFC 4825 - The Extensible Markup Language (XML) Configuration Access Protocol (XCAP)
- RFC 5025 - Presence Authorization Rules
Running Kaleo
Build Kaleo
kaleo is located under the extras
directory of your cipango sources directory. To build from the sources, follow these steps:
- Open a command prompt window and navigate to your cipango root directory
- Go to the kaleo framework directory and build it:
Code Blocknoformat cd extras/kaleo mvn install
- Go to the kaleo sipapp directory and build it:
Code Block cd ../kaleo-sipapp mvn install
Start Kaleo
To start kaleo, copy the generated sip application (located under the target
directory of kaleo
-sipapp) to your cipango application deployment directory or start directly the application from the kaleo
-sipapp directory with the maven cipango plugin:
Code Blocknoformat |
---|
mvn cipango:run |
Test kaleo
Integration tests
Integration tests can be run with the command:
No Format |
---|
cd extras/kaleo
mvn install -Ditest
|
Using Mercuro
Mercuro is a free IMS softphone available for download here.
Kaleo does not need any provisionning, the registrar allows every registrations (no authentication).
Mercuro should be configured to use XCAP:
In Open Tools > Options > Contacts, select "Store contacts on a Remote Server" and set in Base URL, the value:
- http://localhost:8080/cipango-kaleo/xcap if Kaleo is running with maven-plugin
- http://localhost:8080/cipango-kaleo-1.0-SNAPSHOT/xcap if Kaleo is running with cipango (replace 1.0-SNAPSHOT by the kaleo version)
In Open Tools > Options > Presence, select "Enable Presence" and ensures that the options "Enable RLS Presence" and "Enable Partial Publication" are not checked
To authorize a user to see the presence, in Contacts > Authorizations, click on the allow button.
Then, the user see the presence.