Salta al contenuto principale

Firma Apple

Generatore di certificati iOS

Crea un certificato di distribuzione o di sviluppo iOS senza un Mac. Genera qui il Certificate Signing Request (CSR) e la chiave privata, carica il CSR su Apple e trasforma il certificato emesso in un file .p12 per la firma.

  • Crea un CSR pronto per Apple senza Keychain Access né un Mac, da Windows, Linux o macOS.
  • Funziona con i certificati Apple Distribution (App Store, TestFlight, ad hoc) e Apple Development.
  • Converti il .cer emesso in .p12 direttamente in questa pagina, nel tuo browser, per Xcode, fastlane, CI o Capgo Cloud Build.

Workflow

  1. 1. Inserisci i dettagli del subject del certificato da allegare alla richiesta di firma.
  2. 2. Scarica il CSR e la relativa chiave privata.
  3. 3. Carica il CSR su Apple Developer durante la creazione del certificato.
  4. 4. Converti il .cer emesso e la chiave privata in un .p12 protetto da password al punto 2 qui sotto.

Passo 1

Genera il CSR e la chiave privata

Usa la stessa identità (persona o organizzazione) che vuoi risulti nella richiesta del certificato Apple.

Output

La tua richiesta di firma generata

Non viene mostrato nulla finché il CSR non è generato. Una volta pronto, scarica entrambi i file e conserva la chiave privata in modo sicuro.

Genera una richiesta di certificato per visualizzare qui il riepilogo del subject e i pulsanti di download.

Passaggio 2

Converti il tuo .cer Apple in .p12

Dopo che Apple ha emesso il certificato, combina il .cer con la chiave privata del passaggio 1 per ottenere un .p12 per Xcode, fastlane, CI o Capgo Cloud Build.

Funziona interamente nel tuo browser. Il tuo certificato, la chiave privata e la password vengono letti localmente e non vengono mai caricati su alcun server.

Il file distribution.cer o development.cer da Apple Developer. Sono accettati sia DER che PEM.

Il file ios-private-key.pem scaricato con il CSR che hai caricato su Apple.

Output

La tua identità di firma .p12

Seleziona il file .cer e la chiave privata, imposta una password e genera il .p12. Usa la crittografia 3DES con MAC SHA-1, il formato accettato da macOS Keychain e Xcode.

Nozioni base

Cos'è un certificato di firma iOS?

Apple richiede che ogni app iOS sia code firmata. Un certificato di firma dimostra che la build proviene da un membro del tuo team Apple Developer, e iOS rifiuta di installare o avviare app di cui non può verificare la firma.

Per ottenerne uno servono tre file. Il CSR (.csr) contiene la tua chiave pubblica e la tua identità e va inviato ad Apple. Il chiave privata (.pem) resta in tuo possesso. Il certificato (.cer) è ciò che Apple restituisce. Gli strumenti di build necessitano poi del certificato e della chiave privata insieme come .p12 .

Su Mac, Keychain Access crea il CSR e nasconde la chiave privata nel keychain di accesso. Questo generatore ti fornisce entrambi i file direttamente, così puoi creare un certificato Apple Distribution o Apple Development da Windows, Linux o da un runner CI, e sai sempre dove si trova la chiave.

Sicurezza e privacy

Come viene gestita la tua chiave privata

  • Il CSR e la chiave privata RSA a 2048 bit vengono creati su richiesta da un endpoint Capgo stateless via HTTPS e restituiti direttamente al tuo browser.
  • Le risposte vengono inviate con Cache-Control: no-storeNiente viene salvato in un database o conservato dopo la risposta.
  • Il CSR è firmato con SHA-256, il formato richiesto da Apple Developer. Solo il CSR viene caricato su Apple; la chiave privata resta a te.
  • Il convertitore da .cer a .p12 gira interamente nel browser. Il tuo certificato, la chiave privata e la password non vengono mai caricati.
  • Non serve alcun account o registrazione, e le richieste sono soggette a rate limit per evitare abusi.

Preferisci generare la chiave localmente? Questo comando OpenSSL produce gli stessi due file.

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"

Passo dopo passo

Come creare un certificato di distribuzione iOS senza un Mac

Dal CSR a una build firmata su TestFlight. Ogni passaggio funziona dal browser e dal terminale su Windows, Linux o macOS.

  1. Passo 1

    Genera il CSR e la chiave privata

    Inserisci nome, email e il codice paese di due lettere code nel form qui sopra e seleziona Generate CSR and private key. Scarica entrambi i file e conserva la chiave privata al sicuro.

  2. Passaggio 2

    Crea il certificato su Apple Developer

    Accedi a developer.apple.com, apri Certificates, Identifiers & Profiles, seleziona il pulsante plus e scegli Apple Distribution o Apple Development.

  3. Passaggio 3

    Carica il CSR e scarica il .cer

    Fai l'upload del file ios-certificate-request.csr, continua e scarica il certificato emesso, solitamente chiamato distribution.cer o development.cer.

  4. Passaggio 4

    Converti il .cer in un file .p12

    Usa il convertitore da .cer a .p12 al passaggio 2 di questa pagina: seleziona il .cer e la private key, imposta una password e scarica il .p12. Funziona nel browser, oppure usa il comando OpenSSL.

  5. Passaggio 5

    Crea un provisioning profile

    Su Apple Developer, crea un provisioning profile App Store, ad hoc o di sviluppo per il tuo App ID e seleziona il nuovo certificato.

  6. Passaggio 6

    Firma e pubblica la tua app

    Importa il file .p12 e il profilo in Xcode, fastlane, nei segreti della tua CI o in Capgo Cloud Build, poi builda e carica la tua app su TestFlight o sull'App Store.

Usa l'output

Firma la tua app iOS con il .p12

Il modo più veloce è il convertitore .cer in .p12 via browser sopra. Preferisci la riga di comando? OpenSSL fa lo stesso lavoro; ti chiederà una password di esportazione che diventerà la password del tuo .p12.

Crea il .p12 con OpenSSL

OpenSSL è preinstallato su macOS e sulla maggior parte delle distribuzioni Linux, ed è disponibile su Windows tramite Git Bash o WSL.

Converti da .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

Capgo Cloud Build

Salva il .p12 e il provisioning profile una volta, poi compila e firma app iOS e Android nel cloud con Capgo.

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 e Xcode

Su un Mac, fai doppio clic sul file .p12 per importarlo in Keychain e Xcode lo rileverà. Su un runner CI, importalo in un keychain temporaneo con fastlane.

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

Segreti CI e verifica delle chiavi

Codifica i file di firma per GitHub Actions o i segreti GitLab e verifica che il certificato corrisponda alla chiave privata.

base64 e 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

Risoluzione problemi

Errori comuni dei certificati iOS e relative soluzioni

La password inserita non è corretta (importazione in Keychain)
OpenSSL 3 crittografa i file .p12 con algoritmi che Keychain di macOS potrebbe rifiutare. Reesporta il file .p12 con OpenSSL 3 e il flag -legacy mostrato sopra.
Nessun certificato corrisponde alla chiave privata
Il file .cer è stato emesso per un CSR diverso. Usa la chiave privata scaricata con quel CSR esatto, oppure revoca il certificato e riparti con un nuovo CSR.
impossibile caricare i certificati
Apple fornisce i file .cer in formato DER. Aggiungi -inform DER quando converti il .cer con openssl x509.
Il profilo di provisioning non include il certificato di firma
I profili sono legati a certificati specifici. Modifica o rigenera il profilo di provisioning dopo aver creato il nuovo certificato, quindi scaricalo di nuovo.
Hai raggiunto il numero massimo di certificati
Apple limita il numero di certificati di distribuzione per team. Revoca quelli non utilizzati su Apple Developer. Le app già su App Store non sono interessate.
Il certificato non è fidato in Keychain
Installa il certificato intermedio Apple Worldwide Developer Relations (WWDR) da Apple PKI, quindi importa di nuovo il .p12.

Dopo la firma

Pubblica correzioni web senza un altro giro in store

Una volta firmato il binario nativo, i Capgo live updates possono distribuire Capacitor modifiche al web layer over the air: canali, rollback e qualsiasi CI/CD già in uso. Prova gratuitamente quando sei pronto a integrare l'OTA nello stesso flusso di rilascio.

FAQ

FAQ sul generatore di certificati iOS

Risposte su CSR, tipi di certificato, conversione .p12, account Apple Developer e l'uso dei certificati in CI o cloud build.

Cosa crea questo generatore di certificati iOS?

Crea una Certificate Signing Request (.csr) e la relativa chiave privata RSA a 2048 bit (.pem). Carica la CSR su Apple Developer per ottenere il tuo certificato Apple Distribution o Apple Development (.cer), poi combina il .cer con la chiave privata in un file .p12 per Xcode, fastlane, CI o Capgo Cloud Build.

Cos'è una Certificate Signing Request (CSR)?

Una CSR è un piccolo file che contiene la tua chiave pubblica e i tuoi dati identificativi (nome, email, paese), firmata con la tua chiave privata. Apple la usa per emettere un certificato di firma associato a quella chiave. La chiave privata non viene mai inviata ad Apple, motivo per cui devi conservare il file .pem che questo tool ti fornisce.

Posso creare un certificato di distribuzione iOS senza un Mac?

Sì. Genera qui la CSR e la chiave privata, carica la CSR nel portale Apple Developer da qualsiasi browser, scarica il .cer e convertilo in .p12 con il converter allo step 2 di questa pagina. Funziona da Windows, Linux o macOS, quindi Keychain Access non serve in nessuno step.

Quale tipo di certificato devo scegliere in Apple Developer?

Scegli Apple Development per eseguire build su dispositivi di test registrati da Xcode. Scegli Apple Distribution per firmare build per App Store, TestFlight e distribuzione ad hoc. La stessa CSR va bene per entrambi i tipi; il tipo si seleziona in Apple Developer, non in questo tool.

La chiave privata viene salvata sul server?

No. Nello step 1, la CSR e la chiave privata vengono generate on demand da un endpoint Capgo stateless via HTTPS e restituite direttamente al tuo browser con Cache-Control: no-store; non vengono mai scritte in un database né conservate dopo la risposta. Lo step 2, il converter da .cer a .p12, gira interamente nel tuo browser e non carica nulla. Se la tua policy richiede la generazione locale della chiave, usa il comando OpenSSL equivalente in questa pagina.

Perché devo convertire il file .cer in .p12?

Il file .cer che Apple ti fornisce contiene solo il certificato pubblico. Per firmare un'app serve anche la chiave privata, quindi gli strumenti di build si aspettano un file .p12 che racchiude certificato e chiave privata, protetto da una password.

Come si converte un .cer in .p12?

Usa il passaggio 2 di questa pagina: seleziona il .cer di Apple (DER o PEM), seleziona la chiave privata .pem usata per creare il CSR, inserisci una password e scegli Build .p12 file. Il browser verifica che il certificato corrisponda alla chiave e genera un .p12 cifrato con 3DES, accettato da macOS Keychain, Xcode e fastlane. Nessun file viene caricato. Puoi anche copiare il .p12 in base64 per i secret CI.

Serve un account Apple Developer?

Sì. Caricare un CSR ed emettere certificati di firma richiede un abbonamento a pagamento all'Apple Developer Program (99 USD all'anno, oppure il programma Enterprise per la distribuzione interna). Il CSR stesso può essere generato senza account.

Quanto dura un certificato di firma iOS?

I certificati Apple Development e Apple Distribution sono validi per un anno. Le app già pubblicate sull'App Store continuano a funzionare anche dopo la scadenza o la revoca del certificato, ma per firmare la build successiva servono un nuovo certificato e un provisioning profile.

Posso riutilizzare lo stesso CSR o la stessa chiave privata?

Puoi farlo, ma una nuova coppia di chiavi per ogni certificato è più sicura e più facile da ruotare. L'errore da non commettere è mescolarle: un .cer funziona solo con la chiave privata esatta che ha generato il suo CSR. Se perdi la chiave, revoca il certificato e genera un nuovo CSR.

Posso usare questo CSR per i certificati delle notifiche push (APNs)?

Sì. Anche Apple richiede un CSR quando crei un certificato SSL per APNs. Per le nuove app, una chiave di autenticazione APNs (.p8) è di solito più semplice perché non scade mai e funziona per tutte le tue app.

Capgo Native Build

Build e firma app iOS e Android nel cloud con Capgo

Carica il .p12 e il provisioning profile che crei con questo tool, avvia build di release dalla CI e pubblica su TestFlight o sull'App Store senza dover gestire una build farm tua.

Esplora Native Build