Saltar al contenido

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.

Roles de App Store Connect según la descripción de Apple
RolDescripción de Apple
AdminContacto secundario del equipo, con muchas de las responsabilidades del Account Holder y acceso a todas las apps
App ManagerGestiona todos los aspectos de una app, como los precios, la información del App Store y el desarrollo y la entrega de la app
DeveloperGestiona el desarrollo y la entrega de una app
MarketingGestiona los materiales de marketing y las imágenes promocionales, y Apple lo contacta si considera destacar la app en el App Store
SalesAnaliza las ventas, las descargas y otras analíticas de una app
FinanceGestiona la información financiera, como la descarga de informes y el envío de formularios fiscales
Customer SupportAnaliza 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.

Fuentes y más información

AppNorth · macOS

Convierte tu investigación en una ficha mejor.

99,99 € en un pago. Licencia de por vida para 2 Macs, con actualizaciones incluidas.

Las funciones de IA usan tu propio agente CLI: Claude Code, Codex, Gemini CLI, OpenCode, Cursor, Grok u Ollama. Sin créditos de IA de AppNorth; se aplican las condiciones y costes de tu proveedor.

Ver AppNorth para Mac

Solo macOS. Sin plan gratis ni prueba. Sin devoluciones voluntarias; se aplican las excepciones legales. Lee la política de reembolsos.