Installation Package preparation for Windows Phone

Introduction

For Windows Phone devices, the agent is installed on the target device through a Windows Phone application. The following files must be on the RCS server to successfully complete agent installation:

Recommended sequence

Complete the following steps to generate the .pfx and .aetx files and load them on the RCS server:

Step Action
1

Obtain a Symantec ID code to be used to purchase the certificate required to distribute a Windows Phone application.

2 Obtain the Symantec certificate required to distribute Windows Phone applications.
3

Install the Symantec certificate required to distribute Windows Phone applications.

4 Generate the .pfx and .aetx files
5 Load the .pfx and .aetx files on the RCS server
How to read these instructions

NOTE: links to web pages in the procedures were working when the manual was written. If the link does not work, find the right web page..

In the event of discrepancies between that indicated in the manual and the instructions received directly from the concerned organizations, follow the organizations' instructions.

Obtaining a Symantec ID code

Proceed as follows to obtain it:

Step Action
1 Register a Microsoft account in https://signup.live.com/signup.aspx?lic=1.
2

Register an account in Windows Phone Dev Center logging in with your Microsoft account in https://dev.windowsphone.com/en-us/join/

3
  • Click Join Now: the Windows Phone Dev Center account registration page appears.
  • Select Company as Account Type.
  • Click Next.
  • In the Account Info section, enter your data and contacts.
  • In the Publisher Info section, enter the name to be displayed as the application distributor during installation as the Publisher Name.

WARNING: the user who installs the .xap packet and .aetx certificate on his phone sees this name.

  • In the Approver Info section, enter the data and contact information for the company manager who can approve the registration request.
  • Complete registration following the on-screen instructions.

IMPORTANT: provide a correct e-mail address and phone number since they will be used to validate registration and send the Publisher ID.

4

After registering, you will receive an email from Symantec, the Microsoft partner that validates companies registered with Windows Phone Dev Center, to validate registration. Additional communications may also occur by phone.

IMPORTANT: have the Approver promptly respond to the Symantec email.

5

After validation, you will receive an email with account data:

  • Publisher ID
  • Publisher Name

NOTE: to learn more, visit http://msdn.microsoft.com/library/windowsphone/help/jj206719(v=vs.105).aspx

Obtaining a Symantec certificate

The Enterprise Mobile Code Signing Certificate is required to distribute Windows Phone applications.

Proceed as follows to obtain it:

Step Action
1

Purchase a Enterprise Mobile Code Signing Certificate from Symantec at https://products.websecurity.symantec.com/orders/enrollment/microsoftCert.do.

2
  • Enter the Publisher ID you received and the email indicated in the Account Info section during Windows Phone Dev Center registration.
  • Complete the purchase following the on-screen instructions.
3

When finished, you will receive a couple of emails from Symantec indicating:

  • order confirmation
  • the list of enabled functions according to the order
  • the certificate and instructions on how to import it on your computer

NOTE: to learn more, visit https://knowledge.verisign.com/support/code-signing-support/index?page=content&id=SO20770&actp=search&viewlocale=en_US

Installing the Symantec certificate

To complete Enterprise Mobile Code Signing Certificate installation, first install:

IMPORTANT: always use the same browser to download certificates. The Firefox browser is referred to in the described procedure.

Follow the procedure below:

Step Action
1 Open Firefox.
2

Copy and paste the URL received in the email in the address bar to install Microsoft Enterprise Mobile Root Certificate.

3

In the Download certificate window, flag all three combo boxes and click OK.

4

Copy and paste the URL received in the email in the address bar to install Microsoft Enterprise CA Root Certificate.

4

In the Download certificate window, flag all three combo boxes and click OK.

NOTE: to check whether certificates were installed, select the certificate in the Firefox menu, Options, and select Advanced. Next select the Certificates tab and click on Show Certificates: the names of the installed certificates appear in the certificate list in the Authorities.

5

Install Enterprise Mobile Code Signing Certificate from the link in the email you received and click Continue.

Generate the .pfx and .aetx files

The .pfx and .aetx files required to sign and distribute Windows Phone applications can be generated with Enterprise Mobile Code Signing Certificate.

IMPORTANT: the procedure requires Windows Phone Software Developer Kit 8.0, available at http://www.microsoft.com/it-it/download/windows.aspx to be installed on the computer. The AET Generator tool included in this kit lets you create the .aetx file.

IMPORTANT: use the same browser used to install the certificates to run the procedure. The Firefox browser is referred to in the described procedure.

Follow the procedure below:

Step Action
1

Open Firefox.

2

In the Firefox menu, select Options. Next, select Advanced, and then the Certificates tab.

3

Click Show Certificates.

4
  • In the Personal certificates tab, select the Publisher name certificate and click Export
  • Save the file with the .p12 extension
  • Enter the certificate export password: "password"

IMPORTANT: enter this and not other passwords.

5 Rename the file with the .pfx extension
6

From the Windows command prompt, open the folder where the .pfx file is saved and run the following command:

"%ProgramFiles(x86)%\Microsoft SDKs\Windows Phone\v8.0\Tools\AETGenerator\AETGenerator.exe" FileName.pfx password

where FileName is the name of the .pfx file.

Result: three files are generated in the folder where the .pfx file is saved:

  • AET.aetx
  • AET.aet
  • AET.xml

NOTE: to learn more, visit http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj206943%28v=vs.105%29.aspx

Load the .pfx and .aetx files on the RCS database server

Follow the procedure below:

Step Action
1

Copy the files to the RCS database server

2

From the Windows command prompt, run the following command to use the .pfx file to sign Windows Phone applications:

rcs-db-config --sign-pfx-winphone FilePath\FileName.pfx

where FilePath is the .pfx file path on the RCS server

3

From the Windows command prompt, run the following command to use the .aetx file as a Windows Phone application certificate:

rcs-db-config --sign-aetx-winphone FilePath\FileName.aetx

where FilePath is the .aetx file path on the RCS server