Firma de iOS en la nube: un certificado nuevo en cada compilación y la solución
Por Nesim Razon, desarrollador móvil independiente · 2026-11-18
Nuestras compilaciones para iPhone se ejecutan en la nube, porque desarrollamos en Windows. La primera canalización que funcionó firmaba la app automáticamente y fue bien, hasta que dejó de ir bien. Cada ejecución creaba en silencio un certificado más en la cuenta de desarrollador, y un día las compilaciones empezaron a fallar por una clave privada ausente. Esto es lo que pasaba y la configuración que lo sustituyó.
El síntoma: certificados que se acumulan
Con la firma gestionada en la nube durante el paso de archivado, la compilación pide a la API de App Store Connect lo que necesita. En nuestro caso eso significaba un certificado Apple Development nuevo, con la nota Created via API, en cada compilación. Se acumulan rápido. La cuenta tiene un límite de certificados de cada tipo y lo alcanzamos hacia el undécimo.
Después apareció el segundo fallo: el paso de archivado se quejaba de que la clave privada no estaba instalada. Un certificado sin su clave privada en la máquina no sirve de nada, y una máquina de compilación nueva nunca tiene la clave de un certificado que creó otra máquina anterior.
El atajo tentador que falla más tarde
La idea obvia es archivar sin firmar y firmar al exportar. El archivado funciona, la exportación incluso genera un paquete, y App Store Connect rechaza la subida con un error de firma no válida, el número 90035. La razón es que los frameworks incluidos dentro de la app quedan sin firmar cuando el archivo se compiló con la firma de código desactivada. No basta con firmar solo la app exterior: cada framework incluido necesita su propia firma.
Así que aquí no hay atajo. El archivo debe firmarse correctamente, con un certificado cuya clave privada esté presente en la máquina de compilación.
La configuración estable: una clave de distribución que conservas
La solución es dejar de permitir que cada compilación invente su propia identidad. Creas un único certificado de distribución, guardas su clave privada a salvo fuera del servicio en la nube y das a la compilación la misma clave cada vez. La compilación pide entonces a la API el certificado y el perfil de aprovisionamiento, y la API devuelve el certificado que ya tiene para esa clave en lugar de crear uno nuevo.
En nuestra canalización la clave privada se guarda codificada en base64 en un grupo de variables secretas, junto a la clave de API de App Store Connect y sus dos identificadores. Durante la compilación se decodifica a un archivo y se comprueba con openssl, de modo que un secreto dañado falla en el primer minuto y no al final de una compilación larga.
Los pasos, en orden
- Reconstruir el archivo de la clave de API como un PEM limpio: los secretos suelen llegar con los saltos de línea estropeados, así que se quitan la cabecera y el pie, los espacios y las secuencias literales de barra invertida y n, se parte el cuerpo en líneas de 64 caracteres y se verifica con openssl.
- Fijar el número de compilación en el proyecto y en el Info.plist, y volver a imprimirlo desde el paquete terminado antes de subir.
- Decodificar la clave privada de distribución desde el secreto y comprobarla con openssl.
- Inicializar el llavero en la máquina de compilación.
- Obtener los archivos de firma del identificador del paquete con la opción de crear, de tipo iOS App Store. La herramienta reutiliza el certificado que corresponde a tu clave.
- Añadir los certificados al llavero y aplicar después los perfiles de aprovisionamiento al proyecto de Xcode.
- Generar el ipa firmado a partir del proyecto y el esquema, y publicarlo en TestFlight.
Ahorrar minutos
Los minutos de compilación en macOS son limitados en un plan gratuito, y cada ejecución de firma fallida gasta parte de ellos. Ayudan dos hábitos. El primero es iniciar el flujo de firma solo a mano, para que un envío no gaste minutos. El segundo es tener un flujo de simulador aparte que compila sin firmar y nunca habla con Apple. Encuentra rápido los errores de compilación habituales y no cuesta nada en certificados.
Además ejecutamos en Windows, antes de cualquier compilación en la nube, un script que revisa el proyecto en busca de errores que ya pagamos una vez. Una regla de un segundo vale más que una compilación de diez minutos.
Qué llevarse
- La firma automática en la nube sirve para un primer experimento, pero crea un certificado nuevo en cada ejecución.
- Un archivo sin firmar que se firma al exportar deja los frameworks sin firmar y falla en la validación de la subida.
- Crea un único certificado de distribución, guarda su clave privada con copia de seguridad y pásala a cada compilación como secreto.
- Valida los secretos al principio de la compilación e imprime los números de versión desde el paquete final.
Preguntas frecuentes
¿Por qué fallaron las compilaciones por falta de clave privada?
Cada ejecución creó un certificado nuevo en una máquina nueva, y la clave privada de un certificado solo existe en la máquina que lo creó.
¿Puedo archivar sin firmar y firmar después?
No de forma fiable. Los frameworks incluidos quedan sin firmar y App Store Connect rechaza la subida por firma no válida.
¿Dónde debe guardarse la clave privada de distribución?
En una copia de seguridad que controles y en el servicio de CI como variable secreta, nunca en el repositorio.
¿Hace falta un Mac para configurarlo?
No. La solicitud de certificado y la clave pueden crearse en cualquier máquina, y la compilación en la nube hace el resto.
Más del blog
- El número de compilación de iOS que se quedó en 1: tres arreglos fallidos y uno que funcionó
- Puerta de región para Analytics en iOS cuando no se lee el país de la SIM
- Por qué mi enlace de la App Store dio 404 y la página mostraba capturas de 2018
- Guía 2.1 de App Store «Information Needed»: lo que envié
- Capturas de App Store sin teléfono: Robolectric, un cargador de imágenes falso y un navegador sin interfaz
- Un código QR para dos tiendas de apps: una pequeña página de redirección