Agentry Client for iOS Branding Overview

The Agentry Client for iOS is available on the Apple App Store for iPhone, iPod Touch, and iPad mobile devices. The client available is branded by SAP as a generic Agentry Client and can be downloaded and installed as such. For partners and customers wishing to re-brand the Agentry Client and to deploy the client using an enterprise server, SAP provides a channel to have such a client made available.

For those familiar with the branding process for the Agentry Client for Windows, it is important to note that this process is separate and not related in any way. When deploying a branded application that utilizes both the Agentry Client for Windows and iOS platforms, it is necessary to brand both using the process specific to that platform. The most notable difference in these processes is the requirement of sending the branding resources to SAP, via a customer message through SAP Service Marketplace, which in turn results in SAP building the branded iOS Agentry Client and returning the resulting build to you when completed.

The branding of an iOS Agentry Client involves multiple steps, including obtaining certificates from Apple, as well as generating items such as images and other resources. These items must then be provided to SAP in conjunction with a request to generate a branded iOS Agentry Client. SAP will then build the branded Agentry Client and provide it to the requesting party. Such requests should be made through a customer message submitted through SAP Service Marketplace.

This technical bulletin provides details and instructions on each of the resources needed by SAP to create the branded iOS Agentry Client. In general, the following types of items are needed:

Various certificates and other possible items, as provided by Apple
Image files in the Portable Network Graphics (.png) format containing the branded images to be used within the application.
The name of the application as it should be displayed on the Agentry Client.
If necessary, the specific type of iOS device upon which the application should be limited, e.g. only iPad, no iPhone or iPod Touch. (This is optional and is typically not necessary for most deployments.)

Once these items have been obtained, they should be provided to SAP with the request to generate the branded iOS Agentry Client. The SAP support department will respond to such requests with information regarding duration to generate the branded Agentry Client, as well as any additional information that may be needed.

Additional Information on Obtaining Apple Certificates

Apple’s requirements regarding application distribution for both enterprise (i.e. “internal”) deployment and iTunes Store dictate the specific needs of obtaining the certificates and other resources discussed in this technical bulletin.

Important: In order to obtain the certificates and other resources from Apple, it is required that your firm have a membership in either the iOS Developer Program or the iOS Developer Enterprise Program. Details on these programs and enrollment in them is available at the links provided below.

Information provided in this technical bulletin covering these specific needs is intended as guidance only. For official information on these resources, see Apple’s web pages covering these topics, including required developer licenses:

iOS Developer Program

https://developer.apple.com/programs/ios/

iOS Developer Enterprise Program

https://developer.apple.com/programs/ios/enterprise/

In general, if the application is to be distributed via iTunes, the needed Apple resources must be obtained using the iOS Developer Program. For applications that are to be distributed internally, i.e. via an Enterprise Server, the needed resources must be obtained via the iOS Developer Enterprise Program. Details on each program are provided at the above links, and these requirements are specified by Apple, not SAP.

Procedure Overview

The following provides a list of the tasks to be accomplished in order to obtain a branded iOS Agentry Client. The details of these main tasks are provided in subsequent sections of this technical bulletin:

Obtain the appropriate certificates and identifiers from Apple, including the distribution certificate and private key, provisioning profile built using the distribution certificate, and possible the APNS Certificate and private key password if push functionality is to be supported.
Generate the images according to provided specifications to be used to brand the Agentry Client. All images must be in the Portable Network Graphics (.png) format and must adhere to the image sizes provided in the information in this technical bulletin.
Provide the above resources, along with the specific name by which the application will be labeled, with a request to SAP Service Marketplace via a customer message. SAP will use these items to build a branded iOS Agentry Client. You will receive information in response to your request indicating when the branded iOS Agentry Client will be made available.
Once the branded iOS Agentry Client is returned Submit the application to Apple for placement on iTunes, or place the application on the Enterprise Server at the implementation site, according to Apple’s standard procedures.