Reference13r1:Concept Apps
The innovaphone PBX allows the integration of Apps into the innovaphone myApps client. An App consists of an App Service from which the App is loaded and executed in the innovaphone myApps client as a Web application inside an iframe. The App Service may be the PBX itself, an AppService running on an innovaphone App Platform, or any other webserver.
The PBX controls which user may use which App. This is the main mechanism for assigning rights to users.
So called App Objects are used in the PBX include Apps into the PBX. The main configuration items in an App Object are the link to an App Service and the password, which acts as a shared secret between the PBX and the App Service, so that the PBX can authenticate the user for the App Service.
There is the generic App Object, which can be used for any App without special integration into the PBX. Some services of the PBX use external App Services (e.g. Push). For these services, some special App Objects are available.
Applies To
- innovaphone PBX from version 13r1
App Objects Parameters
App Objects use a common set of parameters to link an App into the PBX. Not all App Objects use all these parameters
- Description, Long Name, Name
- Same meaning as for all objects
- Password
- This is the shared secret between the PBX and the App Service. It allows the PBX to authenticate users for the App Service. If an App Service provides a PBX Manager Plugin for configuration, this password is typically set by the Plugin as a random string. Manual configuration of ths password should only done, if there is no other way.
- URL
- The link to the App Service. This should be configured without filename extension. A postfix of .htm is added to the URL to load the App code as Web application. A postfix of .png is added to load the icon to be displayed in myApps. A size of 100px x 100px is recommended for the icon to have a nice display on 4K monitors.
- Licenses
- If the App uses Service Licenses, the number of licenses to be used by this service can be configured here. The PBX then tries to acquire licenses of the type Service(<name of the App>)
- Plain website
- Indicates that this App service is a website, which does not make use of the authentication provided by the PBX. No App icon can be displayed for this kind of Apps.
- Hidden
- Apps marked as hidden are not displayed in the myApps client. This kind of Apps is used to provide APIs for other Apps and are loaded automatically when the API is used.
- Websocket
- If set, the App Object establishes a Websocket connection to the App Service. This way the App Service itself can make use of APIs provided by the PBX.
For each API an App Services wants to use the correspondig flag must be set in the App object to grant access to the API. The available APIs are
- PbxSignal
- Allows to register an endpoint using the innovaphone Json signaling protocol. Apps like Softphones can use this API
- EpSignal
- Allows an App to insert itself into the signaling path to a registered endpoint. Apps, which control registered phones and may want to add additional media for calls of endpoints can use this API
- Messages
- Access to saved chat messages
- TableUsers
- This API publishes the table "users". This can be used to replicate the PBX users
- Admin
- Create/Update/Delete Users and other PBX config itemss
- PbxApi
- User level access to the PBX, with functions like presence monitoring
- Services
- API which is used to get access to APIs provided by other App Services
- RCC
- Remote Call Control. The functionality including message names and parameters is based on the SOAP API
Objects
There are different objects, which are used as App Objects. A generic one and some for special purposes.
App
The App object is the generic mechanism to include an App in innovaphone myApps.
AP
An App object, which is used to load the hidden App from a App Platform Manager, which provides the APIs which are needed to configure an AP and load PBX Manager Plugins from the AP
Push
An special App object, which connects to a push service. The PBX uses this to deliver push notifications to smartphones. Any user, which wants to make use of the Push service, needs to have the push object configured as push property.
Voicemail
Executes voicemail scripts and loads the visual voicemail App from a voicemail App Service
Fax
Does the call signaling to FAX interfaces and load the Fax App from a fax App Service
PBX Manager Plugins
If an app plugin creates the first object or, if only one exists and it is edited, the plugin creates a new password and sets it both in this object and in the app instance. If further objects are created or edited, it is checked if another object with valid login information exists, and if so, this password is used. If not, a new password is created and configured in both sides; in this case the other existing objects aren't changed and must be saved again to set the same password.
App Platforms
The App Platforms plugin creates the AP object for a foreign AP, which may offer cloud services (e.g. the Push service from innovaphone). It generates an account on the App Platform with a random password and configures the AP object for this account.
The account must be confirmed with a link sent by email. With the email verification it is possible to reconnect to an existing account, even if the password got lost and the account cannot be used by anyone not having access to this email address
Contacts
You can configure an LDAP login inside the PBX Manager Plugin of the Contacts App.