Users

GigaFox user information and profile management is available on the GigaFox Users page. Users can create, update, and edit their own profiles through the Users section, but must have administrative privileges or the proper User entitlements to access an account other than their own.

Users List

Displays the list of users, user status, name, email, and their role(s). The information immediately available on the Users page can be sorted by column and/or filtered by active or inactive user status.

Bulk Edit

Users with the proper entitlements can make bulk edits to user profiles on the User's page. Bulk actions include:

  1. Assign Roles: Add, Remove, Unchanged
  2. Activate
  3. Deactivate

To make bulk edits, enable the checkbox next to the user's name/email and click the edit button.

Create a User

New user accounts can be created by users with administrative privilages or the proper entitlements. To create a new user account:

  1. On the Users tab, click Create User.
  2. Select Role(s).
  3. Enable the Activate checkbox.
  4. Optional: Fill in the Personal Information fields.
  5. Optional: Fill in Contact information.
  6. Fill in Password section and click Save.

At the bottom of the page, enable the Create another user checkbox to automatically launch a new create user page.

Modify User Account

Users can edit their own account information, but only users with the modify entitlement can edit user information on other user accounts.

To modify a user's information:

  1. On the Users tab, click the user's link.
  2. Modify user information and click Save.

API token

As an alternative to user passwords, once the account is created, all GigaFox users are provided with an API token to use when accesing their account.

To locate the API token:

  1. Navigate to the user's information page and scroll down to API token.
  2. Click View token to reveal it.

To generate a new user API token, click Regenerate token.

User List Import

User lists can be imported into GigaFox by uploading a CSV file with user data. There are two ways to create user import file:

  1. Export the list from the GEM.

    2. or

  2. Download and enter data into a blank template:
    1. Click the Import button.
    2. Click the download the blank template link.
    3. Manually enter user data. The email and password fields are required, all other fields are optional.

To Import a Users List:

  1. Click the Import button.
  2. Click Upload User List File.
  3. Select a file from the Finder window and click Open.

or

Or use the -userimport command on the CLI.

Roles that are not found are ignored. If roles are not matched, users are assigned a role of least entitlement.

User List Export

To create a CSV user list:

  1. Click the Export button to download the list.

    2. or

  2. Or use the -userexport command on the CLI.

User Usage

User usage data displays a time-based table of device's time in use.

The Usage tab includes:

Date Date and time the device was retained.
Duration The length of time the device was retained.
Device The retained device, link to the device's details page.
User User's name, a link to the user's details page.
Application The application launched while the device was retained, a link to the application's details page.
Reserved If the user had reserved the device for testing, this column displays Yes.

By default, Usage displays the past 30 days of activity, but can be filtered by all, today, last 7 days, or customize a start/end date.

Usage data can also be downloaded by clicking the Full table link. The download contains additional user and device data not shown on the Usage table, with a maximum of 10,000 rows.

User History

User usage data displays a time-based table of a device activity/event.

The History table includes:

Date Date and time the device was retained.
Event The activity/event performed on the phone.
Device The retained device, link to the device's details page.
User User's name, a link the user's details page.
Application The application launched while the device was retained, a link to the application's details page.

An Event can be any of the following:

User Login The time a user signed in and out of GigaFox.
User Created The time a user was created in GigaFox.
Device Retirement The time a device was retained or released.
Device Enablement When a user enables or disables a device.
Device Deletion When a user adds or deletes a device.
Device Notes When a note is added to the device detail's page.
Application Launched When an application is launched on a device.
Application Install When an application is installed or uninstalled on a device.

By default, History displays the past 30 days of activity, but can be filtered by all, today, last 7 days , or customize a start/end date.

History data can also be downloaded by clicking the Full table link. The download contains additional user and device data not shown on the Usage table, with a maximum of 10,000 rows.

User Roles

Users are assigned roles with varying degrees of entitlements. These entitlements allow users access to certain features, functions, and actions. Once roles are assigned, users will only have access to the entitlements determined by assigned role(s). The only exception, before assigning roles, is the Administrator role. By default, Administrators have access to all entitlements.

WARNING: Some entitlements depend on others to work as intended. e.g., the create reservation entitlement requires the user to also have access to the device list entitlement in order to connect to devices.

Application entitlements include:

Entitlement Definition Tester
Application area access Permits access to the Applications area. By itself, this is not a security measure.
Application list Permits viewing the list of stored applications.
Application upload Permits uploading of applications for availability to users with ApplicationList.
Application download Permits downloading of any stored application to user’s local system.
Application modify Permits renaming of store applications
Application delete Permits permanent deletion of any stored application.

Device entitlements include:

Entitlement Definition Tester
Device area access Permits access to the Devices area. By itself, this is not a security measure.
Device list Permits viewing of connected devices and their states.
Device modify Permits renaming of the device, changing the note and assigned slot number.
Device enablement Permits enabling and disabling devices. Enabled devices count toward the license limit.
Device delete Permits permanently deleting any disconnected device.
Device connect Permits connecting to a device.
Device application management Permits installing and uninstalling of applications on a device.
Device release any Permits releasing of any retained device. Without, user may still release a device they have retained.
Device reboot Permits rebooting of devices.

User entitlements include:

Entitlement Definition Tester
User area access Permits access to the Users area. By itself, this is not a security measure.
User list Permits viewing names of all users in the system.
User modify Permits editing of a users details. Does permit changing of user names and activating/deactivating accounts. Does not permit changing of user roles.
User modify role Permits editing which roles are assigned to any user.
User modify self Permits a user to modify their own user details. Does not permit changing of user name, user roles, or activating/deactivating account.
User create Permits creation of new users.
User export Permits the user table to be exported.
User import Permits a user table to be imported.
User roles modify Permits the modification, deletion, and creation of user roles.

Reservation entitlements include:

Entitlement Definition Tester
Reservation area access Permits access to the Reservations area. By itself, this is not a security measure.
Reservation list Permits viewing of reservations made by any user. Without, a user can only see reservations created by themselves.
Reservation create Permits creation of new reservations.
Reservation delete any Permits deletion of any reservation. Without, a user can still delete reservations created by themselves.

System entitlements include:

Entitlement Definition Tester
System configuration area access Permits access to the System area. By itself, this is not a security measure.
Export logs Permits user to export system logs.
Service restart Permits user to restart services. While services are restarting, GigaFox can not be used.
Empty trash Permits user to remove unused service files.
Manage iOS system application Permits user to upload new iOS deviceControl applications and view the state of provisioning profiles and signing keys available on the GEM.
Manage system settings Permits user to alter administrative system settings for deviceControl.
View Gateways Permits user to view the status of connected device gateways and the associated USB hubs/ports.
Manage USB hubs Permits user to change the state of USB hub ports connected to device gateways, and perform other administrative actions such as reboot.
Manage GigaFox license Permits user to replace GigaFox’s license with any new valid license file.

System Notices entitlements include:

Entitlement Definition Tester
GigaFox license expiration Permits user to see the global notice about pending GigaFox license expiration.
iOS provisioning issues Permits user to see global notices regarding iOS provisioning issues.

Roles

User roles can be customized to grant specific entitlements with various degrees of access. Users can be granted more than one role, but once roles have been assigned, the user will only have access to the entitlements specified in the role's details.

To create a new role:

  1. On the Users page, click Roles.
  2. On the first panel, click Add.
  3. On the Add Role dialog, enter the role name and click Add.
  4. Enable entitlements and click Save.

To rename a role:

  1. On the Users page, click Roles.
  2. Select the role and click Rename.
  3. On the Rename Role dialog, enter and new name and click Rename.

NOTE: The Administrator role cannot be renamed.

To delete a role:

  1. On the Users page, click Roles.
  2. Select the role and click Delete.
  3. On the Delete role dialog, click Delete.

To modify a role:

  1. On the Users page, click Roles.
  2. Select the role.
  3. Make the changes and click Save.

Device Access Controls

By enabling the Device Access Controls feature, GigaFox allows users to be given explicit device access by assigning devices to individual roles. Once Device Access Controls is enabled and devices are assigned to each role, the user’s device list will only display the devices their role(s) allow access to.

NOTE: Only the Administrator or users with the User roles modify role are granted access to Device Access Controls, the Device Access panel, and its settings. While enabled, only these roles will have access to all available devices at all times.

To enable Device Access Controls and assign devices:

  1. On the System tab, scroll down to Device Access Controls and enable the Enforce Device Access Controls checkbox.
  2. On the Users tab, click Roles.
  3. Select a role.
  4. On the Device Access panel, select the device(s) to assign to that role and click Save.

To disable Device Access Controls:

  • On the System tab, scroll down to Device Access Controls and disable the Enforce Device Access Controls checkbox.

Device Access Controls Entitlement

To grant a non-administrator user access to the Device Access Controls entitlement:

  1. On the Users tab, click Roles.
  2. Select a role.
  3. On the entitlement panel, select User roles modify entitlement and Click Save.