Here is new documentation version.
You are reading outdated documentation, which will be shutdown soon!

EPL

Endpoint Lifecycle service (EPL) is a Kaa platform component that monitors endpoint connectivity status and can update a configurable endpoint metadata field with a current connectivity status.

Interfaces

EPL supports a number of interfaces to perform its functional role. The key supported interfaces are summarized in the following diagram.

EPL interfaces diagram

For inter-service communication, Kaa services mainly use REST APIs and messaging protocols that run over NATS messaging system.

Endpoint connectivity events

To know when endpoint goes online or offline, EPL listens to endpoint connectivity events defined in 9/ELCE.

EP metadata management

EPL can be optionally configured to update current EP connectivity state as EP metadata field in Endpoint Register (EPR) or other compatible EP register service using 19/EPMMP.

Time series transmission

EPL can be configured to produce time series data points on endpoint connect and disconnect. To do so, EPL supports 14/TSTP and acts as a time series transmitter to subscribers. The time series will contain a JSON record with the “value” field set to 1 for online status, 0 - for offline. See the configuration page for information on how to configure this interface. If you don’t need this functionality, just do not configure this section.

Tekton integration

EPL is integrated with the Kaa Tekton for centralized application configuration management. It receives configuration update messages from Tekton over 17/SCMP and uses Tekton REST API to retrieve current configs.

See configuration for more information.

Kaa Tenant Manager integration

EPL supports multi-tenancy with each tenant using a separate OAuth 2.0 issuer for authentication, authorization, and resource management. The list of the existing tenants is managed by the Kaa Tenant Manager, which provides REST API for retrieving tenant security configs.

See the security configuration for more details on how to enable multi-tenancy in EPL.