Cómo crear una clave de la API de App Store Connect
Una clave de la API de App Store Connect permite que herramientas y scripts automaticen tareas de App Store Connect a través de la API de Apple. Esta guía explica quién puede crear una clave de equipo, qué rol darle, la clave privada que solo puedes descargar una vez y dónde encontrar el Issuer ID y el Key ID, según la documentación de Apple consultada el 18 de noviembre de 2026.
AppNorth ·
Qué es una clave de la API de App Store Connect
La API de App Store Connect es una API REST con la que se pueden automatizar ciertas tareas de App Store Connect. Cada petición necesita un JSON Web Token (JWT), y esos tokens se firman con una clave API de App Store Connect. Una clave tiene dos partes: una parte pública que guarda Apple y una clave privada que descargas tú.
Hay dos tipos. Una clave de equipo da acceso a todas las apps de tu cuenta, con los permisos del rol que elijas. Una clave individual tiene el acceso y los roles del usuario que la crea, y no puede usar los endpoints de Provisioning, los de ventas y finanzas (Sales and Finance) ni notaryTool. Las claves de la API de App Store Connect solo sirven para esta API, no para otros servicios de Apple.
Quién puede crear una clave de equipo
Antes de generar claves, el Account Holder tiene que solicitar acceso a la API. En App Store Connect, abre Usuarios y acceso y después Integraciones: la página se abre con la API de App Store Connect seleccionada. Pulsa el botón para solicitar acceso, marca la casilla para aceptar las condiciones y envía la solicitud. Apple revisa y aprueba estas solicitudes caso por caso.
Las claves de equipo las puede generar el Account Holder o un Admin. Las individuales funcionan de otra forma: por defecto, cualquier usuario con el rol Account Holder, Admin, App Manager, Customer Support, Developer o Marketing puede generar una, salvo que un Admin o el Account Holder le haya retirado ese permiso. Cada usuario solo puede tener una clave individual activa a la vez.
Crea una clave API de equipo paso a paso
Las claves de equipo encajan con herramientas que trabajan con varias de tus apps, porque cubren todas las apps de la cuenta. Estos son los pasos de Apple, para el Account Holder o un Admin.
No puedes editar el nombre ni el nivel de acceso de una clave después de generarla. Para cambiar cualquiera de los dos, revoca la clave y genera una nueva. Las claves de equipo se aplican a todas las apps, así que no puedes limitar una clave de equipo a apps concretas.
- En Usuarios y acceso, pulsa Integraciones. La página se abre con la API de App Store Connect seleccionada.
- Abre la pestaña de claves de equipo y pulsa el botón para generar una clave API. Si ya tienes una clave activa, pulsa el botón de añadir (+).
- Escribe un nombre para la clave. Es solo para identificarla y no forma parte de la clave.
- En el apartado de acceso, elige el rol que determina para qué se puede usar la clave.
- Genera la clave. En la página aparecen el nombre de la nueva clave, su Key ID y un enlace de descarga.
Elige el rol de la clave
Los roles de las claves API son los mismos que se aplican a los usuarios de tu equipo, y el rol decide a qué partes de la API puede acceder la clave y qué tareas puede hacer. Las claves con el rol Admin tienen permisos amplios, como crear y eliminar usuarios. Sea cual sea su rol, una clave de equipo puede acceder a todas las apps.
Así describe Apple cada rol en su página de permisos. Elige el rol más limitado que cubra lo que tiene que hacer tu herramienta y reserva Admin para las que de verdad lo necesiten.
| Rol | Descripción de Apple |
|---|---|
| Admin | Contacto secundario del equipo, con muchas de las responsabilidades del Account Holder y acceso a todas las apps |
| App Manager | Gestiona todos los aspectos de una app, como los precios, la información del App Store y el desarrollo y la entrega de la app |
| Developer | Gestiona el desarrollo y la entrega de una app |
| Marketing | Gestiona los materiales de marketing y las imágenes promocionales, y Apple lo contacta si considera destacar la app en el App Store |
| Sales | Analiza las ventas, las descargas y otras analíticas de una app |
| Finance | Gestiona la información financiera, como la descarga de informes y el envío de formularios fiscales |
| Customer Support | Analiza y responde las reseñas de los clientes en el App Store |
Descarga la clave privada .p8 una sola vez y guárdala bien
Después de generar una clave de equipo, aparece un enlace para descargarla junto a ella en la lista de claves de equipo. La clave privada solo se puede descargar una vez: el enlace solo aparece mientras no la hayas descargado, y Apple no guarda ninguna copia. El archivo que obtienes es un .p8 con el Key ID en el nombre, con la forma AuthKey_KEYID.p8.
Trátala como una contraseña. Apple recomienda no compartir las claves, no guardarlas en un repositorio de código y no incluirlas en código del lado del cliente. Si pierdes una clave o crees que está comprometida, revócala de inmediato y genera una nueva. Una clave revocada no se puede restablecer; las revocadas en los últimos 30 días aparecen en la sección de claves revocadas.
Encuentra el Issuer ID y el Key ID
Una herramienta que firma tokens con una clave de equipo necesita dos datos además del archivo .p8. El Issuer ID aparece cerca de la parte superior de la página de la API de App Store Connect, en Integraciones, con un botón para copiarlo al lado. El Key ID aparece en la fila de cada clave, en la lista de claves activas: pasa el cursor junto a él y pulsa el enlace para copiarlo.
En el token, el Key ID va en la cabecera kid y el Issuer ID en el campo iss; los tokens se firman con ES256 y usan appstoreconnect-v1 como audiencia. Las claves individuales no usan el Issuer ID: sus tokens llevan el campo sub con el valor user. Los tokens que caducan más de 20 minutos en el futuro no son válidos, salvo para algunos recursos que Apple enumera.
Qué necesita AppNorth de tu clave
AppNorth para Mac se conecta a App Store Connect con una clave de equipo. Su ayuda pide el rol App Manager, que puede editar los datos del App Store, los precios de la app y los de las suscripciones sin acceso completo de administrador. Admin también funciona, pero da más acceso del que AppNorth necesita. Usa una clave de equipo, no una individual: AppNorth necesita el Issuer ID, que solo tienen las claves de equipo.
En AppNorth, abre Ajustes → Integraciones, pulsa Conectar en App Store Connect, pega el Issuer ID y el Key ID, pulsa Elegir p8 y añadir cuenta… para seleccionar el archivo .p8 y después Verificar conexión. Con la clave, AppNorth publica en App Store Connect los cambios de ficha que revisas y los precios locales de suscripciones y compras dentro de la app. Los cambios aprobados van a una versión en borrador, y AppNorth nunca envía tu app a revisión. Las claves de las tiendas se quedan en tu Mac, cifradas con una clave guardada en el Llavero de macOS, y solo se envían a Apple o a Google.
Antes de empezar
¿Quién puede crear una clave de la API de App Store Connect?
Las claves de equipo, el Account Holder o un Admin, una vez que el Account Holder ha solicitado acceso a la API. Las individuales, por defecto, cualquier usuario con el rol Account Holder, Admin, App Manager, Customer Support, Developer o Marketing, salvo que le hayan retirado ese permiso.
¿Puedo volver a descargar el archivo .p8?
No. Apple solo deja descargar la clave privada una vez y no guarda ninguna copia. Si la pierdes, revoca la clave en App Store Connect y genera una nueva.
¿Dónde encuentro el Issuer ID?
Cerca de la parte superior de la página de la API de App Store Connect, en Usuarios y acceso → Integraciones, con un botón para copiarlo al lado. Lo usan las claves de equipo; las individuales, no.
¿Uso una clave de equipo o una individual?
Una clave de equipo cubre todas las apps de la cuenta y tiene el rol que elijas. Una individual tiene el acceso de quien la crea y no puede usar los endpoints de Provisioning, los de ventas y finanzas ni notaryTool. Las herramientas que piden un Issuer ID, como AppNorth, necesitan una clave de equipo.
¿Qué rol necesita AppNorth?
App Manager. Puede editar los datos del App Store, los precios de la app y los de las suscripciones sin acceso completo de administrador. Admin también funciona, pero da más acceso del que AppNorth necesita.
¿Puedo cambiar el rol de una clave más adelante?
No. No puedes editar el nombre ni el nivel de acceso de una clave después de generarla. Revócala y genera una nueva con el rol que necesites.