Cómo crear una clave de API de App Store Connect
Shipcue lee el estado de revisión y publica versiones a través de la API de App Store Connect de Apple. Para ello necesita una clave de API de cada cuenta que quieras seguir. Así se crea, paso a paso.
¿Clave de equipo o clave individual?
App Store Connect tiene dos tipos de claves de API. Shipcue funciona con ambas.
- Clave de equipo (recomendada). La crea un Admin del equipo. Puede ver todas las apps del equipo, con el rol que elijas para la clave. Incluye un Issuer ID.
- Clave individual. Se crea en tu propio perfil de usuario. Tiene el mismo rol y el mismo acceso a apps que tu usuario, así que solo ve las apps que tú ves. No tiene Issuer ID. Necesitas el permiso «Generate Individual API Keys», que puede dártelo un Admin del equipo.
Si trabajas para clientes, una clave individual suele ser el camino más fácil: no necesitas que el Admin te cree una clave, solo ese permiso.
¿Qué rol debe tener la clave?
Elige el rol más limitado que cubra lo que necesitas:
- App Manager: el que mejor encaja con Shipcue. Puede publicar y retirar versiones, controlar los lanzamientos por fases y configurar los webhooks que necesita el push, pero no puede gestionar usuarios.
- Admin: también sirve, pero además puede añadir y quitar usuarios. Evítalo para una clave que vive en tu móvil.
- Developer: solo lectura. Shipcue muestra el estado actual al abrirlo o al deslizar para actualizar, pero no puede configurar el push ni publicar ni retirar.
Crea una clave nueva solo para Shipcue. No reutilices una clave de la que dependan tu CI u otras herramientas, para poder revocar una sin romper la otra.
Crear una clave de equipo
-
Abre la página de claves de API
Inicia sesión en App Store Connect desde un navegador como Admin. Abre Users and Access, elige la pestaña Integrations y luego App Store Connect API en la columna izquierda. Si la página muestra un botón Request Access, el Account Holder tiene que solicitar el acceso a la API una vez.
-
Genera la clave
Comprueba que Team Keys esté seleccionado y haz clic en Generate API Key (o en el botón +). Ponle un nombre que reconozcas más tarde, por ejemplo «Shipcue». En Access, elige App Manager. Haz clic en Generate.
-
Descarga el archivo .p8
Haz clic en Download API Key junto a la clave nueva. Apple solo permite descargarla una vez y no guarda copia. El archivo se llama AuthKey_ seguido del Key ID, por ejemplo AuthKey_ABCD123456.p8. Guárdalo en un lugar seguro, como tu gestor de contraseñas.
-
Copia el Issuer ID
El Issuer ID aparece encima de la lista de claves. Se parece a 69a6de8f-3c2e-47e3-e053-5b8c7c11a4d1. Shipcue lo necesita para una clave de equipo.
Crear una clave individual
-
Abre tu perfil
En App Store Connect, abre tu perfil de usuario y baja hasta Individual API Key. Si no aparece el botón Generate API Key, pide a un Admin del equipo el permiso «Generate Individual API Keys».
-
Genera y descarga
Haz clic en Generate API Key y luego en Download API Key. Igual que con las claves de equipo, el archivo .p8 solo se puede descargar una vez. Una clave individual no tiene Issuer ID.
Añadir la clave a Shipcue
-
Empieza con Add Account
En Shipcue, toca Add Account. Elige el archivo .p8 desde Archivos, envíalo por AirDrop desde el Mac y elige Shipcue, o pega el texto de la clave.
-
Revisa los datos
Si el archivo conserva su nombre AuthKey_, Shipcue rellena el Key ID por ti. Pega el Issuer ID si es una clave de equipo, o déjalo vacío si es individual. Dale a la cuenta un nombre que reconozcas, como «Client: Acme».
-
Deja que Shipcue lo compruebe con Apple
Shipcue pregunta a App Store Connect qué apps puede ver la clave. Una clave recién creada puede tardar uno o dos minutos en funcionar; Shipcue sigue intentándolo.
-
Elige tus apps
Elige las apps que quieres seguir. Con Shipcue Pro, Shipcue añade un webhook por app en Apple para que los cambios de estado te lleguen como push. Apple permite 10 webhooks por app y Shipcue usa 1.
Conviene saber
- Por defecto la clave se guarda en tu llavero de iCloud, cifrada de extremo a extremo por Apple, para que tu iPhone y tu iPad puedan usarla. Si prefieres, puedes dejarla solo en un dispositivo. En el modo Private nunca llega a nuestro servidor.
- Cada cuenta de App Store Connect que añadas necesita su propia clave.
- Para detener una clave en todas partes, revócala en App Store Connect: Users and Access › Integrations › App Store Connect API, selecciona la clave y pulsa Revoke. Es también el primer paso si pierdes un dispositivo (consulta ¿Has perdido un dispositivo?).
- No envíes nunca tu archivo .p8 ni su contenido a nadie, tampoco a nosotros.
Preguntas
¿Puedo volver a descargar el archivo .p8?
No. Apple ofrece la descarga una sola vez. Si perdiste el archivo, revoca esa clave en App Store Connect y crea una nueva. En Shipcue, usa Replace Key en la cuenta para conservar sus apps y ajustes.
¿Dónde encuentro el Issuer ID?
En App Store Connect, en Users and Access › Integrations › App Store Connect API, encima de la lista de claves de equipo. Las claves individuales no tienen.
¿Puedo usar una clave con el rol Developer?
Sí, pero solo para ver el estado. Las claves Developer no pueden crear webhooks, así que esas apps no tienen push, y tampoco pueden publicar ni retirar. Usa App Manager para tener todo.
¿Shipcue necesita la contraseña de mi cuenta de Apple?
No. Shipcue usa solo la clave de API. No hay inicio de sesión con tu cuenta de Apple ni código de dos factores.
Relacionado
Sigue todas tus cuentas en un solo sitio
Shipcue envía un push cuando App Review cambia de estado, para cada cuenta de App Store Connect que añadas. Gratis durante 14 días.
Ver cómo funciona Shipcue