Como Reassinar Arquivos IPA para Sideloading

Por que você precisa reassinar arquivos IPA

Todo aplicativo que roda em um iPhone precisa ser assinado digitalmente com um certificado válido da Apple. Quando você baixa um arquivo IPA da internet ou o exporta do Xcode, ele carrega a assinatura do desenvolvedor original. Antes de conseguir instalá-lo no seu próprio dispositivo, essa assinatura precisa ser substituída por uma vinculada a um certificado em que o seu iPhone confie. Esse processo é chamado de reassinatura (resigning), e é uma habilidade fundamental para quem leva a sério o sideloading no iOS.

Reassinar não é sobre contornar a segurança; é sobre transferir confiança. O modelo de segurança da Apple exige que todo código executado no iOS seja atestado por uma identidade conhecida. Quando você reassina um IPA, você está dizendo “eu garanto por este aplicativo” usando sua própria identidade de desenvolvedor ou um certificado gerenciado por uma ferramenta como o Scarlet iOS.

Se você é novo no conceito de arquivos IPA, comece pelo nosso guia sobre entendendo arquivos IPA: o que são e como usá-los. Depois de entender a estrutura de um IPA, a reassinatura fará muito mais sentido. Última verificação: 27 de outubro de 2026, com base nos READMEs do iOS App Signer e do zsign no GitHub e na página de associação de desenvolvedor da Apple.

Os riscos primeiro

• Reassinar muda quem garante pelo aplicativo, não o que o aplicativo faz. Um IPA modificado continua modificado depois que você o assina, então verifique o IPA antes.
• Nunca entregue um certificado .p12 e sua senha a um site ou a um estranho. Quem tiver acesso a eles pode assinar aplicativos se passando por você.
• Reassinar com um bundle ID diferente cria um aplicativo separado, sem nenhum dado. Para atualizar um aplicativo existente, mantenha o mesmo bundle ID e a mesma Apple ID.
• Com uma Apple ID gratuita, os aplicativos que você assina param de abrir após 7 dias. A página de associação da Apple informa que os perfis de provisionamento gratuitos “expirarão 7 dias após a emissão”.

Visão Geral das ferramentas de reassinatura

Ferramenta	Funciona em	Assina com	Indicado para
iOS App Signer	macOS (precisa do Xcode)	Seu certificado e provisioning profile	Uma reassinatura simples baseada em janela
AltServer / AltStore	Mac ou Windows	Seu Apple ID	Reassinar e instalar em uma única etapa
Sideloadly	Mac ou Windows	Seu Apple ID	Reassinar e instalar, além de alterar bundle ID e nome
codesign	macOS (ferramentas de linha de comando do Xcode)	Seu certificado e provisioning profile	Controle total, automação por script
zsign	macOS, Linux, Windows, Android, FreeBSD	Um certificado .p12 e provisioning profile	Reassinar sem precisar de um Mac

O que você precisa antes de reassinar

Para reassinar um arquivo IPA, você vai precisar do seguinte:

• O arquivo IPA que você quer reassinar
• Um Mac (para ferramentas tradicionais) ou uma máquina Windows/Linux (para ferramentas multiplataforma)
• Um Apple ID (gratuito) ou uma conta Apple Developer ($99/ano para recursos mais amplos)
• Uma ferramenta de reassinatura, como o iOS App Signer, o AltServer, ou uma abordagem via linha de comando usando codesign
• Um provisioning profile que inclua o UDID do seu dispositivo (com um Apple ID gratuito, o Xcode cria isso para você; veja abaixo)

Como alternativa, o Scarlet iOS cuida de grande parte desse processo automaticamente quando você importa um IPA diretamente no app. Mas entender o processo manual te dá mais controle e ajuda a resolver problemas quando as ferramentas automatizadas falham.

Método 1: reassinando com iOS app Signer (Mac)

O iOS App Signer é uma ferramenta gratuita e de código aberto para macOS que oferece uma interface gráfica para reassinar arquivos IPA. Veja como usá-lo:

1. Baixe o iOS App Signer no seu repositório oficial no GitHub. O README diz que ele “requer o Xcode instalado” e aceita arquivos ipa, deb, app e xcarchive.
2. Abra o Xcode e faça login com seu Apple ID em Settings > Accounts (Preferences em versões mais antigas). Isso cria um certificado de assinatura local no seu Mac.
3. Obtenha um provisioning profile que inclua seu dispositivo. Com um Apple ID gratuito, o caminho indicado pelo README é criá-los “pelo Xcode, criando um novo projeto”: conecte o iPhone, crie um projeto de app vazio e deixe o Xcode gerenciar a assinatura. A página de membership da Apple confirma que, para contas gratuitas, “os perfis são gerenciados diretamente no Xcode”. Com uma conta paga, você pode, em vez disso, registrar o UDID do dispositivo no developer portal e baixar um perfil por lá. Nosso guia mostra como encontrar o UDID.
4. Abra o iOS App Signer e selecione seu arquivo IPA como entrada.
5. Escolha seu certificado de assinatura no menu suspenso; ele aparecerá como “Apple Development: Seu Nome” (ou “iPhone Developer: Seu Nome” para certificados mais antigos).
6. Selecione o provisioning profile que você baixou.
7. Opcionalmente, altere o bundle ID (o README o chama de application ID) ou o nome de exibição se quiser instalar o app ao lado do original. Veja como rodar várias versões do mesmo app.
8. Clique em Start e aguarde a geração do IPA reassinado.
9. Use a janela Devices and Simulators do Xcode ou uma ferramenta como o Apple Configurator para instalar o IPA reassinado.

Método 2: reassinando com o AltServer

O AltServer é outra abordagem popular que funciona tanto no Mac quanto no Windows. Ele se integra ao AltStore, mas também pode ser usado para reassinar arquivos IPA quaisquer:

1. Instale o AltServer no seu computador e o AltStore no seu iPhone.
2. Abra o AltServer e vá até a opção Sideload .IPA.
3. Selecione seu arquivo IPA e forneça as credenciais do seu Apple ID quando solicitado.
4. O AltServer cuida automaticamente da criação do certificado, geração do provisioning profile, reassinatura e instalação.

A limitação do método com Apple ID gratuito é a validade de 7 dias do certificado. Apps assinados dessa forma param de funcionar depois de uma semana, a menos que você os reassine novamente. Uma conta paga de Apple Developer ($99/ano) estende esse prazo para 12 meses. Para manter apps assinados com conta gratuita funcionando, veja como atualizar os apps antes que os 7 dias acabem, e para o limite de 3 apps, veja o limite de apps do Apple ID gratuito.

Método 3: reassinatura via linha de comando com codesign

Para usuários avançados e fluxos de automação, a abordagem via linha de comando usando a ferramenta codesign da Apple oferece a maior flexibilidade. Esse método exige o macOS e as ferramentas de linha de comando do Xcode instaladas.

Passo 1: descompacte o IPA

Um arquivo IPA é apenas um arquivo ZIP. Renomeie-o com a extensão .zip e extraia, ou use o terminal:

unzip MyApp.ipa -d MyApp_extracted

Passo 2: remova a assinatura existente

rm -rf MyApp_extracted/Payload/MyApp.app/_CodeSignature

Passo 3: copie seu provisioning profile

cp MyProvisioningProfile.mobileprovision MyApp_extracted/Payload/MyApp.app/embedded.mobileprovision

Etapa 4: assine novamente com codesign

Assine primeiro os frameworks e as extensões de app dentro do app, depois o app em si, para que nada dentro dele fique com a assinatura antiga:

codesign -f -s "Apple Development: Your Name (TEAMID)" MyApp_extracted/Payload/MyApp.app/Frameworks/*

codesign -f -s "Apple Development: Your Name (TEAMID)" --entitlements entitlements.plist MyApp_extracted/Payload/MyApp.app

Os certificados mais novos são chamados de “Apple Development”; os mais antigos ainda podem aparecer como “iPhone Developer”. Execute security find-identity -v -p codesigning para listar os nomes exatos no seu Mac. O arquivo de entitlements precisa corresponder ao seu provisioning profile, então pegue os valores dele a partir do profile, e não do app original.

Etapa 5: reempacote como IPA

cd MyApp_extracted && zip -r ../MyApp_resigned.ipa Payload

Reassinando sem um Mac: zsign

O zsign (licença MIT, ativo no GitHub em outubro de 2026) se descreve como “uma alternativa rápida, open-source e multiplataforma ao codesign para iOS 12+” que reassina pacotes .ipa e bundles .app “com certificados e provisioning profiles personalizados, sem Xcode, sem macOS”. O README do projeto lista builds para macOS, Linux, Windows, Android e FreeBSD, provisioning profiles por extensão para apps com extensões, alteração de bundle ID e nome de exibição, além de uma verificação de certificado e OCSP que pode mostrar se um certificado ainda é válido. Você precisa de um certificado .p12, sua senha e um provisioning profile correspondente, o que na prática significa ter uma conta de desenvolvedor paga. É uma ferramenta de linha de comando, então é indicada para usuários que têm familiaridade com o terminal.

Reassinando diretamente no Scarlet iOS

Se você usa o Scarlet iOS, a maior parte da complexidade da reassinatura é resolvida para você nos bastidores. Ao importar um IPA no Scarlet, o app o reassina automaticamente com seu próprio certificado de assinatura antes da instalação. Essa é uma das principais vantagens de usar o Scarlet em comparação com métodos manuais.

Para usuários avançados, nosso guia sobre o Modo Desenvolvedor no iPhone explica quando a configuração de Developer Mode da Apple é necessária: para apps que você reassina com sua própria Apple ID, sim; o próprio Scarlet é assinado como enterprise e não precisa dela. O Scarlet é confirmado do iOS 14 ao iOS 26; o suporte ao iOS 27 é relatado por terceiros, mas não confirmado oficialmente.

Erros comuns ao reassinar e como corrigi-los

Erro: “A valid provisioning profile for this executable was not found”

Isso significa que o provisioning profile usado não inclui o UDID do seu dispositivo, ou o perfil expirou. Gere um novo perfil no portal de desenvolvedores da Apple e inclua seu dispositivo.

Erro: “The executable was signed with invalid entitlements”

Alguns apps solicitam entitlements (permissões especiais) que exigem uma conta de desenvolvedor paga ou capacidades específicas habilitadas no provisioning profile. Revise o arquivo entitlements.plist do app e remova os que não são suportados pelo nível da sua conta.

Erro: “Code object is not signed at all”

Isso geralmente ocorre quando os frameworks incluídos no app não foram reassinados junto com o executável principal. Você precisa reassinar cada framework individualmente antes de reassinar o pacote principal do app.

Erro: “Unable to Install” ou “integrity could not be verified” no iPhone

A assinatura, o perfil ou a lista de dispositivos não correspondem. Verifique se o perfil inclui seu dispositivo, se todos os frameworks foram assinados e se o certificado não foi revogado. Veja como corrigir o erro de integridade.

O app instala mas não abre

No iOS 16 e versões posteriores, apps assinados com seu próprio certificado de desenvolvimento precisam que o Modo Desenvolvedor esteja ativado, e pode ser necessário confiar no desenvolvedor em Ajustes > Geral > VPN e Gerenciamento de Dispositivo. Veja a correção do erro Untrusted Developer.

Boas práticas para reassinar arquivos IPA

• Sempre mantenha um backup do IPA original, sem modificações, antes de reassinar.
• Documente qual certificado e provisioning profile você usou para cada app; isso facilita muito a renovação.
• Se você precisa que vários apps se comuniquem entre si (app groups), certifique-se de que todos sejam assinados com o mesmo team ID.
• Para apps que você usa regularmente, considere uma conta paga de Apple Developer para evitar a dor de cabeça de reassinar toda semana.

Conclusão

Reassinar arquivos IPA é uma habilidade essencial para quem quer ter controle total sobre a instalação de apps no iPhone. Seja escolhendo uma ferramenta com interface gráfica, usando a linha de comando ou deixando o Scarlet iOS cuidar disso automaticamente, entender o processo te dá autonomia para resolver problemas e desbloquear apps que a App Store não oferece.

Se você prefere não lidar com certificados por conta própria, uma ferramenta que assina diretamente no dispositivo é o caminho mais simples; veja como instalar o Scarlet iOS, ou nosso guia sobre como criar seu próprio arquivo IPA para a etapa anterior à reassinatura.

Perguntas frequentes

Posso reassinar um IPA no Windows?

Sim. O AltServer e o Sideloadly assinam com seu Apple ID no Windows, e o zsign roda no Windows com um certificado .p12.

Reassinar mantém os dados do meu app?

Somente se você instalar o app reassinado por cima do já existente, com o mesmo bundle ID (e, no caso de ferramentas que usam Apple ID, com o mesmo Apple ID). Excluir o app antes apaga seus dados.

Posso reassinar com um Apple ID gratuito?

Sim, mas o perfil dura 7 dias e você pode ter no máximo 3 apps via sideload instalados no dispositivo ao mesmo tempo, de acordo com a página de associação da Apple.