Knowledge Base

Information You Will Need

In order to generate your privatekey and certificate request files, you will need the following information.
(Put this information together before you being the process of generating these files.)

1. Privatekey Passphrase: A passphrase (or password) that you would like to use to protect your certificate.
   

2. Two-Character Country Code: A two character abbreviation of your country's name (US, AU, CA).
   

3. Full State Name: Full name of the state or province in which your business is headquartered (e.g. California, Queensland, Alberta)
   

4. Full City Name: Full name of the city in which your business is headquartered (e.g. Santa Rosa, Brisbane, Calgary)
   

5. Organization Name: Full name of your business (e.g. Phalanx Systems, Inc.)
   

6. Organization Unit Name: As seen in Step 14 image please Leave it Blank
   

7. Common Name: The common name is AppleCare-Partner-XXXXXXXXXX.Prod.apple.com, replacing XXXXXXXXXX with your 10-digit GSX Sold-To Account number. Make sure you have this correct -- Apple will deny your on-boarding request if you submit a certificate request with an incorrect common name
   (e.g. AppleCare-Partner-0008644927.Prod.apple.com).

8. Contact Email: The email address of one of your GSX Administrators (e.g. bill@yourcompany.com).
   

1. Open Terminal, paste in the following command, and press Return:

2. Terminal will prompt you to enter a passphrase for your privatekey.

Generate your Certificate Request

1. Open Terminal, paste in the following command, and press the Return:

2. Terminal will prompt you to enter the passphrase for the privatekey you generated in the steps above. Enter the passphrase you chose in the steps above and press Return.

Information You Will Need:

1. GSX Sold-To Account Number: The full, 10-digit GSX Sold-To Account for your company provided to you by Apple.
   

2. Primary IT Contact's Name: The GSX Administrator on your account who you want to be the primary contact between your company and Apple about API-related communications.
   

3. Primary IT Contact's Email: The email address that corresponds to the employee above.
   

4. Primary IT Contact's Phone Number - The phone number that corresponds to the employee above.
   

5. Primary Business Contact Name(s) for API-Related Communications:  Names of employees who you would like to have receive important API Communications from Apple.
   

6. Primary Business Contact Email Address(es) for API-Related Communications: The email addresses that correspond to the employees above.
   

7. Static Public IPs for ALL Locations using CheckIn with GSX APIs: The static public IP addresses for any and all locations that will be using the GSX APIs.
   

8. The "certreq.csr" file you created in the steps above.
   

The following is the proper format for the email you will send to GSX Web Services. This email must be sent from a corporate email address. If the sender is not a GSX Administrator in MyAccess, be sure to copy someone who is. Make sure to also copy your Field Rep.

Message Body:
GSX Sold-to account number: 0000000000
Primary IT contact’s name: GSX Admin Name
Primary IT contact’s email: gsxadmin@yourdomain.com
Primary IT contact’s phone number: 123-456-7890
Primary business contact name(s) for API related communications: gsxadmin@yourdomain.com