Skip Navigation

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 route under "Allowed domains" 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 route" under Allowed domains applies to all domains that aren't otherwise specified in the profile. This option allows for detailed control over how
BlackBerry Dynamics
apps can connect to app servers. For more information, see Setting the default route for BlackBerry Dynamics app data.
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:
  • Discrete addresses:
    Example: 192.168.2.0-192.168.2.255
  • An entire subnet:
    Example: 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.