captiveportal : Captive portal object.

This object represents the captive portal configuration.

Object Reference

References to captiveportal are object references. The name part of a captive portal object reference has the following components:

  • The name of the member on which captive portal is located.

Example: captiveportal/ZG5zLm5ldHdvcmtfdmlldyQxMTk:member.com

Restrictions

The object does not support the following operations:

  • Create (insert)
  • Delete
  • Global search (searches via the search object)
  • Scheduling
  • CSV export

The object cannot be managed on Cloud Platform members.

Fields

These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.

The basic version of the object contains the field(s): name.

authn_server_group

authn_server_group

The authentication server group assigned to this captive portal.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

company_name

company_name

The company name that appears in the guest registration page.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

enable_syslog_auth_failure

enable_syslog_auth_failure

Determines if authentication failures are logged to syslog or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

enable_syslog_auth_success

enable_syslog_auth_success

Determines if successful authentications are logged to syslog or not.

Type

Bool.

Create

The default value is True.

Search

The field is not available for search.

enable_user_type

enable_user_type

The type of user to be enabled for the captive portal.

Type

String.

Valid values are:
  • AUTHENTICATED
  • BOTH
  • GUEST

Create

The default value is AUTHENTICATED.

Search

The field is not available for search.

encryption

encryption

The encryption the captive portal uses.

Type

String.

Valid values are:
  • NONE
  • SSL

Create

The default value is NONE.

Search

The field is not available for search.

files

files

The list of files associated with the captive portal.

Type

A/An Captive portal file struct array.

Create

The default value is:

empty

Search

The field is not available for search.

guest_custom_field1_name

guest_custom_field1_name

The name of the custom field that you are adding to the guest registration page.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

guest_custom_field1_required

guest_custom_field1_required

Determines if the custom field is required or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

guest_custom_field2_name

guest_custom_field2_name

The name of the custom field that you are adding to the guest registration page.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

guest_custom_field2_required

guest_custom_field2_required

Determines if the custom field is required or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

guest_custom_field3_name

guest_custom_field3_name

The name of the custom field that you are adding to the guest registration page.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

guest_custom_field3_required

guest_custom_field3_required

Determines if the custom field is required or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

guest_custom_field4_name

guest_custom_field4_name

The name of the custom field that you are adding to the guest registration page.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

guest_custom_field4_required

guest_custom_field4_required

Determines if the custom field is required or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

guest_email_required

guest_email_required

Determines if the email address of the guest is required or not.

Type

Bool.

Create

The default value is True.

Search

The field is not available for search.

guest_first_name_required

guest_first_name_required

Determines if the first name of the guest is required or not.

Type

Bool.

Create

The default value is True.

Search

The field is not available for search.

guest_last_name_required

guest_last_name_required

Determines if the last name of the guest is required or not.

Type

Bool.

Create

The default value is True.

Search

The field is not available for search.

guest_middle_name_required

guest_middle_name_required

Determines if the middle name of the guest is required or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

guest_phone_required

guest_phone_required

Determines if the phone number of the guest is required or not.

Type

Bool.

Create

The default value is True.

Search

The field is not available for search.

helpdesk_message

helpdesk_message

The helpdesk message that appears in the guest registration page.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

listen_address_ip

listen_address_ip

Determines the IP address on which the captive portal listens. Valid if listen address type is ‘IP’.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

listen_address_type

listen_address_type

Determines the type of the IP address on which the captive portal listens.

Type

String.

Valid values are:
  • IP
  • LAN2
  • VIP

Create

The default value is VIP.

Search

The field is not available for search.

name

name

The hostname of the Grid member that hosts the captive portal.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

The name is part of the base object.

The name cannot be updated.

name cannot be written.

network_view

network_view

The network view of the captive portal.

Type

String.

Create

The default value is default.

Search

The field is not available for search.

port

port

The TCP port used by the Captive Portal service. The port is required when the Captive Portal service is enabled. Valid values are between 1 and 63999. Please note that setting the port number to 80 or 443 might impact performance.

Type

Unsigned integer.

Create

The default value is 4433.

Search

The field is not available for search.

service_enabled

service_enabled

Determines if the captive portal service is enabled or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

syslog_auth_failure_level

syslog_auth_failure_level

The syslog level at which authentication failures are logged.

Type

String.

Valid values are:
  • ALERT
  • CRIT
  • DEBUG
  • EMERG
  • ERR
  • INFO
  • NOTICE
  • WARNING

Create

The default value is INFO.

Search

The field is not available for search.

syslog_auth_success_level

syslog_auth_success_level

The syslog level at which successful authentications are logged.

Type

String.

Valid values are:
  • ALERT
  • CRIT
  • DEBUG
  • EMERG
  • ERR
  • INFO
  • NOTICE
  • WARNING

Create

The default value is INFO.

Search

The field is not available for search.

welcome_message

welcome_message

The welcome message that appears in the guest registration page.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

Fields List

Field Type Req R/O Base Search
authn_server_group String N N N N/A
company_name String N N N N/A
enable_syslog_auth_failure Bool N N N N/A
enable_syslog_auth_success Bool N N N N/A
enable_user_type String N N N N/A
encryption String N N N N/A
files [struct] N N N N/A
guest_custom_field1_name String N N N N/A
guest_custom_field1_required Bool N N N N/A
guest_custom_field2_name String N N N N/A
guest_custom_field2_required Bool N N N N/A
guest_custom_field3_name String N N N N/A
guest_custom_field3_required Bool N N N N/A
guest_custom_field4_name String N N N N/A
guest_custom_field4_required Bool N N N N/A
guest_email_required Bool N N N N/A
guest_first_name_required Bool N N N N/A
guest_last_name_required Bool N N N N/A
guest_middle_name_required Bool N N N N/A
guest_phone_required Bool N N N N/A
helpdesk_message String N N N N/A
listen_address_ip String N N N N/A
listen_address_type String N N N N/A
name String N Y Y =
network_view String N N N N/A
port Unsigned int N N N N/A
service_enabled Bool N N N N/A
syslog_auth_failure_level String N N N N/A
syslog_auth_success_level String N N N N/A
welcome_message String N N N N/A