Configuring DPSK on Cloudpath to Integrate with SmartZone

Once you configure a DPSK Wireless LAN on your controller, you need to add a corresponding DPSK configuration to a workflow on your Cloudpath system.

This procedure in this section includes steps for:

  • Adding the DPSK plugin to a workflow
    Note: The concept of workflows and how to create one is described in detail in the Cloudpath Enrollment System Administration Guide and the Cloudpath Enrollment System Quick Start Guide. Therefore, the purpose of the procedure in this section is to demonstrate how to add a DPSK branch (with a DPSK plugin) to an existing workflow. The same steps included below could also be used to create a new workflow with a DPSK plugin.
  • Adding a Device Configuration to the Workflow
  • Testing the DPSK User Experience
  • Troubleshooting Tips

Adding a DPSK Plugin to the Workflow

  1. Log in to the Cloudpath user interface.
  2. Go to Configuration > Workflows.
  3. Click on a workflow to which you want to add a DPSK branch. An example of a very simple workflow before adding a DPSK branch is shown below:

    Workflow Before Adding DPSK Branch

  4. Click the + button to create a new branch in your workflow.
    The Webpage Display Information screen is displayed, as shown below, and you add the necessary information.

    Webpage Display Information Screen is Displayed When You Add a Branch to a Workflow

    Enter a Short Name and Display Title, and, optionally, Display Text, then click Save.

  5. You are presented with a screen called Configuration > Workflows > Modify Step that shows the branch options. Click Done if the display is correct.
  6. Check that your newly named branch ("DPSK" in this example) now appears in your workflow, as shown below:

    New Branch Name ("DPSK") Appears in Workflow

  7. Highlight the newly added "DPSK" branch in your workflow, and insert a step below it, as shown in the following figure:

    Adding a Step Below the New DPSK Branch of the Worlkflow

  8. You are presented with a list of plugins. Scroll down toward the bottom of the list and click the "Generate a Ruckus DPSK" button.
  9. On the next screen, because this manual is for how to use legacy DPSK, choose that option (shown below), then click Next.
    updated screen shot for 5.4

    Store DPSKs in a controller (Legacy) Option

  10. On the ensuing "What DPSK configuration do you want to use?" screen, the default is to create a new configuration. For the purposes of this example, the default setting is used. Click Next at the top of the screen.
  11. The Create Controller-Based DPSK screen is displayed. The required fields are described after the following illustration:
    Updated screen for 5.7

    Create Controller-Based DPSK Screen With SmartZone As Controller

    • Display Name: Enter a descriptive name for your DPSK configuration. This can be any name you wish.
    • Controller Type: Select SmartZone from the drop-down list.
    • WLAN IP/DNS: This is the IP address of the SmartZone controller where you configured the DPSK Wireless LAN you are using. For information on how to obtain this IP address, refer to SmartZone.
    • SmartZone Version: Select the applicable version of SmartZone from the drop-down list.
    • Username: This is the Northbound Portal Interface username that you set on SmartZone. For information about where you created that username, refer to SmartZone.
    • Password: This is the Northbound Portal Interface password that you set on SmartZone. For information about where you created that password, refer to SmartZone.
    • Zone Name: This is the name of the zone that the SmartZone controller belongs to. If the controller belongs to the default zone, leave this field blank.
    • SSID: This is the SSID that you configured for the DPSK Wireless LAN when you created it on SmartZone. For more information about where you created this SSID, refer to General Options Section of the Create WLAN Configuration Screen.
    • VLAN ID: Enter the ID of the VLAN in which users will be placed upon successfully migrating to the DPSK SSID.
    • Notification area: You can enable the "Send Email" field to send the pre-shared key (PSK) to the user. You can also edit the Email Subject and Email Template fields as desired.
      new for 5.7

    When you have completed filling out the fields, click Save at the top of the screen.

    Note: The configuration will not save unless the connectivity between Cloudpath and the controller is correctly set.

    You are returned to the workflow, and the new "Generate a DPSK via Ruckus Controller" step has been added, as shown in the following screen:
    screen updated for 5.4

    Workflow After DPSK Step for SmartZone has been Added

Adding a Device Configuration to the Workflow

  1. In the workflow, click the pencil icon to the right of the Result called "Assign a device configuration and/or certificate."
    The following screen appears:

    Device Configuration Selection Screen

  2. Select "A new device configuration," then click Next.
    The Connection Type screen is displayed. Required fields are described below the screen.

    Connection Type Screen

    • The Wireless Connections button must be selected.
    • SSID: This name must match the DPSK WLAN exactly. It is the name configured in General Options Section of the Create WLAN Configuration Screen.
    • Authentication Style: Select Ruckus Dynamic PSK from the drop-down list.
    • Is this SSID Broadcast?: Leave the default value of Yes, the SSID is broadcast.

    Click Next.

  3. For the screens you are presented with next, you can keep all the default values and continue to click Next to progress through the screens, until you get to the following screen:

    Certificate Template Screen

    It is recommended to choose the "Do not issue a certificate to the user" option for DPSK configuration. After selecting this option, click Next.

  4. You are returned to the workflow. Make sure the Result step has been added successfully, as shown below:
    screen updated for 5.4

    Workflow After Completing the Device Configuration "Result"

Publish the workflow by clicking the Publish icon to the left of the workflow name at the top of the Configuration > Workflows screen.

Testing the DPSK User Experience

  1. Test the Enrollment process by clicking on the enrollment portal URL for the workflow at the top of the Configuration > Workflows screen.
  2. When you presented with the with the Welcome screen, click Start.
  3. When you are presented with various branches of your workflow, click the "DPSK" branch:

    Testing the Workflow - DPSK Branch

  4. Proceed with the enrollment. If enrollment is successful, you will receive some status screens indicating the following status as the process is in progress:
    • "Configuring this device"
    • "Attempting to connect to the network"
    • "Congratulations! You are now connected to the network."

Troubleshooting Tips

If an error occurs during the workflow-publishing or enrollment process, check the following:

  • Make sure that your DPSK WLAN configuration settings on Cloudpath match what you configured on the controller.
  • Make sure that your Northbound Interface administrative username and password are identical on Cloudpath and the controller.
  • Make sure that you have selected Ruckus Dynamic PSK as the Authentication Style in the Cloudpath Connection Type screen.
  • Make sure that you have added the correct Cloudpath DPSK SSID to the final result step in your workflow.