BlackBerry Dynamics connectivity profile settings

BlackBerry Dynamics connectivity profiles are supported on the following device types:
  • iOS
  • macOS
  • Android
  • Windows

BlackBerry Dynamics connectivity profile setting

Description

Name

Specify a name for the BlackBerry Dynamics connectivity profile.

Description

Specify a description for the BlackBerry Dynamics connectivity profile.

Infrastructure

Route all traffic

For apps developed with a version of the BlackBerry Dynamics SDK earlier than 6.0, this setting specifies whether all BlackBerry Dynamics app data is routed through BlackBerry Proxy. This option takes precedence over other settings in the profile. If you select Route all traffic, you can specify a BlackBerry Proxy cluster to route through or select Deny to block all connections.

For apps developed with BlackBerry Dynamics SDK version 6.0 and later, the "Default allowed domain route type" replaces this setting.

You should select this option only if your organization uses custom or ISV apps developed with a version of BlackBerry Dynamics SDK earlier than 6.0. Recent versions of BlackBerry Dynamics apps released by BlackBerry use a version of the SDK later than 6.0.

This setting is not included in BlackBerry UEM Cloud.

Allowed domains

A list of the Internet domains that your organization wants to control access to. For example, blackberry.com controls access to any server in the blackberry.com domain. BlackBerry Dynamics apps are allowed to connect through your organization's firewall to any server in the listed domains and their subdomains.

For BlackBerry Dynamics apps running BlackBerry Dynamics SDK versions 6.0 and later, the "Default allowed domain route type" applies to all domains that aren't otherwise specified in the profile.

To add a new domain to the Allowed domains list, click The Add icon and configure the settings for the domain. To remove a domain from the list, click The Remove icon beside the domain that you want to remove.

Domain

Specify the Internet domains that you want to allow or deny access to. For example, blackberry.com allows access to any server in the blackberry.com domain. BlackBerry Dynamics apps are allowed to connect through your organization's firewall to any server in the listed domains and their subdomains.

BlackBerry Proxy cluster

Select this option to specify the BlackBerry Proxy clusters that must be used to reach the domain.

Direct

Select this option to route traffic directly from the app to the domain without going through BlackBerry Proxy. This option is supported only for apps developed with BlackBerry Dynamics SDK version 6.0 and later.

Deny

Select this option to block the app from connecting to the domain. This option is supported for apps developed with BlackBerry Dynamics SDK version 6.0 and later.

Primary

Select the name of the BlackBerry Proxy cluster from the drop-down list to use as the primary route that the app uses to connect to the domain.

Secondary

Select the name of the BlackBerry Proxy cluster from the drop-down list to use as the backup route that the app uses to connect to the domain if the primary cluster is down.

Default domains

A list of the default allowed domains (for example, qa.blackberry.com). BlackBerry Dynamics apps may try to connect to an unqualified hostname like "portal" instead of using a fully qualified name like "portal.sales.xyzcorp.com". The domains in this list will be appended to unqualified hostnames to construct fully qualified names.

To add a new domain to the Default domains list, click The Add icon and configure the settings for the domain. To remove a domain from the list, click The Remove icon beside the domain that you want to remove.

Domain

Specify the domain that you want to add to the Default domains list.

Primary

Select the name of the BlackBerry Proxy cluster from the drop-down list to use as the primary route the app uses to connect to the domain.

Secondary

Select the name of the BlackBerry Proxy cluster from the drop-down list to use as the backup route the app uses to connect to the domain if the primary cluster is down.

Additional servers

A list of additional servers that BlackBerry Dynamics apps can connect to. Add servers to this list if you want BlackBerry Dynamics apps to connect only to certain servers and not to every server in a domain.

To add a new server to the Additional servers list, click The Add icon and configure the settings for the server. To remove a server from the list, click The Remove icon beside the server that you want to remove.

Server

Specify the fully qualified domain name of any additional servers that BlackBerry Dynamics apps can connect to. Add servers to this list instead of using the "Allowed Domains" list if you want BlackBerry Dynamics apps to be able to connect only to certain servers and not to every server in a domain. Servers, routing types, and BlackBerry Proxy clusters listed in this section have precedence over entries listed in the “Allowed Domains” section.

Port

Specify the port that the server uses.

BlackBerry Proxy cluster

Select this option to specify the BlackBerry Proxy clusters that must be used to reach the domain.

Direct

Select this option to route traffic from the app to the server without going through BlackBerry Proxy. This option is supported only for apps developed with BlackBerry Dynamics SDK version 6.0 and later.

Deny

Select this option to block the app from connecting to the server. This option is supported for apps developed with BlackBerry Dynamics SDK version 6.0 and later.

Primary

Select the name of the BlackBerry Proxy cluster from the drop-down list to use as the primary route the app uses to connect to the server.

Secondary

Select the name of the BlackBerry Proxy cluster from the drop-down list to use as the backup route the app uses to connect to the domain if the primary cluster is down.

IP address ranges

A list of IP address ranges that BlackBerry Dynamics apps can access when they make a connection request using an IP address rather than a hostname.

To add a new IP address range to the list, click The Add icon and configure the settings for the settings. To remove an IP address range from the list, click The Remove icon beside the range that you want to remove.

Range

Specify a range of IP addresses that BlackBerry Dynamics apps can access when they make a connection request using an IP address rather than a hostname. Address ranges must be entered with a lower and upper bound address (for example, 192.168.2.0-192.168.2.255) or in IPv4 CIDR notation (for example, 192.168.2.0/24). For example:

  • Example of discrete addresses: 192.168.2.0-192.168.2.255

  • Example of an entire subnet: 192.168.2.0/24

BlackBerry Proxy cluster

Select this option to specify the BlackBerry Proxy clusters that must be used to reach the IP address range.

Direct

Select this option to route traffic directly from the app to the IP address range without going through BlackBerry Proxy. This option is supported only for apps developed with BlackBerry Dynamics SKD version 6.0 and later.

Deny

Select this option to block the app from connecting to the IP address range. This option is supported for apps developed with BlackBerry Dynamics SDK version 6.0 and later.

Primary

Select the name of the BlackBerry Proxy cluster from the drop-down list to use as the primary route that the app uses to connect to the IP address range.

Secondary

Select the name of the BlackBerry Proxy cluster from the drop-down list to use as the backup route the app uses to connect to the IP address range if the primary cluster is down.

App servers

Add

If you have one or more BlackBerry Dynamics apps that are served from an app server or web server, you can specify the name and port of the server and the priority of the BlackBerry Proxy clusters used for communication with it. You can also set the priority of the app server to the client app as primary, secondary, or tertiary. All BlackBerry Dynamics apps served by the app server or web server are able to use the connection settings you specify.

If you have BlackBerry UEM Cloud and a BEMS Cloud in your environment and you configured Email notifications or BEMS-Docs to create a BEMS tenant, the BEMS Cloud URL, port number, and priority are added automatically to the App servers payload section.

For more information, see Add an app server to a BlackBerry Dynamics connectivity profile.