BlueFletch Enterprise
  • BlueFletch Enterprise
  • Product Guides
    • BlueFletch Launcher
      • Configurable Layouts
        • Layouts
        • Orientation Options
        • Criteria
        • Widgets
        • Implied Groups
        • Kiosk Mode
        • Persistent Foreground App
        • Password Protected Applications
        • Quick Start Applications Folder
        • Layout Custom Actions
        • Replacement Values
        • Assets Manager
      • Theming
        • Configure Theme
        • Site-Specific Theming
        • Custom Field Display
      • Site Information Service
      • Custom Intents
        • Standard Android Intents
        • Platform Actions
        • Filtering
        • Technical Guide
      • Security and Safety
        • Clear App Data on Logout
        • Application Enabler
        • Disable Packages
        • Key Management
        • NFC Enable/Disable
        • Secure Notifications
        • Wi-Fi UI Settings Enable/Disable
        • Motion Activated Device Lock
        • Unique Login
        • Local Admin Password
        • Device Remote Lock
      • Device Loss Prevention
        • Low Battery Mode
        • Luggage Tag Mode
        • Secure Device Mode
      • Launcher Provider SDK
      • Load Configurations via QR Code Scan
      • Getting Started
      • Technical Guide
      • Release Notes
    • Authentication and SSO
      • Features
        • Secondary Authentication
          • PIN
          • Face Recognition
          • NFC Tag
          • Barcode
          • Alternate Secondary Authentication
      • Technical Guide
        • LDAP
        • AppAuth/OIDC
        • Okta (Session)
        • MSAL
        • ADFS 3.0/2012 Using ADAL
      • Release Notes
    • Support Application
      • Features
        • Events to Splunk
        • Logs to Azure
        • External Configuration Support
        • Application Usage History
        • Generating RxLogger Log Files
      • Technical Guide
        • Event Information
        • Event Examples
      • Support Installer
      • Getting Started
      • Release Notes
    • Device Finder
      • Features
        • Device Details
        • Device Status
        • View Site Devices
      • Technical Guide
      • Getting Started
      • Release Notes
    • Browser
      • Features
        • Custom Scripts
        • FIDO2 / Webauthn Support
        • URL AllowList and BlockList
      • Technical Guide
        • Configuring Browser
        • All Configuration
        • Available Intents
        • APIs and Page Actions
      • Release Notes
    • Chat
      • Features
      • Technical Guide
      • Getting Started
      • Release Notes
    • Playbook Agent
      • Features
      • Getting Started
      • Release Notes
    • Portal
      • Login & Logout
      • Navigation & Account Settings
      • Support Agent
        • Home
        • Device Details
        • Dashboards
        • Cards
        • Event Explorer
        • Reports
      • Enterprise Launcher
        • Creating a Configuration
        • Sending a Notification
        • Managing Sites
      • Playbook MDM
        • Playbooks
        • Plays
        • Devices
        • Deployment Groups
        • Zebra StageNow
      • EMM Console
        • Overview
        • Setup
          • Enroll Org in EMM
          • Policy Management
          • Provisioning
          • Device Management
          • Installing Playbook in EMM
        • Troubleshooting
          • Device Issues
          • Policy Issues
      • Chat Manager
        • Overview
        • Chat Roles
        • Chat Channels
        • Chat Audio Transcription
        • Message Logs
      • Admin
        • Organization
        • Single Sign On
          • Azure Setup
          • Okta Setup
          • Google Workspace Setup
          • Portal Setup
        • Users
        • Roles
          • Overview
          • Predefined Roles
          • Permissions
          • Manage Roles
        • Downloads
        • Agents
        • Key Management
          • Overview
          • API Keys
          • Device Keys
          • Device Restrictions
          • Allowed IP Addresses
        • Enterprise
        • Audit Logs
      • Event Forwarding
      • Remote Control
      • Getting Started
      • Release Notes
    • Other Applications
      • Messaging
        • Features
        • Technical Guide
        • Release Notes
      • Keyboard
        • Features
        • Technical Guide
          • How to: Set Keyboard as default
        • Release Notes
      • Bluetooth
        • Features
        • Release Notes
      • Voice Chat
        • Features
        • Release Notes
      • Device Remote Control
        • Features
        • Technical Guide
        • Release Notes
      • Device ID
        • Features
        • Technical Guide
        • Release Notes
      • Suite Installer
        • Technical Guide
        • Release Notes
      • Accessibility Enabler
        • Release Notes
      • EPM Plugin
        • Features
        • Technical Guide
        • Release Notes
    • Workforce Identity
  • Technical Documentation
    • Updating License Key
    • Commonly Reported Issues
    • Deploying BlueFletch Enterprise
      • Android 10 and 11
      • MDMs
        • Workspace One (VMWare AirWatch)
        • SOTI
        • Microsoft Intune
          • Microsoft Intune + Playbook
      • From Portal to Playbook Agent
Powered by GitBook
On this page
  • Configuration via Launcher
  • Configuration via Intents
  • Action to set a configuration
  • Reset back to Defaults
  1. Product Guides
  2. Browser
  3. Technical Guide

Configuring Browser

BlueFletch Browser configuration can be set using the following methods:

  • Using the Launcher - the BlueFletch Launcher contains a separate section for specifying the BlueFletch browser defaults, as well as override at a per-shortcut basis.

  • Using Intents - this can be used to set specific default configuration values when used in Standalone mode (e.g. without the BlueFletch Launcher).

  • Using Managed Configuration - If deployed from the managed Play Store, you can specify the configuration as a JSON string when the application is deployed to the device.

Configuration via Launcher

To apply different default settings for the Browser, specify the new default values inside the browser section in the Launcher configuration file. By specifying this section, BlueFletch Browser will use this configuration everytime a new browser instance is opened.

"browser" : {
    "showTitle" : "true",
    "allowUrlEdit" : "false",
},
"browserRestrictions" : {
    "blockList" : [
       "facebook.com"
    ],
    "allowList" : []
}

In the above example, everytime a web shortcut is started in the BlueFletch browser, it will show the title in a toolbar, and not allow the user to edit the URL. The browserRestrictions section also applies, and will allow the user to navigate to all sites except facebook.com and its sub-domains.

When configuring shortcuts in Launcher, you can also define overrides which will be applied to that particular shortcut only. Given the configuration below:

"layouts" : [
    "Associates" : [
        {
            "label" : "Office 365",
            "url" : "https://office.com",
            "browser" : "com.bluefletch.ems.browser",
            "browserOverrides" : {
                "showTitle" : "false",
                "allowCameraAccess" : "true"
            }
        },
        {
            "label" : "BlueFletch",
            "url" : "https://www.bluefletch.com",
            "browser" : "com.bluefletch.ems.browser"
        },
        {
            "label" : "Store Fletch",
            "url" : "http://10.1.120.39:8080",
            "browser" : "com.bluefletch.ems.browser",
            "browserOverrides" : {
                "allowInsecureSites" : "true"
            }
        },
    ]
],
"browser" : {
    "showTitle" : "true",
    "allowUrlEdit" : "false",
}

In the above configuration setting, the browser section indicates that all browser instances will show the title, and all the other BlueFletch Browser default values. For the three shortcuts defined:

  • Office365 will render without a toolbar because showTitle for that URL is set to false;

  • BlueFletch websites will render showing the title;

  • Store Fletch website has a necessary override to allow insecure sites set to true to allow it to render (because it is an internal site and does not use https). But because this override is specific to this shortcut, insecure sites will not be allowed from the Office or BlueFletch websites.

Configuration via Intents

Starting with version 2.2.x, Browser can now be configured by sending Intent Actions to set individual configuration parameters that persist on the device. If using the Browser in Standalone mode (e.g. without the BlueFletch Launcher), this allows you to change the default behavior of the BlueFletch Browser.

Action to set a configuration

Action Name: com.bluefletch.ems.browser.ACTION_SET_CONFIG

Extras:

  • Value - the new default value for the configuration field/key.

When the BF Browser receives this command, it will save the desired configuration in its local preferences file, and will apply to sites that are opened going forward. This will preference will not be deleted unless the Browser is uninstalled, or if it's application data is cleared.

The following example shows multiple ADB commands to set the title and allow and blocklist values:

adb shell am start -a com.bluefletch.ems.browser.ACTION_SET_CONFIG --es showTitle "true"
adb shell am start -a com.bluefletch.ems.browser.ACTION_SET_CONFIG --es blockList ".*facebook.com,.*twitter.com"  

You can send the command again with a different value to change or replace a configuration field/key.

allowList and blockList configuration fields accept a comma delimited string of the filter rules. If you need to add or remove a filter entry, you must send the entire string again to the blockList or allowList to replace the current settings.

Reset back to Defaults

This action will revert all requested overrides to be reset to the default setting, including allowList and blockList entries.

Action Name: com.bluefletch.ems.browser.RESET_CONFIG

Extras: None

adb shell am start -a com.bluefletch.ems.browser.RESET_CONFIG

PreviousTechnical GuideNextAll Configuration

Last updated 1 year ago

Key - the configuration field/key to set all supported/available keys are described in the section.

all configuration