Instagram (Facebook) Social Media Login for Guest WLANs

You can use your Instagram (Facebook) account in the Unleashed web interface to allow guest authentication using OAuth 2.0 credentials.

The Feature Overview Concept view template outlines the required sections for Feature Overview Concept topics. For each section, it provides the title, default text (if there is no impact), and a list of associated information. These lists can also serve as talking points for Writer-SME discussions about the feature. For complex features or those developed in multiple phases, several regular Concept topics may also be needed to keep content short, manageable, and reusable. The regular Concept template has a different format and function than the Feature Overview Concept template.

The purpose of this template is to outline the information you need to collect from SMEs and provide to readers.

Note: Feature Configuration / Troubleshooting are *not* part of the Feature Overview Concept template. Feature Configuration and Troubleshooting steps are likely to be part of separate task/reference templates.

Feature Overview

This feature allows administrators to configure WLANs that support Instagram (Facebook) logins using either the default or custom client ID.

Following are the benefits:

  • Simplifies the login process for guests, leading to better user experience.
  • Authenticates using existing Instagram (Facebook) credentials, eliminating the need for creating new accounts.
  • Ensures secure authentication, protecting user data and preventing unauthorized access.
  • Manages social media logins efficiently through the Unleashed web interface, reducing administrative overheads.
This section is required. This section helps readers understand the functionality, benefits, and usage of the feature.
  • Provide a general description of what the feature does.
  • Explain how the feature benefits the user (including its advantages and disadvantages in real-world scenarios).
  • Mention and explain any standards that govern the feature, if applicable.
  • List any terms that the reader needs to know to understand the feature and its use. Do not list well-known technology & industry terms; focus on new terms introduced by this feature or introduced by the standard/protocol being followed.
  • Offer a detailed description of how the feature works and clarify if it is meant to be used in combination with another feature or a set of features, including the technologies it interoperates with.
  • For software features, state whether the feature is enabled or disabled by default.

Requirements

Ensure you have an OAuth 2.0 client ID and client secret for Instagram (Facebook) before configuring the Guest WLAN.

This section is required. This section describes the network/system topology or conditions necessary for utilizing this feature.

If there are no requirements, use the following default wording:

This feature has no special hardware or software requirements for feature enablement or usage.

Note: Feature Specification 'requirements' should not be copied and pasted, as they typically relate to 'behind the scenes' elements that Systems Engineers and Coders need to address to implement the feature.

The following information should be covered here; does the feature require any of the following:

  • Specific hardware platforms/models.

    EXAMPLE: This feature is supported on all RUCKUS APs, except models E510, T305i, and T811-CM.

  • Specific hardware accessories (e.g., an add-on IoT module for APs, a special SFP expansion module for a switch, a special cable, a special mounting kit etc.).
    • EXAMPLE 1: This feature is supported on all RUCKUS ICX devices with an ICX7600-1X100GQ expansion module.
    • EXAMPLE 2: This feature is supported on all RUCKUS IoT-ready APs with a RUCKUS I100 IoT module.
  • Specific firmware version(s).

    EXAMPLE: This feature was introduced in FastIron release 10.0.20b and is applicable to all subsequent releases.

  • Specific license(s).

    EXAMPLE: The URL filtering service requires an active license, which can be purchased from RUCKUS partners and distributors. A temporary license is also available for a limited trial period.

  • Specific ports to be used/enabled.
  • Special memory allocation (ROM, RAM, etc.)
  • Management or configuration from another device or system. What are the related release and system requirements?
  • User requirements (such as specific permissions or a specific RBAC role).
  • Specific physical or location-based configurations.

    EXAMPLE: The Active-Active High Availability feature requires two to four RUCKUS Edge devices (based on the scale and redundancy needs of your network).

Considerations

This feature has no special considerations pertaining to feature enablement or usage.

This section is required. This section provides general descriptions of implementation considerations, detailing how this feature will impact system OA&M interfaces and the inner workings of the network/system. This information helps the Reader determine whether the feature should be used in their specific network.

Note: Do not include feature design limitations here; place them in the Limitations section.

If there are no considerations, use the following default wording:

This feature has no special considerations pertaining to feature enablement or usage.

Introduce your list of considerations with the following statement:

Consider the following when configuring and using this feature:

What to describe in this section:

  • Impact on user interfaces: Are there new or modified GUI fields, screens, alarms, or KPIs?

    EXAMPLE: This feature adds the Configuration Restore tab to the DETAILS area of the Switches window.

  • Impact on system behavior, performance, and capacity when the feature is enabled and disabled.

    EXAMPLE: Enabling long timeout periods for wireless client sessions can lead to increased resource consumption and impact network performance, as idle or absent clients will still be considered active by the system, consuming memory and CPU resources.

  • Whether the feature is meant to be used in combination with another feature or set of features.

    EXAMPLE: The SmartMesh feature is designed to be used in combination with the Zero IT Activation feature. Ensure that Zero IT Activation is enabled to simplify the deployment and management of SmartMesh networks.

  • Impact on or interactions with other features: Does enabling or disabling this feature affect other features or modify their behavior?

    EXAMPLE: When Band Steering is active, it prioritizes moving clients to the optimal frequency band, which can influence how Load Balancing distributes clients across access points.

  • Impact pertaining to hardware changes.

    EXAMPLE: Replacing an expansion module can result in a mismatch with the switch configuration for the previous module. For example, if a 4x10 GbE module is replaced with a 1x100 GbE module, there may be an existing configuration for port x/2/4 that no longer applies to the new module. Refer to "Resolving Module 3 Mismatches in a RUCKUS ICX 7550 Stack" for more information on fixing module misconfigurations.

Best Practices

This feature has no special recommendations for feature enablement or usage.

This section is required. This section provides a brief list of RUCKUS recommendations on product use to optimize performance.
Note: Consult with product experts and refer to industry standards to ensure the best practices are aligned with the latest knowledge and best practices in the field.

If there are no best practices (recommendations), use the following default wording:

This feature has no special recommendations for feature enablement or usage.

Effective best practice examples often address the following aspects:

  • Post-Deployment Revision or Maintenance

    EXAMPLE: Regularly monitor band steering performance and adjust thresholds as needed to ensure optimal client distribution across bands.

  • Ensure feature reliability
    • EXAMPLE 1: Configure a secondary RADIUS server as a backup to ensure continuous authentication services in case the primary server fails.
    • EXAMPLE 2: Store RADIUS keys and port configurations in a centralized, secure location to simplify management and reduce the risk of misconfiguration.
  • Simplify Troubleshooting

    EXAMPLE: Configure a backup network that does not rely on RADIUS authentication to maintain network access if the Network Policy Server (NPS) becomes unreachable.

  • Enhance Performance

    EXAMPLE: Configure shorter session timeout values for wireless clients to conserve computing resources and improve overall network efficiency.

Avoid using brief, overly concise bullet points. Instead, provide comprehensive advice that clearly outlines the actions readers need to take. Each best practice should be detailed and actionable, offering clear guidance on how to implement or manage the feature effectively. For example:

  • EXAMPLE 1:
    • Preferred level of detail: Monitor band steering performance regularly, and adjust thresholds as needed to ensure optimal client distribution across bands.
    • Not Preferred (too little detail): Monitor band steering.
  • EXAMPLE 2:
    • Preferred level of detail: Configure a secondary RADIUS server as a backup to maintain uninterrupted authentication services if the primary server fails.
    • Not Preferred (too little detail): Set up a backup RADIUS server.

Prerequisites

You must have an active Instagram (Facebook) account with developer access.

This section is required. This section outlines the prerequisites that must be met before enabling or configuring the feature. For instance, it specifies whether certain protocols, features, or licenses need to be enabled or disabled prior to using this feature.
Note: If the feature has any associated enablement or configuration Task Topics, then the <prereq> tag in the Task Topic should contain the same information as presented here in this Prerequisites section of the Feature Concept Overview topic.
Note: Do not include enablement, disablement, or configuration task steps here. Those should be placed in a separate Task Topic.

If there are no prerequisites, use the following default wording:

This feature has no prerequisites to feature enablement or usage.

The following questions provide a framework to identify essential prerequisites for the feature you are writing about:

  • Do any features need to be disabled (the two features cannot coexist) or reconfigured (the other feature can remain enabled, but must be reconfigured in a specific way) before enabling/configuring this feature?

    EXAMPLE: Disable ACL mirroring before configuring VLAN filtering of mirrored packets on the ICX device. Refer to the acl-mirror-port command page in the RUCKUS FastIron Command Reference Guide for more information.

  • Are there any licenses that must be purchased and installed prior to enabling/configuring this feature?

    EXAMPLE: Purchase and activate a URL filtering license before enabling and configuring the URL filtering service. Refer to "Configuring URL Filtering Licenses" for more information.

  • Are there any plugins that must be purchased and installed before enabling/configuring this feature?

    EXAMPLE: Before configuring BLE Scan Mode, you must activate at least one of the following plugins:

    • BLE Scan Plugin (refer to "Activating and Editing the BLE Scan Plugin" for more details)
    • iBeacon Plugin (refer to "Activating and Editing the iBeacon Plugin" for more details)
    • Eddystone Plugin (refer to "Activating and Editing the Eddystone Plugin" for more details)
  • Are there any third-party or cross-product elements that must be set in place before or in parallel to deploying this feature?

    EXAMPLE: Ensure that the necessary security certificates are generated and downloaded from the corresponding certificate authority. Refer to "Managing SSL Certificates" for further details.

  • Are there configuration details that must be known prior to or in parallel with deploying the feature?

    EXAMPLE: Obtain the IP address and port information from the ISP needed to configure the Hotspot 2.0 service.

Ensure that each prerequisite item is written as a complete, actionable instruction rather than a brief, vague statement. Provide clear guidance on the specific actions that need to be taken. For example:

  • EXAMPLE 1:
    • Preferred level of detail: Ensure that the necessary security certificates are generated and downloaded from the corresponding certificate authority. Refer to "Managing SSL Certificates" for further details.
    • Not Preferred (too little detail): Security certificates must be generated and downloaded.
  • EXAMPLE 2:
    • Preferred level of detail: Gather from the ISP the IP address and port information required for configuring the Hotspot 2.0 service.
    • Not Preferred (too little detail): IP address and port information.