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 select "Generate a Ruckus DPSK." The option is shown below:

    Selecting "Generate a Ruckus DPSK"

  3. Click Next. 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 add a Notification step, as shown in Sample eDPSK Workflow. The importance of adding a notification step is to send the DPSK that was just generated in the previous step either directly to the user or to the system administrator, who can then inform the user. This is done by using a variable called ${DPSK}:
    1. To insert a Notification step in the workflow, scroll down to select the "Send a notification" plugin step, then click Next.
    2. On the ensuing screen, choose a new notification, then click Next.
    3. Configure the Create Notification screen. An example is shown below. The most important field is the "Message" field because this is where you enter the ${DPSK} variable. In this example, the notification of the DPSK will be sent by email to the administrator because that option has been selected from the "Notification Method" drop-down list.

      Using the ${DPSK} Variable in a Notification Workflow Step

      As the user goes through the enrollment process, the email notification that gets sent to the administrator will appear as follows:

      Email Notification Sent to Administrator Showing the PSK Assigned to User

      The administrator can send then inform the user of the pre-shared key.

      Note: Another option of providing the DPSK to the user is by adding a workflow step called "Display a message." Again, the key element if you use this step is to include the ${DPSK} variable in the HTML Message field.
  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 of the enrollment device. As administrator, you can obtain information about the newly created DPSK by referring to Managing eDPSK Pools and DPSKs.