Installing and Connecting the Mobile App

Scenario: You want to set up a mobile app client to interoperate with a Desigo CC management platform.

 

Workflow diagram:

 

Prerequisites:

 

Steps:

1 – Download and Install the Mobile App

The mobile app is available free of charge for Android and iOS smartphones and tablets.

  • From the Google Play Store (for Android) or from the Apple App Store (for iOS), download Desigo CC.
Mobile App Icon

 

2 – Install Certificate on the Mobile Device

The mobile device must recognize the certificate that Desigo CC uses to connect to the mobile app. To determine what certificate must be installed on the mobile device, see Check the Certificate Used by the Web Service Application.

  • If a public CA host certificate is used, you do not need to install a certificate file on the mobile device.
  • If a private CA host certificate is used, you must obtain the corresponding root certificate file (for example, WebservicesCA.cer) and install it on the mobile device. Without this certificate installed, the app cannot connect to the server.

Install the Certificate on an Android Device

  1. Go to Settings > ... > Lock screen and make sure the screen lock is secured with a PIN or password. Do not use lower-security options such as swipe or pattern.
  1. Copy the .cer certificate file (for example, WebservicesCA.cer) from your computer to the device's internal storage.
  1. Go to Settings > ... > Security > Credential storage > Install from device storage. The exact path and labels may differ depending on the Android version.
  1. Navigate to where you copied the certificate file on your device, and tap on it to install it.
  1. In the confirmation dialog box, set the Credential use field to VPN and apps, and tap OK.
  • The certificate is installed, and the app can now connect to the server.
    You can access the certificate at any time in Settings > ... > Security > Credential storage > Trusted credentials > User and remove it if required.

Note: On Android versions 4.4 and later, installing a non-publicly-trusted certificate causes an alert (Network May Be Monitored by an Unknown Third Party) to display in the device notification area. This alert indicates that the device is using a trusted credential that was added by the user.

Install the Certificate on an iOS Device

  1. Email the certificate file (for example, WebservicesCA.cer) to the mobile device as an attachment.
  1. In the email app on the device, tap the certificate file attachment and select Install to add it.
  1. Only on iOS 10.3 and later, go to Settings > General > About > Certificate Trust Settings. Under Enable full trust for root certificates, turn on trust for the certificate.
  • The certificate is installed, and the app can now connect to the server.
    You can access the certificate at any time in Settings > General > Profiles and remove it if required.

 

3 – Start the App and Log In
  • You installed the mobile app (and the certificate, if required) on the mobile device.
  1. On the mobile device, tap the Desigo CC icon to start the app.
Mobile App Icon
  1. If the Terms of Use and Privacy page displays, tap Accept to agree to the terms.
    NOTE: You can review these terms at any time from the Settings menu inside the app.
  • The app starts up with one of the following screens:
    - If this is your first sign-in, or if you were logged out, a Sign In screen displays.
    - If you are still signed in (connected to the management platform), a PIN entry screen displays.
  1. If a Pin entry screen displays:
  • Enter your PIN code and tap Ok to resume working with the app.
    NOTE: You have three attempts. After the third incorrect attempt, you are logged out. If this happens, you must sign into the app again with your full credentials.
  • If you do not remember your PIN code, you can tap Logout to return to the Sign-In screen. From there, you can sign in again with your full site credentials.
  1. If a Sign In screen displays:
  • Complete the Server URL, User, and Password fields, then tap Sign In.
  • Enter the PIN you want to set into the New Pin and Confirm new Pin fields, then tap Apply.
  • Tap anywhere on the screen outside the PIN panel to close it and proceed to the app home page.
  • The mobile app resumes where you left off (in case of PIN), or displays the home page (in case of full sign in).

To troubleshoot problems during sign-in see Mobile App Login Errors.

For how to use the app see the operator step-by-step section.