User Guide: Admin Tab
Overview
A Portal user who has been assigned a role with organization-level Admin permissions will have available some or all of the features within the Admin tab, depending on the precise permissions in his or her role. In its entirety, the Admin section allows an administrative user to configure settings for organization's Portal site and the frequency of its communication with devices, view and copy the organization's EMS license key, setup single sign-on functionality for the Portal, manage Portal users and their roles, download the latest BlueFletch APK files, view the available Playbook Agents, manage Enterprise Mobility Management (EMM) settings, and query logs of changes to the Portal.
Organization
The Organization subtab lists the essential details of the organization's Portal account, specifically its Organization ID, Organization State, License Expiration, Created at date and time, and last Updated at date and time.
Within a three-dot option menu on the left are options for accessing License Key SSO Config, and Manage Organization settings. For details on configuring an SSO, see the full documentation here.
License Key
Select the License option to open a pop-up window displaying the License Key value. The key can be copied for use elsewhere, such as in a Launcher Configuration file.
Manage Organization
Select the Manage Organization option to open the organization's settings editor.
The Name and Code of the organization have already been set at the organization's creation, and cannot be edited here. Contact your BlueFletch representative if a change needs to be made to these values.
Contact
Set details for the organization's contact person in the Name and Phone boxes.
Color
To customize the organization's Portal theme to suit its brand colors, use the fields Primary color and Secondary color. Clicking Edit Color for each color allows selection of the color by a spectrum, hex code, RGB values, or HSL values. Primary color determines the color of the Portal's main navigation tab bar, several buttons, hyperlink text, and loading spinners. Secondary color determines the color of the subtab navigation bar.
Logo
An administrator can set a custom organization logo for the Portal, which will appear in the upper left corner on the main navigation bar of each page. Press Add Logo (or Change Logo if there is already a logo) and select an image file from the computer. After completing organization settings changes and pressing Save, the organization's logo will not update until after the user logs out and logs back in.
The logo can also be removed by pressing Remove Logo. After logging back into the Portal, the custom logo will have been replaced with BlueFletch's EMS logo.
Organization Options
Three login settings can be set for the organization:
- Token Expiration Days: The number of days that a user for that organization will stay logged-in to the Portal before their session expires. The options are 1, 7, 15, or 30 (default is 7).
- Maximum Login Attempts: The number of password attempts that a user has to login to the Portal before they are locked out (default is 10).
- Lockout Duration (seconds): The length of time in seconds that a user will be prohibited from logging-in to the Portal after they enter the maximum number of incorrect passwords (default is 600).
Support Data
The Support Analytics API Key is listed statically at the top of the Support Data section.
The administrator can establish the organization's default dashboard (the dashboard displayed on the Support Agent Home page). Select the desired dashboard from the list of main dashboards in the Default Dashboard dropdown menu. If not selected, the Home page will display the system default dashboard.
The Dashboard Timeframe (hours) field sets the default time/date filter range for all dashboards. The value must be a whole number and reflects hours prior to the current time (default is 48).
The Default Refresh Rate (minutes) field determines how frequently the Portal's dashboards refresh. The value most be a whole number, 2 or greater, and reflects the number of minutes to wait since the web page was opened or last refreshed.
Playbook Agent Settings
Selecting a value from the Polling Interval dropdown determines how often the Playbook Agent on a device will check if there are changes in its Portal Playbook with which it should synchronize. The interval options in hours (h) are 0h, 1h, 2h, 4h, 8, 16h, 24h, and the default is 1h. The toggle switch Polls for changes only while cradled sets whether the device-side agent will also check when it is off the charger/in use or only while charging (cradled). The default is "on" (true
), where the Agent only checks while cradled. Select a default Agent version number to allow Playbook MDM devices to automatically update their Playbook Agents to the version selected if they are outdated (optional).
After making all of any changes desired, press Save to save all changes - or Cancel to revert all changes - and return to the Organization page.