# Organization

## User Guide: Admin Tab <a href="#user-guide-admin-tab" id="user-guide-admin-tab"></a>

### Overview <a href="#overview" id="overview"></a>

A BlueFletch Portal user who has been assigned a role with organization-level Admin [permissions](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/roles/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](#manage-organization) and the frequency of its communication with devices, view and copy the organization's [BlueFletch Enterprise license key](#license-key), setup [single sign-on](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/single-sign-on/portal-setup) functionality for the Portal, manage Portal [users](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/users) and their [roles](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/roles/manage-roles), [download the latest BlueFletch APK files](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/downloads), [view the available Playbook Agents](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/agents), manage [Enterprise Mobility Management (EMM)](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/enterprise) settings, and [query logs of changes to the Portal](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/audit-logs).

### Organization <a href="#organization" id="organization"></a>

The ***Organization*** subtab lists the essential details of the organization's BlueFletch 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 right are options for accessing **License Key,** **SSO Config**, and **Manage Organization** settings. For details on configuring an SSO, see the full documentation [here](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/single-sign-on/portal-setup).

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2FdZfsxQ5cYTwXnFwJleCs%2ForganizationAndMenu.png?alt=media&#x26;token=b1b02161-34b3-4244-ab89-6d547a0869c4" alt="" width="563"><figcaption></figcaption></figure>

#### License Key <a href="#license-key" id="license-key"></a>

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](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/enterprise-launcher/creating-a-configuration).

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2FjO4DMCP8TqiiFw8PxlHF%2FlicenseKey.png?alt=media&#x26;token=ad713e88-dd7b-4b0c-987d-dee24a8e7284" alt="" width="563"><figcaption></figcaption></figure>

#### Manage Organization <a href="#manage-organization" id="manage-organization"></a>

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.

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2F1ZiT7G8TcllRNJp1bmDZ%2ForgName%26Code.png?alt=media&#x26;token=c34bb00a-905e-45d0-8aaf-af04f87a5535" alt="" width="563"><figcaption></figcaption></figure>

#### **Contact**

Set details for the organization's contact person in the *Name* and *Phone* boxes.

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2FFCBf6sMIMkEzlanwyW8C%2ForgContact.png?alt=media&#x26;token=df7ea623-d17c-4bb1-ab58-a1abdda0375e" alt="" width="563"><figcaption></figcaption></figure>

#### **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.

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2FNtPVSavgNRn4dpiYuSw7%2ForgColors.png?alt=media&#x26;token=4fafe83a-cf0a-4726-8c40-8289f24abc72" alt="" width="563"><figcaption></figcaption></figure>

#### **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.

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2F8VA3vpKL5KudYxEaxxu0%2ForgLogo.png?alt=media&#x26;token=6878a25b-28b6-4bfd-bd88-cec53ca3e8f1" alt="" width="563"><figcaption></figcaption></figure>

The logo can also be removed by pressing **Remove Logo**. After logging back into the Portal, the custom logo will have been replaced with the BlueFletch logo.

#### **Portal Login 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 BlueFletch 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 BlueFletch 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 BlueFletch Portal after they enter the maximum number of incorrect passwords (default is 600).

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2F6U9yJdzRubniwhrIO2ZY%2FportalLoginOptions.png?alt=media&#x26;token=767b3b2f-9751-4b58-a260-5c32f20c1ea3" alt="" width="563"><figcaption></figcaption></figure>

#### **Key Management Options**

The *Legacy API Key* is listed statically at the top of the ***Key Management Options*** section.

If **Use Key Management** toggle is turned on, three settings are available for configuring [device key management](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/admin/key-management/device-keys):

* **Device Key Expiration Days:** The number of days that a device key stays active before it expires. The expiration timeframe can be set between a minimum of 30 and a maximum of 90 days (default is 45).\
  Each device key's expiration date, based on this configuration, is listed on the ***Admin - Device Keys*** page.
* **Device Key Rotation Days:** The number of days into a device key's lifecycle at which the Portal automatically generates a new key to replace the expiring key. The rotation timeframe can be be set between a minimum of 30 and a maximum of 90 days, and it must be less than the value of **Device Key Expiration Days** (default is 30).
* **Device Token Expiration Minutes:** The number of minutes that an access token is active on a logged-in device before it expires and is automatically regenerated by the Launcher. The expiration timeframe can be set to a value of 5 minutes or greater (default is 60).

The toggle **Enforce Allowed IP Addresses for Devices** is turned off by default. If turned on, this setting will prevent devices from connecting to BlueFletch data service APIs and retrieving organization data unless their IP addresses fall within an allowed list of IP ranges.

> **WARNING:** Please contact BlueFletch before turning the **Enforce Allowed IP Addresses for Devices** switch on, as BlueFletch will need to manually allow the organization's IP ranges or else all devices will be blocked from receiving organization data.

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2FiyyPjIz2oq53mDFU7gbe%2FkeyMgmtOptions.png?alt=media&#x26;token=ab7004a8-091b-4699-b634-614248f8b1aa" alt="" width="563"><figcaption></figcaption></figure>

#### **Organization Options**

An organization can choose to enable or disable the [*FindMe*](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/device-finder) feature on devices through the Device Finder application. If the **Allow Device FindMe** toggle is turned on, the Device Finder app will be able to ping other devices at the same site with the Device Finder app installed. If the toggle is turned off, devices will not be able to be pinged from other devices, but will still be able to be pinged from the Portal's ***Support Agent*** via specific dashboards or individual [Device Details](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/support-agent/device-details) pages.

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2F26lgr4L1mq1hPBj3F42V%2ForgOptions.png?alt=media&#x26;token=56b5253b-4bdc-4a6e-a907-313a10b3bff2" alt="" width="563"><figcaption></figcaption></figure>

#### **Support Data**

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.

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2Fnl7yHKAfWvi6micw2Eby%2ForgSupportData.png?alt=media&#x26;token=52fb9b3a-74ab-47d9-a084-a0c058bc044c" alt="" width="563"><figcaption></figcaption></figure>

#### **Playbook Agent Settings**

Selecting a value from the **Polling Interval** dropdown determines how often the [Playbook Agent](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/playbook-agent) on a device will check if there are changes in its BlueFletch Portal Playbook with which it should synchronize. The interval options in hours (h) are `0h`, `1h`, `2h`, `4h`, `8h`, `16h`, and `24h`. The default is `1h`. Use `0h` to turn hourly polling off.

<figure><img src="https://799338798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSxhNrDkmDAkv7QEWfOIh%2Fuploads%2F5c8PWFZnJINt1rBco23g%2ForgAgentSettings.png?alt=media&#x26;token=76122cf9-833a-4aad-855a-5a9527fb035d" alt="" width="563"><figcaption></figcaption></figure>

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).&#x20;

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.