Saltar al contenido principal

Certificado de firma de Apple

Generador de certificado de iOS

Crear un certificado de distribución o desarrollo de iOS sin un Mac. Generar la solicitud de firma de certificado (CSR) y la clave privada aquí, subir la CSR a Apple, y convertir el certificado emitido en un archivo .p12 para la firma.

  • Cree un CSR listo para Apple sin acceso a Keychain ni Mac, desde Windows, Linux o macOS.
  • Funciona para certificados de distribución de Apple (App Store, TestFlight, ad hoc) y de desarrollo de Apple.
  • Convierta el archivo .cer emitido a .p12 directamente en esta página, en su navegador, para Xcode, fastlane, CI o Capgo Cloud Build.

Flujo de trabajo

  1. 1. Introduzca los detalles del sujeto del certificado que desee adjuntar a la solicitud de firma.
  2. 2. Descargue el CSR y la clave privada correspondiente.
  3. 3. Suba el CSR en Apple Developer al crear su certificado.
  4. 4. Convirta el archivo .cer emitido y la clave privada en un archivo .p12 protegido por contraseña en el paso 2 a continuación.

Paso 1

Genera el CSR y la clave privada

Utilice la misma identidad de persona o organización que desee representar en la solicitud de certificado de Apple.

Salida

Su solicitud de firma generada

Nada se muestra hasta que se genera el CSR. Una vez listo, descargue ambos archivos y guarde la clave privada de manera segura.

Genera una solicitud de certificado para ver la suma del sujeto y los botones de descarga aquí.

Paso 2

Convierte tu Apple .cer a .p12

Después de que Apple emita tu certificado, combina el .cer con la clave privada del paso 1 para obtener una contraseña protegida .p12 para Xcode, fastlane, CI o Capgo Cloud Build.

Se ejecuta completamente en su navegador. Su certificado, clave privada y contraseña se leen localmente y nunca se suben a ningún servidor.

El archivo distribution.cer o development.cer de Apple Developer. Se aceptan tanto DER como PEM.

El archivo ios-private-key.pem descargado con el CSR que subió a Apple.

Salida

Su identidad de firma .p12

Seleccione su archivo .cer y clave privada, establezca una contraseña y construya el .p12. Utiliza la cifrado 3DES con un MAC SHA-1, el formato que aceptan macOS Keychain y Xcode.

Básicos

¿Qué es un certificado de firma iOS?

Apple requiere que cada aplicación iOS esté code firmada. Un certificado de firma demuestra que el build proviene de un miembro de su equipo de desarrolladores de Apple, y iOS rechaza instalar o lanzar aplicaciones cuyo sello no puede confiar.

Obtener uno requiere tres archivos. El CSR (.csr) contiene su clave pública e identidad y se envía a Apple. El clave privada (.pem) te queda con usted. El certificado (.cer) es lo que Apple emite de vuelta. Los herramientas de construcción necesitan luego el certificado y la clave privada juntos como .p12 file.

On a Mac, Keychain Access creates the CSR and hides the private key in your login keychain. This generator gives you both files directly, so you can create an Apple Distribution or Apple Development certificate from Windows, Linux, or a CI runner, and you always know where the key is.

Seguridad y privacidad

¿Cómo se maneja su clave privada

  • El CSR y la clave privada RSA de 2048 bits se crean en demanda por un endpoint estatal Capgo sobre HTTPS y se devuelven directamente a tu navegador.
  • Cómo se maneja tu clave privada Cache-Control: no-storeNada se almacena en una base de datos ni se mantiene después de la respuesta.
  • La CSR está firmada con SHA-256, el formato que espera Apple Developer. Solo se sube la CSR a Apple; la clave privada se queda contigo.
  • El conversor de .cer a .p12 se ejecuta completamente en su navegador. Su certificado, clave privada y contraseña nunca se suben.
  • No se requiere cuenta ni registro, y las solicitudes están limitadas por velocidad para prevenir el abuso.

Preferiría generar la clave localmente? Este comando OpenSSL produce los mismos dos archivos.

Comando OpenSSL equivalente
openssl req -new -newkey rsa:2048 -nodes \
  -keyout ios-private-key.pem \
  -out ios-certificate-request.csr \
  -subj "/emailAddress=jane@company.com/CN=Jane Doe/C=US"

Paso a paso

Cómo crear un certificado de distribución iOS sin un Mac

Desde CSR a una construcción firmada en TestFlight. Cada paso funciona desde un navegador y una terminal en Windows, Linux o macOS.

  1. Paso 1

    Generar el CSR y la clave privada

    Ingrese su nombre, correo electrónico y código de país de dos letras code en el formulario anterior y seleccione Generar CSR y clave privada. Descargue ambos archivos y mantenga la clave privada segura.

  2. Paso 2

    Crear el certificado en Apple Developer

    Inicie sesión en developer.apple.com, abra Certificados, Identificadores y Perfiles, seleccione el botón de más y elija Distribución de Apple o Desarrollo de Apple.

  3. Paso 3

    Ingrese el CSR y descargue el .cer

    Suba el archivo ios-certificate-request.csr, continúe y descargue el certificado emitido, generalmente llamado distribution.cer o development.cer.

  4. Paso 4

    Convirta el .cer a un archivo .p12

    Use el conversor de .cer a .p12 en el paso 2 de esta página: seleccione el .cer y la clave privada, establezca una contraseña y descargue el .p12. Se ejecuta en su navegador o utilice el comando OpenSSL en su lugar.

  5. Paso 5

    Cree un perfil de provisión

    En Apple Developer, cree un perfil de provisión para App Store, ad hoc o desarrollo para su ID de aplicación y seleccione el nuevo certificado.

  6. Paso 6

    Firmar y enviar su aplicación

    Importe el archivo .p12 y perfil en Xcode, fastlane, sus secretos de CI, o Capgo Cloud Build, luego construya y suba su aplicación a TestFlight o la Tienda de Aplicaciones.

Utilice el resultado.

Firme su aplicación iOS con el archivo .p12.

La ruta más rápida es la El conversor en línea de .cer a .p12. Prefera la línea de comandos? OpenSSL realiza la misma tarea; solicita una contraseña de exportación que se convierte en tu contraseña de .p12.

Cree el archivo .p12 con OpenSSL.

OpenSSL está preinstalado en macOS y la mayoría de las distribuciones de Linux, y está disponible en Windows a través de Git Bash o WSL.

Convirta .cer a .p12.
# 1. Convert Apple's DER .cer to PEM
openssl x509 -inform DER -in distribution.cer -out distribution.pem

# 2. Bundle the certificate and private key into a .p12
#    -legacy (OpenSSL 3) keeps the file compatible with macOS Keychain.
#    Drop it on OpenSSL 1.1 or LibreSSL, which do not support the flag.
openssl pkcs12 -export -legacy \
  -inkey ios-private-key.pem \
  -in distribution.pem \
  -name "Apple Distribution" \
  -out distribution.p12

Cloud Build Capgo

Guarda la .p12 y el perfil de provisión una vez y Cloud Build Capgo firmas y carga de builds de iOS, sin necesidad de Mac.

Capgo CLI
bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --certificate ./distribution.p12 \
  --p12-password "your-p12-password" \
  --ios-provisioning-profile "com.example.app=./profile.mobileprovision" \
  --apple-team-id "TEAM123456"

fastlane y Xcode

En un Mac, haz doble clic en el archivo .p12 para importarlo en Keychain y Xcode lo detecta. En un ejecutor de CI, importa el archivo en una keychain temporal con fastlane.

Fastfile
import_certificate(
  certificate_path: "distribution.p12",
  certificate_password: ENV["P12_PASSWORD"],
  keychain_name: "build.keychain",
  keychain_password: ENV["KEYCHAIN_PASSWORD"]
)

Secretos de CI y verificación de claves

Codifica archivos de firma para GitHub Actions o secretos de GitLab, y confirma que el certificado coincide con la clave privada.

base64 y OpenSSL
# Encode the .p12 and profile for CI secrets
base64 -i distribution.p12 | tr -d '\n' > p12.base64
base64 -i profile.mobileprovision | tr -d '\n' > profile.base64

# Check that the certificate and key match (both hashes must be equal)
openssl x509 -noout -modulus -in distribution.pem | openssl md5
openssl rsa -noout -modulus -in ios-private-key.pem | openssl md5

Solución de problemas

Errores y soluciones comunes de certificados de iOS

La contraseña que ingresaste es incorrecta (importación de Keychain)
Abrir SSL 3 cifra los archivos .p12 con algoritmos que macOS Keychain puede rechazar. Re-exporte el .p12 con OpenSSL 3 y la bandera -legacy mostrada arriba.
No certificado coincide con la clave privada
El archivo .cer se emitió para un CSR diferente. Utilice la clave privada descargada con ese CSR exacto, o revóquel el certificado y comience de nuevo con un nuevo CSR.
No se pueden cargar los certificados
Apple entrega archivos .cer en formato DER. Agregue -inform DER al convertir el .cer con openssl x509.
El perfil de provisión no incluye el certificado de firma
Los perfiles están vinculados a certificados específicos. Edite o regenere el perfil de provisión después de crear el nuevo certificado, luego descárguelo de nuevo.
Ha alcanzado el número máximo de certificados
Apple limita el número de certificados de distribución que puede tener un equipo. Revóquelos inútiles en Apple Developer. Las aplicaciones de la Tienda de Mac App Store no están afectadas.
El certificado no se confía en Keychain
Instale el certificado intermedio actual de Apple Worldwide Developer Relations (WWDR) desde Apple PKI, luego importe el .p12 de nuevo.

Después de firmar

Envíe correcciones web sin otro recorrido de tienda

Una vez que el binario nativo está firmado, Capgo actualizaciones en vivo pueden entregar Capacitor cambios en la capa web por aire—canales, deshacer, y cualquier CI/CD que ya utilices. Prueba gratuita cuando estés listo para cablear OTA en el mismo camino de lanzamiento.

FAQ

Preguntas frecuentes del generador de certificados iOS

Respuestas sobre CSRs, tipos de certificados, conversión a .p12, cuentas de desarrollador de Apple y firma de aplicaciones iOS sin Mac.

¿Qué crea este generador de certificados iOS?

Genera una solicitud de firma de certificado (.csr) y la clave privada RSA 2048-bit correspondiente (.pem). Carga el CSR en Apple Developer para obtener tu certificado de distribución de Apple o certificado de desarrollo de Apple (.cer), luego combina el .cer con la clave privada en un archivo .p12 para Xcode, fastlane, CI, o Capgo Cloud Build.

¿Qué es una solicitud de firma de certificado (CSR)?

Una CSR es un pequeño archivo que contiene tu clave pública y detalles de identidad (nombre, correo electrónico, país), firmada con tu clave privada. Apple lo utiliza para emitir un certificado de firma vinculado a esa clave. La clave privada nunca se envía a Apple, por lo que debes mantener el archivo .pem que este herramienta te proporciona.

¿Puedo crear un certificado de distribución de iOS sin un Mac?

¿Sí. Genere el CSR y la clave privada aquí, suba el CSR en el portal del desarrollador de Apple desde cualquier navegador, descargue el .cer y convierta a .p12 con el conversor en el paso 2 de esta página. Todo funciona desde Windows, Linux o macOS, por lo que no se requiere acceso a la caja de llaves en ningún paso.

¿Qué tipo de certificado debería elegir en Apple Developer?

Elige Desarrollo de Apple para ejecutar compilaciones en dispositivos de prueba registrados desde Xcode. Elige Distribución de Apple para firmar compilaciones para la Tienda de App, TestFlight y distribución ad hoc. El mismo CSR funciona para cualquiera de los tipos; el tipo se selecciona en Apple Developer, no en esta herramienta.

¿Se almacena la clave privada en el servidor?

No. In step 1, the CSR and private key are generated on demand by a stateless Capgo endpoint over HTTPS and returned straight to your browser with Cache-Control: no-store; they are never written to a database or kept after the response. Step 2, the .cer to .p12 converter, runs entirely in your browser and uploads nothing. If your policy requires local key generation, use the equivalent OpenSSL command on this page.

¿Por qué necesito convertir el archivo .cer a .p12?

The .cer file Apple gives you only contains the public certificate. Signing an app also requires the private key, so build tools expect a .p12 file that bundles the certificate and private key behind a password.

¿Cómo puedo convertir un archivo .cer a .p12?

Use el paso 2 en esta página: selecciona el .cer de Apple (DER o PEM), selecciona la clave privada .pem utilizada para crear el CSR, ingresa una contraseña, y selecciona Construye archivo .p12. El navegador verifica que el certificado coincida con la clave y construye un archivo .p12 cifrado con 3DES que macOS Keychain, Xcode y fastlane aceptan. No se sube nada. También puedes copiar el .p12 como base64 para secretos de CI.

¿Necesito una cuenta de desarrollador de Apple?

Sí. Subir un CSR y emitir certificados de firma requiere una membresía de pago del Programa de Desarrolladores de Apple (99 USD al año, o el programa de empresa para distribución en casa). El CSR mismo se puede generar sin una cuenta.

¿Cuánto tiempo es válido un certificado de firma de iOS?

Los certificados de Apple Development y Apple Distribution son válidos durante un año. Las aplicaciones que ya están en la Tienda de App Store siguen funcionando después de que el certificado expira o se revoca, pero necesitas un nuevo certificado y perfil de configuración para firmar la próxima compilación.

Puedo reutilizar el mismo CSR o clave privada?

Sí, pero un par de claves frescas por certificado es más seguro y fácil de rotar. Lo que no debes hacer es mezclarlos: un .cer solo funciona con la clave privada exacta que creó su CSR. Si la clave se pierde, revócalo el certificado y genera un nuevo CSR.

Puedo usar este CSR para certificados de notificación de push (APNs)?

Sí. Apple solicita un CSR cuando creas un certificado SSL de APNs también. Para aplicaciones nuevas, una clave de autenticación de APNs (.p8) es usualmente más sencilla porque nunca expira y funciona para todas tus aplicaciones.