Device Administration
The Device Administration section of the App Studio allows an administrator to:
- View Active Devices
- Assign friendly names to device Ids
- View Apps in use on devices
- View Users active on device
- Block a device - prevents any apps or users from autheticating from that device
- Purge device data - sends a kill pill signal to any app on the device the next time the app attempts to autheticate.
Viewing Devices
In the device list view, all the devices that have used $fh.auth to access apps will be listed here. The device label, device id, device status and the last access time will be displayed in the list. Clicking on any of the control buttons will bring you to the device update view.
The device id is a unique identifier of the device and it can not be changed. It is an identifier sent from the device and it will remain the same accross different apps on the same device (for hybrid or native apps). The only exception is web apps loaded in web browsers: the device id is a generated value and it is saved to the cookie. If the cookie is deleted, a new value will be generated.
Updating Devices
In this view, you can assign a friendly label name to a device, disable it from authtication or mark it for data purge. You can also check which users on the platform have been using the device and what apps have been accessed from the device.
If a device is disabled from authentication, all the apps on that particular device that are using $fh.auth to authenticate will fail and a special value will be returned to indicate that the device has been disabled. This is useful when a device is lost or stolen. See $fh.auth API (go to the relevant $fh.auth documentation for your client SDK).
If the "Mark for Data Purge" option is checked, two thing will happen:
- The device is disabled from authentication
- When apps on that device are using $fh.auth to authenticate, the authentication process will fail and a special value will be returned by the API to indicate all the existing app data should be deleted (the data delete function is subject to developers to implement).
For more details about $fh.auth API, please check the doc here (go to the relevant $fh.auth documentation for your client SDK).
Viewing Users of Devices
Everytime when $fh.auth is called from an app on a device, if the authentication process is succeeded and the user is a platform user, the access will be recorded. Thus you can see which users have been accessing from which devices in the "View Device" area.
There is a "Users" section showing a list of users ids that have been accessing using that device. Hover on each user id will show more details about the user, and click on it will bring you to the user manage view of that user.
Viewing Apps of Devices
Similar to capture user access, the app information is captured as well everytime $fh.auth API is called. You can view the list of apps in the "Store Item" section in the "View Device" area.
You can hover on each store item entry to get an overview of the app. If you click on any of them will bring you to the manage view of that particular store item.