Wifi Enterprise

Enterprise Designer

The Enterprise Designer is a visual editor for building WPA2-Enterprise (802.1X) portal pages — login forms, certificate download screens, and onboarding steps for corporate WiFi networks using EAP-based authentication. Templates created here are assigned to Portal Configurations to define what employees and corporate users see when they enrol their devices.

'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}

Image not uploaded yet public/assets/img/docs/enterprise-designer/overview.png

The Enterprise Designer template grid — thumbnails, status badges, and action buttons at a glance.

Enterprise Designer vs Portal Designer

Kiwire ships two visual designers for two fundamentally different WiFi authentication flows. Understanding the distinction helps you choose the right module.

	Portal Designer	Enterprise Designer
Auth type	Captive portal (HTTP redirect)	WPA2-Enterprise / 802.1X (EAP)
Typical users	Walk-in guests, visitors, customers	Employees, corporate users, students
Authentication	OTP, voucher, social login, click-through	RADIUS / EAP-TLS, EAP-PEAP, AD/LDAP bind
Extra elements	Social icons, video embed, custom HTML	Certificate download button, config profile download, credential fields
Assigned to	Journey → Zone → Access Point	Portal Configuration → SSID
Storage	`portal/{tenantId}/uploads/`	`enterprise/{tenantId}/uploads/`

The two designers share the same drag-and-drop canvas engine but maintain completely separate template libraries and storage locations. A template created in one designer cannot be used in the other.

Template Grid

The main Enterprise Designer page displays all your enterprise templates in a thumbnail grid. Each card shows:

Thumbnail — an auto-generated screenshot of the template, captured on publish
Template name — the display name you assigned
Status badge — Draft (grey) or Published (green)
Last modified — when the template was last saved
Action buttons — Edit, Preview, Clone, Publish/Unpublish, Delete

Only Published templates can be selected in a Portal Configuration. Draft templates are visible here for editing but will not appear in the configuration picker.

Visual Editor

Click Edit on any template card (or Create Template for a new one) to open the full-screen visual editor. The Enterprise Designer shares the same drag-and-drop canvas as the Portal Designer, with additional enterprise-specific elements.

'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}

Image not uploaded yet public/assets/img/docs/enterprise-designer/editor.png

The visual editor — element toolbar on the left, canvas in the centre, property panel on the right.

Enterprise-Specific Elements

In addition to the standard elements available in the Portal Designer (text, image, button, divider, HTML block), the Enterprise Designer includes these corporate-authentication elements:

Element	Description
Credential Form	Username and password fields for EAP-PEAP or EAP-TTLS authentication. Renders the appropriate input fields based on the assigned login method type.
Certificate Download	A styled button that triggers download of the user's client certificate (PEM or P12 format) after successful authentication. Required for EAP-TLS flows.
Config Profile Download	Downloads a device configuration profile (.mobileconfig for iOS/macOS, .xml for Android) that pre-configures the WPA2-Enterprise SSID on the device.
QR Code	Renders a QR code containing the SSID configuration, allowing users to scan and connect from a second device.
Step Indicator	A visual step-by-step progress bar showing where the user is in the enrolment journey (e.g., Step 1 of 3: Download Certificate).
Text	Heading, paragraph, or label with rich formatting (bold, italic, colour, font size, alignment).
Image	Upload or select from Enterprise Media. Supports PNG, JPG, SVG.
Button	Configurable call-to-action button with label, colour, border radius, and link URL.
Divider	Horizontal rule for visual separation.
HTML Block	Free-form HTML for custom widgets or content.

For EAP-TLS (certificate-based) flows, include both the Certificate Download and Config Profile Download elements on your template. This gives users a one-stop page to get everything they need to connect without IT helpdesk assistance.

Publishing Workflow

Enterprise templates follow the same Draft → Published lifecycle as captive portal templates:

Draft — The template is being worked on. It is not visible in Portal Configuration. Enterprise portal users are never served a draft template.
Published — The template is finalised. It can be selected in any Portal Configuration. A thumbnail screenshot is auto-generated on publish.

To publish, click the Publish button in the editor toolbar or from the template card's action menu. To revert to Draft, click Unpublish. Portal Configurations currently using that template will retain the last published version until you publish again.

Unpublishing a template that is actively assigned to a Portal Configuration does not immediately break the live enterprise portal — connected users continue to see the last published version. However, the template is removed from the Portal Configuration picker for new assignments.

Template Actions

Action	Description
Create	Start a new blank template or choose a starter enterprise layout from the library.
Edit	Open the template in the visual editor.
Preview	View the rendered template in a device frame (desktop, tablet, mobile) without leaving the designer.
Clone	Duplicate the template under a new name. The clone starts as a Draft, even if the source was Published.
Publish / Unpublish	Toggle the template's status between Draft and Published.
Delete	Permanently remove the template. Templates assigned to an active Portal Configuration cannot be deleted.

Media Storage

Images uploaded within the Enterprise Designer editor are stored at:

These files are shared with the Enterprise Media module — images uploaded here appear in Enterprise Media and vice versa. Deleting a file from Enterprise Media while it is referenced by a template will break its display on the live enterprise portal.

Required Permissions

view-enterprise-templates · create-enterprise-templates · edit-enterprise-templates · delete-enterprise-templates · publish-enterprise-templates