General Settings

Manage ISP identity, branding, preferences, billing, service, network, integrations, security, and portal configuration.

Company & ISP Profile

Choose a category, change what you need, then save that section.

Unsaved changesLoading settings…

Organization Profile

Legal identity and public contact information.

Enter the legal company name.
Enter a valid Philippine mobile number.
Enter a valid email.
Enter a valid HTTPS website URL.
Select the timezone.
Select the currency.
Use the number shown on approved BIR registration records.

Hotline numbers

The first number is the primary public hotline.

System branding assets

PNG, JPG, WEBP, or ICO up to 4 MB. Assets are versioned and reused by the system.

Primary / Login logo preview
Primary / Login logo

Navbar, login, and company identity

Compact logo preview
Compact logo

Collapsed navigation and small spaces

Browser icon preview
Browser icon

Browser tab and saved shortcut

Invoice logo preview
Invoice logo

Generated invoice and billing documents

Receipt logo preview
Receipt logo

Official and downloadable receipts

System preferences

Shared display, navigation, pagination, and refresh defaults.

seconds

ISP legal, tax & regulatory profile

Central provider identity used by billing, receipts, portals, and authorized system views.

Editable & audited
Enter only verified registration information. Blank optional fields remain hidden from public views.

Customer service, NOC & privacy contacts

Public support contacts may appear in the Subscriber Portal; internal regulatory data remains protected.

Offices & Service Locations

Public office records and operational location labels.

Offices, Branches & Network Coverage

Select a row to review its profile, coverage barangays, and assigned MikroTik routers.

Router assignments are synchronized to the selected branch only after Office Settings is saved. A router can belong to one branch at a time.
Office / Branch Type Primary location Coverage MikroTik routers Status Menu
Loading office and branch records…

Billing, Due Date & Isolation Rules

Draft defaults; subscriber contracts and approved exceptions remain authoritative.

Isolation and reconnection must never run from browser settings alone. The backend must verify posted payments, grace periods, account exceptions, advisories, idempotency, router state, and authorized execution before changing service.

Select the billing cycle.
days
Enter 0–60 grace-period days.
month(s)
Enter 1–12 unpaid months.
Comma-separated calendar days from 1 to 31.
Enter valid comma-separated days.
Used by automatic isolation, the Isolation & Reconnection page and bulk actions.
Must exist on every router. Isolation Templates › RouterOS script creates it with the walled garden.
day(s) before due
Zero generates the invoice on the due date; recommended value is 7 days.
Days after due date; comma-separated and within the grace period.
hours
Before a prepaid load ends.
hours before
minutes
days

The last bill is prorated up to the contract end date. Renew contracts on Subscription Billing > Contracts ending.

Installation & Service Rules

Standard service amounts and operational targets.

₱
Enter the installation fee.
meters
Enter the minimum allowance.
meters
Maximum cannot be below the minimum.
₱/ meter
Enter the excess cable rate.
₱
Enter the processing fee.
Select the service target.
hours
hours
hours before

Payment & Reconciliation

Provider modes and controls without exposing credentials.

Store provider keys and webhook secrets only in the encrypted backend environment. This page must show connection state and secret references, never raw secret values.

Select the gateway environment.
Production uses approved live credentials and may create real subscriber charges.
Backend route reference only.
Enter a backend reference only, not a secret or URL.
hours
₱

Payment gateway connections

Configure approved providers, channels, fees, and routing priority.

Store only a backend credential or vault reference. Secret keys and webhook signing secrets must never be pasted into this page.
“Valid configuration” means the approved fields passed backend validation. A provider adapter must still perform a live connectivity and webhook-signature test before production activation.
minutes

Network Integrations

Read-only monitoring preferences and protected integration references.

Device usernames, passwords, API keys, VPN credentials, and private management addresses must remain encrypted on the backend. Configuration-changing commands require explicit authorization, validation, audit logging, timeouts, and rollback.

MikroTik

Routers, live PPP sessions, profiles, queues, and health.

Live enabled

Multi-vendor OLT

OLTs, PONs, ONUs, optical data, and alarms.

Not connected

GIS & Coverage

Routes, poles, equipment, zones, and outages.

Not configured

MikroTik connection & PPPoE accounts

How ONE-KONEK reaches your routers and where it reads each subscriber's PPPoE secret, password and profile.

PPPoE Accounts & Sync
Each router can choose its own in MikroTik Routers.
Use RADIUS when the routers authenticate PPPoE through RADIUS.
minutes

Passwords are stored encrypted and shown only to Super Admin, Admin and Network Operator (every view is in the Audit Log).

minutes
seconds
Enter a backend ID only, not credentials or a URL.
Enter a backend ID only, not credentials or a URL.

ISP Operations & Automation Guardrails

Safe policy foundation for provisioning, outages, isolation, reconnection, and network changes.

Production mode is active. RouterOS monitoring, PPP provisioning, and controlled reconnection run only through authenticated backend services with validation, rate limits, audit records, and rollback-aware workflows.

—Readiness

Backend readiness not checked

Run the protected check to review branches, plans, routers, and required safety policies.

Phase 2: Integration Health

Redacted connector inventory and passive configuration checks. No device, subscriber, or payment state is changed.

Waiting for backend inventory
Connector inventory has not been loaded.
Recent protected checks
Checked Operator Ready Attention Not configured Result
No health checks recorded.

Operating mode

Controls how future automation may be authorized.

Provisioning safeguards

Prevent unsafe or conflicting subscriber activation.

Billing-linked service actions

Protected policies for isolation and verified-payment reconnection.

minutes

Outage, SLA & customer protection

Detect sustained incidents and prepare fair proration evidence.

minutes
%
hours
minutes

Change window & rate limits

Limit future automated actions and preserve rollback capacity.

Automatic isolation stops for the hour when this limit is reached.
Off: technicians see the jobs and add field notes; network operators and administrators complete them.

Routers

Add a MikroTik router in 4 easy steps

No typing of commands: ONE-KONEK makes the script, you paste it once, and the router connects by itself.

1
ServerONE-KONEK checks the WireGuard and RADIUS settings. Fix anything red.
2
Router detailsName, branch and how the router connects (new tunnel or its own tunnel).
3
Paste scriptWinBox > New Terminal > paste. One time only.
4
ConnectWait here. The status turns Connected by itself.

If it does not connect

What you see What to do
onekonek-wg showsI(invalid) in Interfaces Paste the newest script again (Routers > terminal button). It now picks a free WireGuard port by itself.
Peer has never handshaked The server does not know the router yet: do step 3 → "On the server" (one line), then wait 30 seconds.
/ping to the server tunnel IP gets no answer The router cannot reach the server endpoint: check the router internet and that UDP to the server port is not blocked.
The terminal says "this router already has a tunnel" Use it: Add Router > "It already has a tunnel" and enter its address from IP > Addresses.
Login failed / not enough permissions Paste the script again; it recreates the ONE-KONEK user and its rights.
ONE-KONEK is on a different machine than the WireGuard server That machine needs a route to the tunnel subnet (or install ONE-KONEK on the WireGuard server).

Router NAS Management

Add a router, then copy the setup script to the MikroTik terminal. The row turns from Waiting to Connected by itself. A router on the same network or an existing VPN:Same network / VPN.

Router name Type WireGuard Status Login Actions
Loading…

RADIUS & WireGuard Infrastructure

RADIUS server, WireGuard tunnel and isolation for the selected router.

RADIUS server

Selected router

Set up the RADIUS server

Routers send PPPoE logins and accounting to this address through the tunnel. Each router gets its own secret in its setup script.

Use the tunnel subnet, for example 10.200.0.0/24. "Any address" (/0) is not allowed.

WireGuard server interface

One tunnel for every remote router.

The address routers dial to (public IP or domain of the ONE-KONEK server). RADIUS still uses the tunnel IP.
From the server: wg show wg0 public-key

MikroTik / NAS peers

Routers connected through the WireGuard tunnel.

Router Tunnel IP Handshake Status

How isolation works on this router

Automatic isolation of overdue accounts (grace days, notice, reconnect after payment) is set inBilling & Payment Preferences.

Walled garden (allowed while isolated)

Domains, IP addresses or subnets, one per line. Saved in the isolation template used by this router.

RouterOS isolation script

Safe to paste again: each rule is found by its comment and added or updated; nothing is removed first.


                                    

Isolation template for this router

The template decides the isolated speed, the allowed sites and where web pages are sent. Routers without a choice use the default template.

Edit templates

How ONE-KONEK reaches the MikroTik routers, reads and syncs the PPPoE accounts, and monitors them. The settings are below.

Limits on automatic changes to the network (isolation, reconnection, change windows). The settings are below.

Router on the same network or an existing VPN

Five short steps with a certificate check. For remote routers with RouterOS 7, use the Routers tab: one script does it.

Server readiness

Checked once and reused for every device. Saved settings alone never count as ready.

What do you want to connect?

Continue a setup

Other PPPoE servers and devices

PPPoE is how a subscriber logs in, not a way to manage a device. Only RouterOS routers are configured directly; everything else is described honestly below.

Device Management Remote site Accounts / sessions Support
What should ONE-KONEK do with it?
Advanced
How does ONE-KONEK reach this router?

Advanced: existing API login, port, server address

Setup script

No working management connection yet? An authorized administrator runs this once on the router: WinBox > New Terminal > paste. It changes only items marked "ONE-KONEK ENROLL" and contains a one-time password that is replaced at the first successful test.


                                        

The first read changes nothing on the router.

Plans and router profiles

Suggestions come from the profile name and its real speed limit, never from the price. Review each one; the router profile itself is not changed.

Router profile Upload Download Address pool System plan Result

Accounts on this router

Matched by router and username. Linking never resets passwords, bills customers, changes status or drops sessions.

Username Profile Status Subscriber Action

Which subscriber?

Subscriber

1Router and plan

2Account

Advanced: fixed IP
Open IP addresses (General Settings)

3Set up the modem / ONU

4Verify connection

"Connected" only when the router or RADIUS shows a live session for this account.

OLTs

Huawei, ZTE, VSOL, C-Data, BDCOM, Fiberhome, SmartOLT cloud or any brand by SNMP. ONU status, authorization and outages are in Network > OLT & ONU.

Signal and outage thresholds

Used by the OLT & ONU page and the Monitoring Board.

OLT & ONU

IP addresses

Subnets, router address pools, fixed IPs and what is really in use. Problems are shown for you to fix; ONE-KONEK never moves a customer to another address by itself.

Loading…
Address State Recorded for Live session Router / scope

Subnets

Subnet Purpose Router / scope Use

Add subnet

Address pools on the routers

Read from /ip pool (read-only). Use is counted from live sessions.

Router Pool Ranges Use Read

Reservations (devices, gateways, servers)

Customer fixed IPs are set on the subscriber's PPPoE account; they appear under Addresses.

Address Label Kind Router / scope

Reserve an address

Is this address free?

The same check runs when a fixed IP is given in Connect Device.

Integrations & Plugins

Configure protected connections used by network, billing, messaging, customer, compliance, and business operations.

minutes
seconds
Used to generate callback URLs; individual paths remain configurable per integration.
No integrations loaded
Integration Category Environment Method Branch scope Health check Status Menu
No integrations configured.

Notification Preferences

Sender identity, channels, schedules, consent, and delivery safeguards.

Enter the sender name.
Enter a valid reply-to email.
End time must be later than start time.
Approval must remain required for sensitive notifications.

Messaging integrations

Configure approved SMS, email, Telegram, WhatsApp, and Viber delivery connections.

Store only a backend credential or vault reference here. Never paste an API token, password, or private key into the browser.

Connected Email Accounts

Multiple IMAP/SMTP mailboxes used by the Email Center.

Passwords remain server-side. Enter a credential reference here, then set the matching EMAIL_CREDENTIAL_* environment variable in the app container.
Mailbox Provider Capabilities Last sync Actions
Loading connected mailboxes…

Subscriber Portal & Web Tabs

Subscriber login rules, session protection, and approved website tabs.

OTP-ready, currently inactive

No OTP is requested or sent until an approved messaging provider and activation workflow are completed.

Plans, offices and contact details come from these settings. When off, the home address opens the staff sign-in.

Shows the products marked "Show on website" in Products & Services. Orders appear in Website Orders.

When off, customers pick up their order at an office.

minutes
Needs a working SMS gateway (Messaging Center) or email. Social sign-in is not asked.

Approved Web Tabs

Only HTTPS websites are accepted. Embedded sites may still block iframe access through their own security policy.

Security, Audit & System

Organization-wide access, evidence, retention, and operational safeguards.

minutes
Enter 5–480 minutes.
Enter 3–20 attempts.
minutes
Enter 5–1,440 minutes.
days
2-step verification for staff:Staff & Roles › Security policy
MFA must remain enabled.
Sensitive-action approval must remain enabled.
Audit logging must remain enabled.
Security review confirmation is required.

Payment gateways

Online payments subscribers make in the portal. Set up a gateway with its API keys; payments are posted to the bill automatically.

Loading payment gateways…
Where are the API keys kept?

Keys typed in a gateway's setup are stored encrypted on the server and are never shown again (only their last 4 characters). Keys can also stay in the server environment file (backend/.env); a key typed here is used first.

Provider Sandbox (testing) Live (real payments)
Xendit XENDIT_TEST_SECRET_KEY, XENDIT_TEST_WEBHOOK_TOKEN XENDIT_LIVE_SECRET_KEY, XENDIT_LIVE_WEBHOOK_TOKEN
PayMongo PAYMONGO_TEST_SECRET_KEY, PAYMONGO_TEST_WEBHOOK_SECRET PAYMONGO_LIVE_SECRET_KEY, PAYMONGO_LIVE_WEBHOOK_SECRET
Maya Business MAYA_SANDBOX_PUBLIC_KEY, MAYA_SANDBOX_SECRET_KEY MAYA_LIVE_PUBLIC_KEY, MAYA_LIVE_SECRET_KEY

Sandbox is for testing only: subscribers never see sandbox gateways, and test payments are never posted to a bill.

Manual payments, QR codes & bank accounts

Accounts subscribers can pay into directly (GCash, Maya, QR Ph, bank transfer) and the instructions they see. Staff confirm these payments in Payments & Collections.

Add one entry per account. The account name, number, QR image and instructions are shown in the subscriber portal and on payment reminders.

PNG, JPG or WebP up to 2 MB. Never upload passwords, PINs, OTPs or recovery codes.
Loading payment accounts…

Connected services

Every integration ONE-KONEK supports, with its real status. Items marked "Not available yet" still need development and are never shown as connected.

Loading integrations…

Webhooks & API access

Receive payment notices from providers, send signed event notices to your other systems, and manage API keys.

Incoming: payment provider webhooks

Copy each address into the provider dashboard. Every request is verified (token or signature) before it is used, repeats are ignored, and payments are re-checked with the provider before posting.

Loading…

Outgoing: send events to your systems

ONE-KONEK posts a signed JSON message to each address when a chosen event happens. Failed deliveries are retried automatically.

Loading…
How receivers verify the signature

Each request has these headers:

  • X-OneKonek-Event — the event name, e.g. payment.posted
  • X-OneKonek-Event-Id — unique per event; store it and ignore repeats
  • X-OneKonek-Timestamp — Unix time in seconds
  • X-OneKonek-Signature — v1= + HMAC-SHA256 of timestamp + "." + raw body using the endpoint secret

Reject requests older than 5 minutes or with a signature that does not match.

Delivery history & troubleshooting

Every attempt is kept with its result. Re-sending an event that can post a payment or change a service asks for confirmation first.

Loading…

API keys

For other systems that call the ONE-KONEK API. A key has the same permissions as your account, is shown only once, and can be revoked at any time.

Loading…

Invoice, receipt & message preview

How your saved company details and logos appear to subscribers. Update logos above and company details in Company & ISP Profile.

Notification identity

Sender name, reply-to email and the message footer are edited in Notifications & Communications.

Edit sender & templates

Who can change settings

These rules are enforced by the server. Every saved change is recorded in the history below without secret values.

Loading…

Maps & Coverage

Map provider, default map location, default address on new forms, address lookup, coverage rules and who can see subscriber pins. Only a Super Administrator can change these.

Map provider

MapTiler: streets-v2, hybrid. Mapbox: mapbox/streets-v12.
Must contain {z}, {x} and {y}. Write {key} where the key goes; the key itself stays in backend/.env as GIS_MAP_API_KEY.
days

Default map location

Where maps open when nothing else is selected. Leave empty to fit the map to your service areas.

Default address on new forms

Pre-filled on new subscriber and application forms. Staff can change them per record.

Address lookup & coverage rules

Keys stay in backend/.env as GIS_GEOCODING_API_KEY.
m
%
m

Who can see subscriber pins

Subscriber locations on the GIS map. They are never in the map export.

Saving asks for a reason and is recorded in the change history.

Configuration History

Versioned changes, approvers, deployment state, rollback points, and audit references.

No configuration versions loaded

Approved backend configuration versions and rollback evidence will appear here.

General SettingsProtected API
Versioned system settings are connected to the protected backend.