Explore AirWatch SDK on the enrolled device

In this section we are going to install the SDK Sample app on the device and explore the SDK functionalities related to the payloads we configured.

NOTE - This article uses device screenshots from a Nexus 5 device. However, they might differ slightly based on the device you are using for this lab.

1. Launch the SDK Sample App

Launch the SDK Sample App

Tap the AirWatch SDK Sample App to launch it.

2. Allow the prompt

Allow the prompt

The SDK sample app is targeting multiple features so you might see different prompts requesting access on the test device. Please go ahead and ALLOW all the prompts as they show up.

3. Enter Basic User Credentials (If Necessary)

Enter Basic User Credentials (If Necessary)

If prompted, enter the Username and Password for the AirWatch Basic User account:

  1. Enter "testuser" for the Username.
  2. Enter "VMware1!" for the Password.
  3. Tap Login.

4. Review the Passcode Restrictions

  1. Click the Information button by the New Passcode field.
  2. Confirm that the Passcode Restrictions popup confirms the passcode restrictions that were configured earlier.
  3. Click Dismiss.

5. Validate Authentication

Validate Authentication

Notice how the application presents an authentication screen upon launch. As per the authentication configuration defined in the SDK profile, we have to setup a 6 character long passcode meeting the complexity requirements. This passcode will be required after the authentication timeout is expired to access the app data and app functionality so that it is secured during the idle period.

  1. Setup a passcode which meet the requirements (e.g. 112233).
  2. Confirm the passcode in the next text field.
  3. Tap Submit to set the passcode.

You will receive a toast notification confirming that Passcode has been set successfully.

6. Launch Client SDK

Launch Client SDK

AirWatch SDK sample app is primarily composed of two sections:

  • AirWatch Client SDK - Lightweight and consists of basic features.
  • AirWatch Framework -  Deeper integration for advanced features.

Now we are going to validate the custom settings that we pushed as a payload from the custom settings. Custom settings is part of AirWatch Client SDK.

Click to select AIRWATCH CLIENT SDK.

7. Validate Custom Settings

Validate Custom Settings
  1. Select the option SDK Manager APIs.
  2. Scroll down until you are at the section Custom Settings. Validate that we are seeing the hardcoded value for URL as http://internal.airwlab.com and lookup field {EnrollmentUser} has been replaced by the actual value of enrollment user which is testuser.
    NOTE - In the sample app, we are just displaying the values of the custom settings that we received from the console. In a real world scenario, the developer can assign these values to variables and use them however they like.)
  3. Click on Back button twice until you return to the Home screen.

8. Launch AirWatch Framework

Launch AirWatch Framework

In this section, we are going to hit an internal splash page from a basic web view within the app. If you navigate to this URL outside the sample app, the splash page will not load. But since we are assigning the AirWatch Tunnel payload to the sample app, it could use it to proxy the traffic to the whitelisted URLs (in this case, the domain is *.airwlab.com).

AirWatch Tunnel is a part of advanced SDK kit, AirWatch Framework.


9. Validate AirWatch Tunnel

Validate AirWatch Tunnel
  1. Scroll down to select Proxy Tunneling AWWebView/ Http/URL/OKHTTP.
  2. Click on Web View.
  3. Enter the URL in the text field as "http://internal.airwlab.com"
    NOTE - instead of entering the URL manually, we could have used the custom setting value that we pushed down from the last step, as an example.
  4. Click Go.
  5. Notice the splash page, which is not accessible outside this application, if we hit the same URL from a browser or any other app.