Skip to main content

Veritran Docs

Device Blacklist

The blacklist feature is used to block a device or series of devices from operating on the app. This is particularly useful when there is suspicion of fraud.

To see a list of devices on the blacklist, select the product you want to work with in the products drop-down menu. In the Product menu, select Device > Device Blacklist. See the annotated image below to learn more about this page.

img-033_DeviceBlacklist.jpg

  1. Search bar and filter. Type a keyword in the search bar to search for blacklist entries by code, value, brand, model or status. Check Active only to see only active entries.

  2. List of blacklist entries. Shows blacklist entries for the selected product in a table, with a row for each entry and the following columns:

    Code

    Criteria being used to blacklist a device or devices. For example, if the Code is APP_VERSION, devices whose app version matches the one specified on the Value field are blacklisted. Some of the codes available are APP_VERSION, DEVICE_ID, DEVICE_IP, GEO_DATE, and more.

    Value

    Value for the code. For example, if the code selected is APP_VERSION, the value shows the app's version number.

    Brand

    Device's brand, if specified.

    Model

    Device's model, if specified.

    Status

    Blacklist status can be Active (device or devices are blacklisted) or Inactive (device or devices are not blacklisted and may operate).

    Status Timestamp

    Shows when the status was last updated.

    Last Update

    Shows the day and time the blacklist entry was last updated.

    Actions

    Click the Edit button to edit the blacklist entry.

  3. New. Click to add a new entry to the Device Blacklist.

  4. Export. Select one or more entries by clicking the left checkbox and click Export PDF to export them in a PDF file. Click Export all PDF to export all entries.

Add or Edit a Device Blacklist Entry

To add an entry to the device blacklist, click New. The Create Device Blacklist Item window opens. Complete the following fields:

Product

This field is completed automatically depending on the product selected on the products drop-down menu.

Code

Select the code to specify which criteria should be used to blacklist a device or devices. For example, if the Code is APP_VERSION, devices whose app version matches the one specified on the Value field will be blacklisted.

The codes available are:

  • APP_VERSION

  • DEVICE_ID

  • DEVICE_IP

  • DEVICE_PLATFORM

  • DEVICE_RES

  • DEVICE_SERIAL

  • GEO_DATE

  • GEO_LAT

  • GEO_LONG

  • LAUNCH_TIME

  • LINE_NUMBER

  • MAC

  • OPERATOR

  • OS_VERSION

  • SIM_OPERATOR

  • SIM_SERIAL

Value

Type the value associated to the code assigned above. For example, if OS_VERSION is selected in the Code field, the Value field must contain the operating system version detail.

Brand

Type the brand of the device. This step is optional since it depends on how you fill in the fields above.

Model

Type the model of the device. This step is optional since it depends on how you fill in the fields above.

Active

Check Active to set the entry's status as active upon saving. The device or devices will be blocked from operating in the system.

Leave Active unchecked to set the entry's status as inactive upon saving. The device or devices will be allowed to operate in the system.

Click Save to create the entry on the blacklist or Cancel to discard.

To edit an entry on the blacklist, first select the product you want to work with in the Products drop-down menu. Then, go to Device > Device Blacklist in the Product menu, find the entry you want to edit and click Edit in the Actions column. The Edit Blacklist Item window opens, where you can edit the Brand and Model fields and activate or deactivate the entry. When you finish editing the entry, click Save.

In this section: