Setting up an eDPSK Workflow

You can create a workflow that includes a DPSK pool step from the pools you have already created, or you can create a pool at the same time you create the workflow.

The figure below shows a simple workflow example that incorporates eDPSK:

Sample eDPSK Workflow

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 the eDPSK step to a workflow.

Step 3 in the workflow example shows an authentication step that you might want to have. Then, to create Step 4, which is the DPSK pool step, you would do the following:

  1. Click the arrow underneath Step 3 above to insert a step. You are presented with a screen that has the text: "Which type of step should be added?"
  2. Scroll down and click the "Generate a Ruckus DPSK" button.
  3. You are presented with the following options next:
    Note: The "Reuse an existing DPSK pool" option appears only if you have already configured one or more DPSK pools.

    Continuing With an eDPSK Workflow Step

  4. You could choose either of the DPSK "pool options." If you choose to create a new DPSK pool and click Next, you are then taken to the DPSK Pool configuration screen (which is described in Creating an eDPSK Pool for Use With External DPSK). If you choose to reuse an existing pool and click Next, you are taken to a screen that has a drop-down menu to choose the pool you wish to add to this workflow.
  5. Once you have completed the DPSK pool step, you can edit the plugin to have the pre-shared key emailed to the user:
    1. Click the pencil icon to the right of the DPSK Pool plugin (step 4 in Sample eDPSK Workflow).
    2. On the ensuing screen, check the "Send Email" checkbox (see the Notifications area of the screen below). This box is unchecked by default.
    3. Optionally, you can also edit the Email Subject and Email Template fields.

      Sending an Email to the User With Pre-Shared Key (PSK)

    4. Click Save when you are done.

      As the user goes through the enrollment process, an email notification gets sent to the user, as shown in the following example:

      Email Notification Sent to User Showing Assigned PSK

  6. For the Result step, create a device configuration where you select one of the External DPSK SSIDs that you have configured on the controller (refer to Configuring an External DPSK WLAN on a Ruckus SmartZone Controller) that has been configured as one of the SSIDs in the DPSK pool used in this workflow.

Once the user enrolls, the device used for enrollment contains the pre-shared key for the network. The pre-shared key is assigned to the enrolled user, and will continue to be in use until its configured expiration date. The pre-shared key can be used only on the enrollment device. As administrator, you can obtain information about the newly created DPSK by referring to Managing eDPSK Pools and DPSKs.

Limiting One DPSK per User

You can restrict users from creating multiple DPSKs from multiple enrollments.

If the user already has multiple DPSKs, during the enrollment process, the system prompts the user to choose one DPSK and revokes the other DPSKs. To perform this action, the user must have an identity.

Note: Limiting one DPSK per user is applied only to the DPSKs created from Cloudpath DPSK pool. The restriciton rule is not applied to the DPSKs created from SmartZone or Zone Director.

To limit one DPSK per user, perform the following:

One DPSK per User option is added to the existing Generate a Ruckus DPSK plugin. The checkbox is available when controller type is configured as Onboard. After selecting the One DPSK per user? checkbox, a new section Previously Assigned DPSK List Webpage Display Information is displayed. Enter the details in the section, as shown in the figure below.

  • Page Source - By default the system displays Standard Template. However, user can click on the drop-down arrow to choose Upload HTML File and upload the HTML file as source of the display page.
  • Title - Enter a title for the content area.
  • Message - Enter the main message to be displayed in the content area.
  • Help Caption - Enter the text to be used as the help link.
  • Help Link - Enter the help link URL.
  • Continue Button Label - Enter a label that displays on the continue button.

Click Save.

Limiting One DPSK per User

There are 3 scenarios associated to One DPSK per user during an enrollment process.

  1. Scenario 1 - If the user has multiple DPSKs, the system prompts the user to choose one permanent DPSK to keep.
  2. Scenario 2 - If the user is enrolling for the first time , the system generates a DPSK for the user.
  3. Scenario 3 - If the user already has one DPSK, the system assigns the same DPSK to the user.

The purpose of Previously Assigned DPSK List Webpage Display Information is to administer a user prompt page for the users in Scenario 1, to allow such users to choose one DPSK to keep. There are no user prompts for the users in Scenarios 2 and 3. One example of the user prompt (in Scenario 1) is shown in the figure below.

Choose One DPSK