Apple Secrets¶

You already generated two of the six required secrets when you created your GitHub account.

Now it's time to collect the other four. Remember to save the secrets in your Secrets Reference File

You need to save your information digitally, so you can copy and paste. The information is created in one place and used in another. Refer to Configure Secrets for how the Secrets are used. In addition to the 6 Secrets, other important information to keep handy (like usernames and passwords) is listed below. Be sure to keep this file secure.

Created / used at developer.apple.com

• Email address (this is your username)
• password
• Four items used as Secrets
  • TEAMID
  • FASTLANE_ISSUER_ID
  • FASTLANE_KEY_ID
  • FASTLANE_KEY

Created / used at github.com

• Email address
• password
• username
• If your username is my-name then:
  • Your GitHub address (URL) will be: https://github.com/my-name
  • Your (optional but recommended) GitHub organization address will be : https://github.com/my-name-org
  • Your Trio repository address will be: https://github.com/my-name-org/Trio
• One item used as a Secret
  • GitHub Personal Access Token (GH_PAT)

Create yourself

• a password - make one up and save it (MATCH_PASSWORD)

Collect the Four Apple Secrets¶

This section provides detailed instructions for the four Secrets associated with your Apple Developer ID.

New Apple Developer Account¶

If you have an Apple Developer Account, skip ahead to Find TEAMID.

If not, you need to purchase one ($99 annual fee). It may take a few days for the account to be enabled.

• TrioDocs has an Apple Developer Program page that explains in detail how to sign up for an account
• This link takes you straight to Apple Developer account to sign up

Find TEAMID¶

Sign in to your Apple Developer account at this link: Apple Developer portal page.

1. Click Account in the top menu bar
2. If you need to accept a new agreement (at least twice a year), be sure to do so now
3. Click the Membership Details icon
4. Next to the Team ID field, is a 10-character ID number.

Record this for use as TEAMID in your Secrets file. You will also need it when you Create  App Group.

• Stop a moment and double-check

• If you get this wrong, you will have errors at the very end, which require you to delete some items and repeat some steps on this page

  Do not "type" what you think you see

  Copy and paste the Team ID from the webpage.

  • TEAMID must be 10 characters
  • Avoid typing an 8 when it should be a B

Generate API Key¶

This step is used to create and save the final 3 Secrets you need from your Apple Developer account.

Click this link to open in a new tab: App Store Connect/Access/Integrations/API

• Click the Integrations tab

If this is your first time here, you will see:

• "Permission is required to access the App Store Connect API. You can request access on behalf of your organization."

• Click on Request Access and follow directions until access is granted

The numbered steps below correspond to the actions you take in the subsequent windows:

1. Click on the Generate API Key button or the blue + sign to open the Generate API Key dialog box

2. Enter the name of the key as "FastLane API Key"

3. Choose Admin in the access dropdown menu

4. Confirm the name and that "Admin" is selected and then click on the "Generate" button

Copy API Key Secrets¶

The Integrations screen appears again with content similar to the graphic below; the key information is blanked out for security.

Review the graphic and then follow the directions below to save more parameters you will need to configure Secrets.

1. A button labeled Copy is always adjacent to the Issuer ID above the word Active (this is the same for all keys that you generate with this Apple Developer ID)
   • Tap on the Copy button - this copies the Issuer ID into your paste buffer
   • In the file where you are saving information, paste this with the indication that it is for FASTLANE_ISSUER_ID
2. Hover to the right of the Key ID and the Copy Key ID button shows up
   • Tap on the Copy Key ID button - this copies the Key ID into your paste buffer
   • In the file where you are saving information, paste this with the indication that it is for FASTLANE_KEY_ID
3. Click on the Download API Key button - you will be warned you can only download this once.

4. Find your AuthKey download in your downloads folder. The name of the file will be "AuthKey_KeyID.p8" where KeyID matches your FASTLANE_KEY_ID

   The next task is to rename the file so you can open it. Highlight the filename and choose rename, then add ".txt" after ".p8". In other words, modify AuthKey_AAAAAAAAAA.p8 to AuthKey_AAAAAAAAAA.p8.txt and click on Use .txt when questioned.

5. Double-click to open the AuthKey_AAAAAAAAAA.p8.txt file. It will look similar to the screenshot below. You need to highlight ALL OF THE CONTENTS of that file and copy it and then paste it into your Secrets Reference file as the FASTLANE_KEY.

   • Click inside that file
   • Highlight all the text, including the "-----BEGIN PRIVATE KEY-----" and "-----END PRIVATE KEY-----" lines and then
   • Copy all of the text to the clipboard (Cf. screenshot below).
     • On a Mac, use Cmd+A, then Cmd+C to copy all the contents
     • On a PC, use Ctrl+A , then Ctrl+C to copy all the contents
   • In the file where you are saving information, paste this with the indication that it is for FASTLANE_KEY

   

Organize your Key File¶

Do Not Confuse Your Keys¶

Done with Apple Secrets¶

In summary, from this section, you have found or generated the following and saved copies for later use

• TEAMID
• FASTLANE_ISSUER_ID
• FASTLANE_KEY_ID
• FASTLANE_KEY

Navigation: ← Back to Create a GitHub Account | Next: Fork and Prepare →