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
- Log in to the Cloudpath user interface.
- Go to Configuration > Workflows.
- 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:
- Click the + button to create a new branch in your workflow.
- You are presented with a screen called
Configuration > Workflows > Modify Step that shows the branch options. Click
Done if the display is correct.
- Check that your newly named branch ("DPSK" in this example) now appears in your workflow, as shown below:
- Highlight the newly added "DPSK" branch in your workflow, and insert a step below it, as shown in the following figure:
- You are presented with a list of plugins. Scroll down toward the bottom of the list and click the "Generate a Ruckus DPSK" button.
- 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
- 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.
- The Create Controller-Based DPSK screen is displayed. The required fields are described
after the following illustration:
Updated screen for 5.4
- 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.
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
Adding a Device Configuration to the Workflow
- In the workflow, click the pencil icon to the right of the Result called "Assign a device configuration and/or certificate."
- Select "A new device configuration," then click
Next.
The Connection Type screen is displayed. Required fields are described below the 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.
- 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:
- You are returned to the workflow. Make sure the Result step has been added successfully,
as shown below:
screen updated for 5.4
Testing the DPSK User Experience
- Test the Enrollment process by clicking on the enrollment portal URL for the workflow at the top of the Configuration > Workflows screen.
- When you presented with the with the Welcome screen, click Start.
- When you are presented with various branches of your workflow, click the "DPSK" branch:
- Proceed with the enrollment. If enrollment is successful, you will receive some status screens indicating the following status as the process is in progress:
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.
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_dpsk_zd_before_adding_new_tab_to_workflow=GUID-47E76851-EA88-43E5-93B4-16885D71C871=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_dpsk_zd_adding_new_tab_to_workflow=GUID-2E315C53-FD22-4CA3-A02C-20C7A5148260=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_dpsk_zd_dpsh_branch_has_been_added=GUID-F88D86DB-11EC-46DB-A2E7-1A14F10D4759=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_dpsk_zd_insert_step_below_dpsk_tab_to_add_plugin=GUID-F78FC26F-6C50-4CF1-B2B4-B13B0455D0A3=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_54_legacy_dpsk_generate_ruckus_dpsk_choice_when_adding_s=GUID-FC0020F2-22F3-4755-BA14-8C09651748CB=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_54_cp_side_config_sz_legacy_dpsk=GUID-DAAA18BB-DB37-46DB-819C-14E8EB4F6F82=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_54_legacy_dpsk_sz_workflow_after_adding_dpsk_plugin=GUID-FCC5D842-8E27-4676-B0FA-4F7206592BBC=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_dpsk_zd_which_dev_config_to_use=GUID-EBD2F68B-24D7-48C1-968A-BB2ABF874BCA=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_dpsk_sz_connection_type=GUID-DEA049EA-2159-478E-904B-D3DB376E443C=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_dpsk_zd_certificate_template_step_choose_do_not_issue=GUID-EB39DF3C-E0A3-4A29-B857-054205525449=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_54_legacy_dpsk_sz_workflow_after_adding_device_step=GUID-BEF9DB4E-345F-42AA-A27C-76F9CE4E5F5E=1=en-US=Low.png)
%20Configur_v1_GUID-234B9083-0F4E-4F0D-8F30-53290F73BE0A/cp_dpsk_zd_enrollment_test_choose_dpsk_branch=GUID-167E6534-2FB9-45A9-8BF7-241F762573F6=1=en-US=Low.png)