en-US
search-icon

Mobile Connect 4.0 Chrome OS User Guide

Installing Mobile Connect

SonicWall Mobile Connect is installed through the Chrome Web Store.

1
On your Chromebook, click the Web Store icon.

2
In the Search field, type in SonicWall Mobile Connect, and press Enter.
3
In the search results, select SonicWall Mobile Connect.
4
Select Free and then Add. The app installs on your Chromebook. When installation is complete, the Mobile Connect icon appears in your list of apps.

* 
NOTE: If you encounter an error when attempting to download SonicWall Mobile Connect, see the Chrome Web Store Help web site, where you can find information and troubleshooting procedures for using apps and report the issue to Google if necessary: https://support.google.com/chrome_webstore

 

Using Mobile Connect

The following sections describe how to use SonicWall Mobile Connect:

Creating a Connection

The process of creating a Mobile Connect connection is slightly different depending on which type of SonicWall appliance you are connecting to.

Creating Firewall or SMA 100 Series/SRA Connections

1
The first time you launch Mobile Connect, you must add a VPN connection before you can connect. Select Add connection from the Connection popup menu.

2
You are then presented with the screen to begin your first connection to the SonicWall appliance:
Name—Enter a descriptive name for the connection.
Server—Enter the URL or IP address of the server.

3
Click Next. Mobile Connect then attempts to contact the SonicWall appliance. If the attempt fails, a warning message is displayed asking if you want to save the connection. Verify that the server address or URL is spelled correctly, and then click Save.

4
If Mobile Connect successfully contacts the server, you are prompted to optionally enter your Username and Password. Enter your user name and password, and then scroll down to the Domain field.

5
The Domain field is auto-populated with the default domain from the server. To select a different domain, click Domain to display a drop-down menu of the available options, then select the correct domain.

6
Click Save to create the new connection.

Creating SMA 1000 Series / E-Class SRA Connections

1
The first time you launch Mobile Connect, you must add a VPN connection before you can connect. Select Add connection from the Connection pop-up menu.

2
You are then presented with the screen to begin your first connection to the SonicWall SMA appliance:
Name—Enter a descriptive name for the connection.
Server—Enter the URL or IP address of the server.

3
Click Next. Mobile Connect then attempts to contact the SonicWall SMA appliance. If the attempt fails, a warning message is displayed asking if you want to save the connection. Verify that the server address or URL is spelled correctly, and then click Save.

4
If Mobile Connect successfully contacts the server, the connection is automatically saved.
Related Topics:

 

Connecting to the Mobile Connect Server

After you save the first new connection, it is automatically selected under the Connection tab.

To establish a Mobile Connect session:
1
Navigate to the Chrome status area, click the VPN disconnected row and then select the VPN connection listed under the SonicWall Mobile Connect section to connect.

* 
NOTE: Attempting to enable the VPN within the Mobile Connect app will display an alert with instructions to enable the VPN using the Chrome status area or Settings screen. This requirement is a limitation of Chrome OS and Google is tracking it as Issue 477520.
2
Enter your user name and password if prompted (depending on whether the appliance you are connecting to allows for saving user names and passwords), and click Login.

3
When the connection is successfully established, the Status row changes to Connected.

4
After connecting, you can access your Intranet network using the Chrome browser and other apps. The Wi-Fi icon in the status area on the lower right changes to indicate that the VPN is connected.

If the VPN connection is interrupted, the Wi-Fi icon in the status area changes to indicate that the VPN is no longer connected and you are no longer able to access the Intranet network. This can happen if your device's connection transitions from one Wi-Fi network to another Wi-Fi network or to another network type.

If the VPN disconnects, reestablish the connection from the status area. Optionally, you can configure Automatic Reconnect on the Settings tab to have Mobile Connect automatically attempt to reestablish interrupted connections.

Configuring Mobile Connect Settings

SonicWall Mobile Connect provides settings for reconnecting, URL control, logging, and troubleshooting. The Settings tab also provides Support information that includes a User Guide and Email logs feature.

The following options are controlled from the Settings tab:

Automatic Reconnect - Sets Mobile Connect to automatically attempt to reconnect if the connection is lost. The SSL VPN connection can be disrupted when your device's connection transitions to a different network type (for example, from wireless to cellular). This setting lets applications rely on a sustained VPN connection. There is no limit on the amount of time it takes to reconnect.
URL Control - Allows other applications and web pages to pass action requests using special URLs to Mobile Connect. These action requests can create VPN connection entries and connect or disconnect VPN connections. For example, another application can launch Mobile Connect, access internal resources as needed, and then disconnect by using the supported URL handlers:
Add Profile:
http[s]://www.sonicwall.com/mobileconnect/chrome/addProfile[/]?name=ConnectionName&server=ServerAddress[&Parameter1=Value&Parameter2=Value...]
Connect:
http[s]://www.sonicwall.com/mobileconnect/chrome/connect[/]?name=ConnectionName&server=ServerAddress[&Parameter1=Value&Parameter2=Value...]
Disconnect:
http[s]://www.sonicwall.com/mobileconnect/chrome/disconnect[/]
* 
NOTE: Additional information about URL Control is provided in URL Control Syntax and Parameters.
Debug Logging - Enables full debug log messages of the Mobile Connect app. Leave this section disabled unless instructed to enable it by SonicWall Support staff.
Clear Logs - Deletes all log messages that have been saved on the device.
View Logs - Launches a new window to view logs in real-time as they occur.
User Guide - Displays the SonicWall Mobile Connect User Guide in the default web browser application (for example, Chrome).
Email Logs - Creates an email to send the Mobile Connect log files to SonicWall Support staff. The email is opened in the default mail application (for example, Gmail).

URL Control Syntax and Parameters

This section provides the full set of URL parameters for the URL Control feature. URL Control currently supports the addprofile, connect, and disconnect commands. Callback URLs are also supported. See the following topics:

Add Profile Command

The addprofile command requires either the name or server parameter, and accommodates both. All other parameters are optional. When the URL is opened in Mobile Connect, all of the parameters included in the URL are saved in the connection entry associated with that name and server.

Syntax

http[s]://www.sonicwall.com/mobileconnect/chrome/addprofile[/]?name=ConnectionName&server=ServerAddress[&Parameter1=Value&Parameter2=Value...]

Following are examples of the addprofile command: http[s]://www.sonicwall.com/mobileconnect/chrome/addprofile/?name=Example&server=vpn.example.com http[s]://www.sonicwall.com/mobileconnect/chrome/addprofile/?name=Example&server=vpn.example.com http[s]://www.sonicwall.com/mobileconnect/chrome/addprofile?name=Example%202&server=vpn.example.com http[s]://www.sonicwall.com/mobileconnect/chrome/addprofile?name=vpn.example.com http[s]://www.sonicwall.com/mobileconnect/chrome/addprofile?server=vpn2.example.com

http[s]://www.sonicwall.com/mobileconnect/chrome/addprofile?name=SRA%20Connection&server=sslvpn.example.com&username=test&password=password&domain=LocalDomain&connect=1

http[s]://www.sonicwall.com/mobileconnect/chrome/addprofile?name=EX%20Connection&server=workplace.example.com&username=test&password=password&realm=Corp&connect=1

 

* 
NOTE: All appropriate characters in values of parameters used in URLs are required to be URL encoded. For instance, to match a space, enter %20.

Add Profile Command Parameters

 

 

Command Parameter

Description

name

The unique name of the VPN connection entry that will be created and appear in the Mobile Connect Connections list. Mobile Connect accepts the name only if it is unique. Letters are case-sensitive.

server

The domain name or IP address of the SonicWall appliance in which you wish to connect. For example, vpn.example.com.

username

Optional: The username used in the VPN connection.

password

Optional: The password used in the VPN connection.

realm

Optional: The realm used in the VPN connection profile. Applies to SMA 1000 Series / E-Class SRA connections only.

domain

Optional: The domain used in the VPN connection profile. Applies to SMA 100 Series / SRA and Firewall connections only.

sessionid

Optional: The session ID or Team ID used for authentication.

connect

Optional: If presented and the value is non-null, the connection will be initiated if the profile was successfully added.

callbackurl

Optional: The callback URL is opened by Mobile Connect after the connect command has been processed. See Callback URL for full details of the callback URL syntax and options.

Disconnect Command

The disconnect command is used to disconnect an active connection. In addition, a callback URL can be provided that Mobile Connect will open after the connection is disconnected, which makes it possible to return to the calling app. If there is no active VPN connection, the command is ignored.

Syntax

http[s]://www.sonicwall.com/mobileconnect/chrome/disconnect[/]

http[s]://www.sonicwall.com/mobileconnect/chrome/disconnect[/]?[callbackurl=<callbackurl>]

The following are examples of the disconnect command: http[s]://www.sonicwall.com/mobileconnect/chrome/disconnect

http[s]://www.sonicwall.com/mobileconnect/chrome/disconnect/

http[s]://www.sonicwall.com/mobileconnect/chrome/disconnect http[s]://www.sonicwall.com/mobileconnect/chrome/disconnect?callbackurl=customapp%3A%2F%2Fhost%3Fstatus%3D%24STATUS%24%26login_group%3D%24LOGIN_GROUP%26error_code%3D%24ERROR_CODE%24

http[s]://www.sonicwall.com/mobileconnect/chrome/disconnect?callbackurl=customapp%3A%2F%2Fhost%3Fstatus%3D%24STATUS%24%26login_group%3D%24LOGIN_GROUP%26error_code%3D%24ERROR_CODE%24

Disconnect Command Parameters

Command Parameter

Description

callbackurl

Optional: The callback URL is opened by Mobile Connect after the connect command has been processed. See Callback URL for full details of the callback URL syntax and options.

Callback URL

While invoking Mobile Connect using a URL, a third-party application can include a callback URL that is called by Mobile Connect once it completes the requested action. The callback URL value may also contain special tokens that will be evaluated and dynamically replaced by Mobile Connect to provide additional status and connection information back to the app that is opened by the callback URL. Tokens are evaluated in place, in the same order in which the tokens were specified.

To ensure that it functions properly, the base callback URL format should be RFC 1808 compliant and should be able to be launched independently of Mobile Connect. For example, it should launch through a Webpage.

URL: <scheme>://<net_loc>/<path>;<params>?<query>#<fragment>

* 
NOTE: The value of callbackurl must also be properly URL encoded to ensure that Mobile Connect can process the callback URL correctly.
Dynamic Tokens Supported by the Callback URL

 

Dynamic Token

Description

$ERROR MESSAGES$

The string value of the error message from the failed connection attempt.

$LOGIN GROUP$

The string value of the authentication login group or realm. Applies to SMA 1000 Series / E-Class SRA connections only.

$COMMUNITY$

The string value of authentication community. Applies to SMA 1000 Series / E-Class SRA connections only.

$ZONES$

The string value of EPC zone. Applies to SMA 1000 Series / E-Class SRA connections only.

$TUNNEL IP$

The string value of the Mobile Connect IPv4 client address.

$TUNNEL MODE$

One of split, split-nonlocal, redirectall, or redirectall-nonlocal depending on the tunnel mode. Applies to SMA 100 Series / SRA and Firewall connections only.

$ESP ENABLED

Yes or No, depending on if ESP is enabled. Applies to SMA 100 Series / SRA and Firewall connections only.

 

* 
NOTE: Any number of tokens from the table above can be specified.

The following are examples of using the callback URL:

Callback URL

http[s]://[customURLHandler]?status=$STATUS$&login_group=$LOGIN_GROUP&error_code=$ERROR_CODE$

 

Full URL with URL Encoded Callback URL Value

http[s]://www.sonicwall.com/mobileconnect/chrome/connect?sessionid=<teamid>&callbackurl=customapp%3A%2F%2Fhost%3Fstatus%3D%24STATUS%24%26login_group%3D%24LOGIN_GROUP%26error_code%3D%24ERROR_CODE%24

 

Callback URL

myapp://callback?status=$STATUS$&login_group=$LOGIN_GROUP& error_code=$ERROR_CODE$

 

Full URL with URL Encoded Callback URL Value

http[s]://www.sonicwall.com/mobileconnect/chrome/connect?sessionid=<teamid>&callbackurl= myapp%3A%2F%2Fcallback%3Fstatus%3D%24STATUS%24%26login_group%3D%24LOGIN_GROUP%26error_code%3D%24ERROR_CODE%24

 

Callback URL

http://server/example%20file.html

 

Full URL with URL Encoded Callback URL Value

http[s]://www.sonicwall.com/mobileconnect/chrome/connect?callbackurl=http%3A%2F%2Fserver%2Fexample%2520file.html

 

Installing and Using