App Store Connect API 키를 만드는 방법

Shipcue는 Apple의 App Store Connect API로 심사 상태를 읽고 버전을 출시합니다. 그러려면 추적할 계정마다 API 키가 필요합니다. 만드는 방법을 단계별로 안내합니다.

작성: AppLabs.lv · 2026년 10월 28일 업데이트

Team 키와 Individual 키 중 무엇을 쓸까요?

App Store Connect에는 두 종류의 API 키가 있으며, Shipcue는 둘 다 사용할 수 있습니다.

• Team 키(권장). 팀의 Admin이 만듭니다. 키에 지정한 역할의 권한으로 팀의 모든 앱을 볼 수 있습니다. Issuer ID가 함께 제공됩니다.
• Individual 키. 내 사용자 프로필에서 만듭니다. 내 사용자와 같은 역할과 앱 접근 권한을 가지므로, 내가 볼 수 있는 앱만 볼 수 있습니다. Issuer ID는 없습니다. "Generate Individual API Keys" 권한이 필요하며, 팀 Admin이 부여할 수 있습니다.

고객사 일을 한다면 Individual 키가 더 쉬운 경우가 많습니다. Admin에게 키를 만들어 달라고 할 필요 없이 이 권한만 있으면 됩니다.

키에는 어떤 역할을 줘야 하나요?

필요한 일을 할 수 있는 가장 작은 역할을 고르세요.

• App Manager: Shipcue에 가장 알맞습니다. 버전 출시와 철회, 단계별 출시 제어, 푸시에 필요한 웹훅 설정이 가능하지만 사용자는 관리할 수 없습니다.
• Admin: 이것도 작동하지만 사용자를 추가하고 삭제할 수도 있습니다. 휴대폰에 두는 키로는 피하세요.
• Developer: 보기 전용입니다. Shipcue를 열거나 새로고침할 때 현재 상태를 보여 주지만, 푸시를 설정할 수 없고 출시와 철회도 할 수 없습니다.

Shipcue 전용으로 새 키를 만드세요. CI나 다른 도구가 쓰는 키를 재사용하지 마세요. 그래야 한쪽을 폐기해도 다른 쪽이 멈추지 않습니다.

Team 키 만들기

1. API 키 페이지 열기

   Admin 계정으로 브라우저에서 App Store Connect에 로그인합니다. Users and Access를 열고 Integrations 탭을 선택한 다음, 왼쪽 열에서 App Store Connect API를 선택합니다. 페이지에 Request Access 버튼이 보이면 Account Holder가 API 접근을 한 번 요청해야 합니다.

2. 키 생성

   Team Keys가 선택되어 있는지 확인하고 Generate API Key(또는 + 버튼)를 클릭합니다. 나중에 알아볼 수 있는 이름, 예를 들어 "Shipcue"로 지정합니다. Access에서 App Manager를 선택하고 Generate를 클릭합니다.

3. .p8 파일 다운로드

   새 키 옆의 Download API Key를 클릭합니다. Apple은 다운로드를 한 번만 허용하고 사본을 보관하지 않습니다. 파일 이름은 AuthKey_ 뒤에 Key ID가 붙은 형태이며, 예를 들어 AuthKey_ABCD123456.p8입니다. 비밀번호 관리자처럼 안전한 곳에 보관하세요.

4. Issuer ID 복사

   Issuer ID는 키 목록 위에 표시됩니다. 69a6de8f-3c2e-47e3-e053-5b8c7c11a4d1 같은 형태입니다. Team 키를 쓸 때 Shipcue에 필요합니다.

Individual 키 만들기

1. 프로필 열기

   App Store Connect에서 사용자 프로필을 열고 Individual API Key까지 스크롤합니다. Generate API Key 버튼이 없으면 팀 Admin에게 "Generate Individual API Keys" 권한을 요청하세요.

2. 생성하고 다운로드

   Generate API Key를 클릭한 다음 Download API Key를 클릭합니다. Team 키와 마찬가지로 .p8 파일은 한 번만 다운로드할 수 있습니다. Individual 키에는 Issuer ID가 없습니다.

Shipcue에 키 추가

1. Add Account 시작

   Shipcue에서 Add Account를 탭합니다. 파일 앱에서 .p8 파일을 고르거나, Mac에서 AirDrop으로 보내 Shipcue를 선택하거나, 키 텍스트를 붙여 넣으세요.

2. 내용 확인

   파일 이름이 여전히 AuthKey_로 시작하면 Shipcue가 Key ID를 자동으로 채웁니다. Team 키라면 Issuer ID를 붙여 넣고, Individual 키라면 비워 두세요. 계정에는 "Client: Acme"처럼 알아보기 쉬운 이름을 붙이세요.

3. Apple에서 Shipcue가 확인하게 하기

   Shipcue는 App Store Connect에 그 키로 볼 수 있는 앱을 묻습니다. 새로 만든 키는 작동하기까지 1~2분 걸릴 수 있으며, 그동안 Shipcue가 계속 다시 시도합니다.

4. 앱 선택

   추적할 앱을 고르세요. Shipcue Pro를 쓰면 Shipcue가 앱마다 Apple에 웹훅을 하나씩 추가해서 상태 변경이 푸시로 도착합니다. Apple은 앱당 웹훅을 10개까지 허용하고, Shipcue는 그중 1개를 사용합니다.

알아 두면 좋은 점

• 기본적으로 키는 Apple이 종단 간 암호화하는 iCloud Keychain에 저장되어 iPhone과 iPad가 모두 사용할 수 있습니다. 대신 한 기기에만 보관할 수도 있습니다. Private 모드에서는 키가 저희 서버에 전달되지 않습니다.
• 추가하는 App Store Connect 계정마다 별도의 키가 필요합니다.
• 모든 곳에서 키를 막으려면 App Store Connect에서 폐기하세요. Users and Access › Integrations › App Store Connect API에서 키를 선택하고 Revoke를 누릅니다. 기기를 분실했을 때도 가장 먼저 할 일입니다(기기를 분실했나요? 참고).
• .p8 파일이나 그 내용은 저희를 포함해 누구에게도 보내지 마세요.

자주 묻는 질문

관련 글

• 승인된 앱을 iPhone에서 출시하기버전이 Pending Developer Release 상태일 때 할 일.
• App Review 상태 설명모든 App Store Connect 상태와 그다음에 일어나는 일.