← Nesim Apps

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

#Notas de desarrollo#iOS

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

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

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