The OpenWiFi User Self-Care Portal (OWSUB) is the subscriber management and self-care service used within Mango Cloud, Router Architects’ open-source OpenLAN/OpenWiFi cloud controller and managed Wi-Fi platform.
OWSUB is based on the Telecom Infra Project (TIP) OpenWiFi CloudSDK architecture and provides subscriber-facing APIs for account management, device onboarding, subscriber-specific Wi-Fi configuration, and self-service workflows.
To use OWSUB, you can either build it from source or deploy the containerized version using Docker.
This service is part of Mango Cloud, Router Architects’ open-source platform for managed Wi-Fi and connectivity operations for ISPs, MSPs and Edge AI Service providers.
Within Mango Cloud, OWSUB serves as the Subscriber Portal Service (backend node owsub).
Key integrations include:
- Subscriber Self-Care API: Exposes the REST API on port
16006used by the Subscriber Mobile App and Web Portal to manage subscriber profiles, password-change workflows and associated devices. Authentication and token issuance are handled through the Security Service (owsec). - Device Control Options: Connects with the Provisioning Service (
owprov) to associate subscriber accounts with specific hardware (gateways and mesh nodes) and automatically provision subscriber-specific SSIDs. - Signup Flow: Manages the verification templates and database records for subscriber signups, credentials, and verification updates.
The OWSUB REST API is defined in the OpenAPI specification openapi/userportal.yaml. You can use this OpenAPI definition to inspect endpoints, generate client SDKs, or build static documentation.
To build the microservice from source, please follow the instructions in BUILDING.md.
To use the containerized CloudSDK deployment, please refer to the deployment guide in the mango-cloud-deployment repository.
Depending on your deployment, ensure that firewalls allow traffic on the following ports:
| Port | Service Type / Description | Configurable |
|---|---|---|
| 16006 | Public REST API Access for subscriber portals | yes |
| 17006 | Internal REST API Access for intra-microservice communication | yes |
| 16106 | Application Load Balancer (ALB) health check endpoint | yes |
The configuration is kept in a file called owsub.properties. To understand the configuration details, please see CONFIGURATION.md.
To read more about Kafka integration across microservices, follow the wlan-cloud-ucentralgw Kafka Documentation.