High-level dual-mode app behavior

When the app launches for the first time

When a dual-mode app launches for the first time, it does not know whether it is managed by Ivanti. It does the following high-level steps:

  1. Sets its initial dual-mode state to Undecided.

  2. Sets its initial encryption state to Unencrypted.

  3. Checks whether AppConnect is available.

    • If AppConnect is not available, the app changes its dual-mode state to AppConnect Not Available, and continues as a regular app.

    • If AppConnect is available, the app starts the AppConnect library.

  4. Waits for a notification from the AppConnect library indicating whether Ivanti is managing the app.

  5. Changes its dual-mode state to AppConnect Mode or Non-AppConnect Mode according to the notification.

    • When changing to Non-AppConnect Mode, the app notifies the AppConnect library that it is retiring. Normally, the Ivanti server decides when to retire an app. In this case, the app is retiring itself. Then the app stops the AppConnect library. It behaves as a regular app.

    • When changing to AppConnect Mode, the app behaves as an AppConnect app. However, the app changes its data encryption state to Encrypted only if secure apps are available and the secure file I/O policy requires secure file I/O. The app uses the data encryption state to determine whether it can use secure file I/O APIs.

  6. Stores both the dual-mode state and data encryption state persistently for the next time it launches.

For more details, including specific API calls for these steps, see API call sequence when the app launches.

When an app subsequently launches

On subsequent launches, the app does the following high-level steps:

  1. Gets the dual-mode state and data encryption state that it stored.

  2. Checks the dual-mode state, and takes the following actions depending on the state.

    1. AppConnect Mode: Starts the AppConnect library.

      The app continues as an AppConnect app. It uses the data encryption state to determine whether it can use secure file I/O APIs.

    2. Non-AppConnect Mode: Continues as a regular app.

      The app does not start the AppConnect library.

    3. AppConnect Not Available: Checks whether AppConnect is available.

      • If AppConnect is not available, the app stays in AppConnect Not Available, and continues as a regular app.

      • If AppConnect is available, the app starts the AppConnect library, and waits for a notification indicating whether Ivanti is managing the app.

  3. After receiving the notification, changes its dual-mode state to AppConnect Mode or Non-AppConnect Mode according to the notification.

    • When changing to Non-AppConnect Mode, the app notifies the AppConnect library that it is retiring. Normally, the Ivanti server decides when to retire an app. In this case, the app is retiring itself. Then the app stops the AppConnect library. It behaves as a regular app.

    • When changing to AppConnect Mode, the app behaves as an AppConnect app. However, the app changes its data encryption state to Encrypted only if secure apps are available and the secure file I/O policy requires secure file I/O. The app uses the data encryption state to determine whether it can use secure file I/O APIs.

  4. Stores both the dual-mode state and data encryption state persistently for the next time it launches.

For more details, including specific API calls for these steps, see API call sequence when the app launches.

User requests to switch to Non-AppConnect Mode

A dual-mode app can provide a user interface that allows the device user to explicitly request that Ivanti no longer manage the app. That is, the user requests a change to Non-AppConnect Mode. This user interface can be useful if a device user leaves an enterprise, but still wants to use the app as a regular app.

Users are typically not aware of the term “AppConnect”. Therefore, the user interface should use other terminology. The dual-mode sample app uses “Managed by Ivanti” in its user interface. Another possibility is “Secure enterprise mode”.

When switching from AppConnect Mode to Non-AppConnect Mode, the app does the following high-level steps:

  1. Removes all its secure data, since regular apps do not have secure data.

  2. Sets the data encryption state to Unencrypted, and stores it persistently for the next time it launches.

  3. Notifies the AppConnect library that it is retiring.

    Normally, the Ivanti server decides when to retire an app. In this case, the app is retiring itself.

  4. Stops the AppConnect library.

  5. Stores its dual-mode state, Non-AppConnect Mode, persistently for the next time it launches.

  6. Continues running as a regular app.

    For example, the app no longer enforces AppConnect policies or uses AppConnect features such as secure file I/O.

For more details, including specific API calls for these steps, see API call sequence when user requests Non-AppConnect Mode.

User requests to switch to AppConnect Mode

A dual-mode app can provide a user interface that allows the device user to explicitly request that Ivanti manage the app. That is, the user requests a change to AppConnect Mode. For example, device users in an enterprise sometimes have installed and used an app before the enterprise requires it as an AppConnect app.

Users are typically not aware of the term “AppConnect”. Therefore, the user interface should use other terminology. The dual-mode sample app uses “Managed by Ivanti” in its user interface. Another possibility is “Secure enterprise mode”.

When switching from Non-AppConnect Mode to AppConnect Mode, the app does the following high-level steps:

  1. Starts the AppConnect library.

  2. Changes to the Pending AppConnect Mode state.

  3. Waits for a notification from the AppConnect library indicating that Ivanti is managing the app.

  4. If the app receives the notification that Ivanti is managing the app, the app changes state to AppConnect Mode, and persistently stores the new state. It begins behaving as an AppConnect app. For example, it enforces DLP policies.

    If secure services are available and the secure file I/O policy requires secure file I/O, the app changes the encryption state to Encrypted. The app decides what to do with existing data as described in Actions when changing to the Encrypted state.

For more details, including specific API calls for these steps, see API call sequence when user requests AppConnect Mode.

Data loss prevention policy handling

When a dual-mode app changes from Non-AppConnect Mode to AppConnect Mode, it handles the AppConnect data loss prevention policies that it supports. For example, if the app supports the Open In policy, based on the policy it receives from the AppConnect library, it enables or disables any Open In user interfaces. When changing to Non-AppConnect Mode, the app stops handling the AppConnect DLP policies.