Key terms for BlackBerry Web Services developers

The table below lists and explains key terms that you may encounter as you become more familiar with the BlackBerry Web Services.

The following descriptions provide basic knowledge to help build your understanding of a BlackBerry Enterprise Server domain. For more detailed information, consult with your organization's BlackBerry Enterprise Server administrators, or visit www.blackberry.com/go/serverdocs to read the administrator documentation for the BlackBerry Enterprise Server for Microsoft Office 365.

Term

Description

Access control

Administrators can configure access control rules to specify the web servers that users are permitted to access from their devices and the applications and services that are permitted to push data to devices. Administrators define access controls by configuring pull rules and push rules.

Administrators configure access control rules using the BlackBerry Administration Service.

Administrator account

Administrator accounts are used to log in to the BlackBerry Administration Service and manage the BlackBerry Enterprise Server. Each administrator account is assigned a role that determines what actions the administrator can perform.

The BlackBerry Enterprise Server is installed using a service account (for example, BESAdmin). An administrator user can then log in to the BlackBerry Administration Service using the service account and create one or more administrator accounts for other users. If an administrator account has a role with the appropriate permissions, that administrator can create other administrator accounts.

Application control policy

Administrators use application control policies to control the data and APIs that applications can access on devices and the external data sources and network connections that applications can access. When an administrator adds an application to a software configuration, the administrator must assign an application control policy to the application.

The BlackBerry Administration Service includes a standard application control policy for applications that are classified as required, optional, or not permitted. Administrators can change the default settings of the standard application control policies, or create custom application control policies.

BlackBerry Administration Service

The BlackBerry Administration Service is the web-based administration console for the BlackBerry Enterprise Server. Administrators log in to the BlackBerry Administration Service to manage server components, user accounts, and devices in the BlackBerry Enterprise Server domain.

The BlackBerry Web Services provide custom applications with access to many of the management capabilities of the BlackBerry Administration Service.

BlackBerry Attachment Service

The BlackBerry Attachment Service is the component of the BlackBerry Enterprise Server that converts supported message attachments into a format that users can view on their devices.

BlackBerry Configuration Database

The BlackBerry Configuration Database is a relational database that is installed with the BlackBerry Enterprise Server. The BlackBerry Configuration Database contains user account information and configuration information that the BlackBerry Enterprise Server components use.

BlackBerry Controller

The BlackBerry Controller is the component of the BlackBerry Enterprise Server that monitors all server components and restarts them if they stop responding.

BlackBerry Collaboration Service

The BlackBerry Collaboration Service is the component of the BlackBerry Enterprise Server that provides a connection between an organization's instant messaging server and the collaboration client on devices.

BlackBerry device-enabled

A user account or administrator account is BlackBerry device-enabled if the account is allowed to be associated with a device. Generally, user accounts are BlackBerry device-enabled, and administrator accounts may or may not be device-enabled, depending on whether administrators require devices.

Administrators can configure whether accounts are device-enabled using the BlackBerry Administration Service.

BlackBerry Dispatcher

The BlackBerry Dispatcher is the component of the BlackBerry Enterprise Server that maintains an SRP connection with the BlackBerry Infrastructure over the Internet. The BlackBerry Dispatcher is responsible for compressing and encrypting and for decrypting and decompressing data that travels over the Internet to and from the devices.

BlackBerry Infrastructure

The BlackBerry Infrastructure validates SRP information and controls the IPPP traffic that travels outside an organization's firewall to and from devices.

BlackBerry Policy Service

The BlackBerry Policy Service is the component of the BlackBerry Enterprise Server that performs administration services over the wireless network. The BlackBerry Policy Service sends IT policies and IT administration commands to devices to configure user permissions and security settings, and also sends the service book to devices to configure device settings and services.

BlackBerry MDS Connection Service

The BlackBerry MDS Connection Service is the component of the BlackBerry Enterprise Server that permits users to access web content, the Internet, or an organization's intranet. It also permits applications on devices to connect to the organization's application servers or content servers for application data and updates.

BlackBerry Messaging Agent

The BlackBerry Messaging Agent is the component of the BlackBerry Enterprise Server that connects to the Server Connector for Microsoft Office 365 to access messaging services, calendar management, address lookups, attachment viewing, attachment downloading, and encryption key generation. The BlackBerry Messaging Agent synchronizes configuration data between the BlackBerry Configuration Database and the Messaging State Database.

BlackBerry Router

The BlackBerry Router is the component of the BlackBerry Enterprise Server that connects to the wireless network to send data to and from devices.

BlackBerry Synchronization Service

The BlackBerry Synchronization Service is the component of the BlackBerry Enterprise Server that synchronizes organizer data between devices and Microsoft Office 365 over the wireless network.

BlackBerry Web Desktop Manager

The BlackBerry Web Desktop Manager is a web-based application that allows device users to activate their devices and perform limited management tasks.

Enterprise Service Policy

Administrators can use the Enterprise Service Policy to control which devices in an organization's environment can connect to the BlackBerry Enterprise Server. Administrators can turn on and configure the Enterprise Service Policy using the BlackBerry Administration Service.

Group

Administrators use groups to apply a common set of configuration settings (software configurations, IT policies, roles, and so on) to multiple users that are designated as group members.

Administrators can create groups and assign users to groups using the BlackBerry Administration Service. Administrators can assign users to more than one group. The BlackBerry Administration Service resolves any conflicting group settings. Administrators can also assign groups to other groups.

Indirect group

A group that is assigned to a user indirectly. For example, an administrator adds a user to a group, and then adds the group to another parent group. The parent group is assigned to the user as an indirect group. The BlackBerry Administration Service resolves any conflicting settings.

Indirect IT policy

An IT policy that is assigned to a user indirectly. For example, an administrator adds a user to a group, and then adds the group to another parent group. The IT policy of the parent group is assigned to the user as an indirect IT policy. The BlackBerry Administration Service resolves any conflicting rule settings.

Indirect role

A role that is assigned to a user indirectly. For example, an administrator adds a user to a group, and then adds the group to another parent group. The role of the parent group is assigned to the user as an indirect role. The BlackBerry Administration Service resolves any conflicting settings.

Indirect software configuration

A software configuration that is assigned to a user indirectly. For example, an administrator adds a user to a group, and then adds the group to another parent group. The software configuration of the parent group is assigned to the user as an indirect software configuration. The BlackBerry Administration Service resolves any conflicting settings.

Indirect VPN profile

A VPN profile that is assigned to a user indirectly. For example, an administrator adds a user to a group, and then adds the group to another parent group. The VPN profile of the parent group is assigned to the user as an indirect VPN profile. The BlackBerry Administration Service resolves any conflicting settings.

Indirect Wi-Fi profile

A Wi-Fi profile that is assigned to a user indirectly. For example, an administrator adds a user to a group, and then adds the group to another parent group. The Wi-Fi profile of the parent group is assigned to the user as an indirect Wi-Fi profile. The BlackBerry Administration Service resolves any conflicting settings.

IT policy

Administrators use IT policies to configure user permissions and security settings for each user's device. An IT policy is a collection of IT policy rules that are configured individually. Each IT policy rule controls a specific device feature or setting.

Administrators can create IT policies and assign IT policies to users or groups using the BlackBerry Administration Service. If a user is assigned multiple IT policies, the BlackBerry Administration Service resolves any conflicting rule settings.

If an administrator does not specify a custom IT policy for a user or group, the preconfigured Default IT policy is assigned. Administrators can create and assign custom IT policies at any time, or they can change the configuration of the Default IT policy.

Job

The BlackBerry Administration Service creates jobs to deliver applications, profiles, and IT policies to devices. A job is created whenever an administrator assigns a software configuration, IT policy, or profile to users or groups, or changes a software configuration, IT policy, or profile that was previously assigned.

A job consists of multiple tasks. Each task delivers a specific object or setting (for example, an IT policy) to a device.

Administrators can change the default settings that control how the BlackBerry Administration Service creates jobs and delivers tasks to devices.

Messaging State Database

The Messaging State Database is a relational database that is installed with the BlackBerry Enterprise Server. The Messaging State Database contains the state of the data that is synchronized to devices. It is connected to the BlackBerry Messaging Agent, the BlackBerry Synchronization Service, and the Server Connector for Microsoft Office 365.

Reconciled applications

Reconciled applications is the term used to refer to the applications that are installed on a device after the BlackBerry Administration Service resolves any conflicting settings in one or more software configurations that are assigned to a user.

Role

Administrators assign roles to administrator accounts to determine what actions the administrator can perform when they log in to the BlackBerry Administration Service. Each role consists of a set of permissions (also referred to as capabilities) that define what the administrator can or cannot do (for example, create users, create groups, and so on). The BlackBerry Administration Service includes various preconfigured roles that are designed for different types of administrators.

Administrators can create and assign roles to administrator users or groups using the BlackBerry Administration Service.

Service book

The service book consists of various service records that configure device settings and features, and determine which services are available on the devices. The BlackBerry Enterprise Server sends the service book to devices when the devices are activated.

Software configuration

Administrators use software configurations to install, upgrade, remove, and manage applications on devices.

Administrators create and assign software configurations to users or groups using the BlackBerry Administration Service. Administrators can assign more than one software configuration to a user or group. The BlackBerry Administration Service resolves any conflicting settings.

User account

User accounts represent device users in an organization. Administrators add user accounts to the BlackBerry Enterprise Server using data from the organization's user directory.

Administrators create and manage user accounts, and associate user accounts with devices, using the BlackBerry Administration Service.

VPN profile

Administrators use VPN profiles to specify how device users connect to an organization's VPN.

Administrators can create and assign VPN profiles to users or groups using the BlackBerry Administration Service.

Wi-Fi profile

Administrators use Wi-Fi profiles to specify how device users connect to an organization's Wi-Fi network.

Administrators can create and assign Wi-Fi profiles to users or groups using the BlackBerry Administration Service.

Wipe

Wipe is the term used to describe the action of permanently deleting the data on a user's device.

Administrators can use the BlackBerry Administration Service to permanently delete the data on a user's device.



Was this information helpful? Send us your comments.