This article provides step-by-step instructions on configuring and managing settings for enabling network authentication using an External Captive Portal in a UAM-powered environment.
Prerequisites
- Ensure that you have completed the initial step of network creation by configuring its General Settings.
Step-by-Step Instructions
Step-1: Set Up the Network's General Settings
- Begin by configuring the General Settings as the first step in creating a network.
- For detailed instructions, refer to the network creation guide.
Step-2: Select External Captive Portal (UAM) as the Authentication Mode
- In the Authentication section of the network setup process, choose External Captive Portal (UAM) from the drop-down menu under Authentication Mode.
- Once selected, the configuration options for the captive portal will be displayed, as shown in the example below.
Step-3: Enter Required Details
- Fill in all the necessary fields on this screen, ensuring that all mandatory fields are completed.
- The following table outlines the available fields and their respective allowed values.
| Attribute | Data Type | Mandatory | Limit | Minimum value | Maximum value | Notes |
|---|---|---|---|---|---|---|
| Server URL | Alpha-Numeric | Yes | 256 | Precede with http:// or https://. | ||
| Shared Secret | Alpha-Numeric | Yes | 32 | None | ||
| AAA Server | URL | Yes | 32 | *Refer known limitations | ||
| AAA Authentication Port | Yes | 1 | 65535 | *Refer known limitation | ||
| AAA Auth Secret | Alpha-Numeric | Yes | 32 | None | ||
| NAS-ID String | Options:1) Venue Radius Location2) Custom3) None | No | ||||
| NAS-ID Value | Alpha-Numeric | Yes | 32 | |||
| Walled Garden FQDNs | List | No |
Step-4: Click “Next”
Expected Results
- The settings should get accepted and should move to the next screen “Network Settings”
Additional Details
- Error Codes
| Error Code | Message | Corrective Action |
|---|---|---|
| VALIDATION_FAILED | Invalid auth-port received in the request | AAA Authentication Port has allowed values between 1 and 65535. Dismiss the error to recreate with the correct value. |
| VALIDATION_FAILED | auth-port should be maximum 65535 (or) auth-port should be minimum 1 | Configure a valid port number in the allowed range. |
| VALIDATION_FAILED | uam-secret should be maximum 32 characters long | Configure the Secret Key within the allowed max character limit. |
| VALIDATION_FAILED | auth-server should be maximum 256 characters long | Configure the Server URL within the allowed max character limit. |
| VALIDATION_FAILED | uam-server should be maximum 256 characters long | Configure the Secret URL within the allowed max character limit. |
Note: If the error Persists, use the option "Create Ticket" in the toast pop-up message, to jump to the Ticket creation screen to file a ticket.
FAQs
- Q: Which type of Networks does the UAM Captive Portal is applicable and supported?
A: The UAM Captive portal feature is supported on Passphrase and Public type.
Known limitations
AAA Server IP Configuration Issue (Internal Case #1963): Users are unable to configure an IP address in the AAA Server IP field. Users however would be able to specify a domain name.
AAA Authentication Port Restriction (Internal Case #1964): Custom AAA Authentication Port numbers cannot be configured initially; only port 1812 is accepted. If an error occurs, reverting back to 1812 is also not possible.
Workaround: Create the network with port 1812, then edit the network settings to change it to any value within the 1–65535 range.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article