# Opções de configuração do iOS

Esta seção fornece instruções passo a passo para configurar seu aplicativo iOS para habilitar serviços de mensagens usando o Pushwoosh. Escolha entre a configuração baseada em certificado ou em token, dependendo dos requisitos do seu projeto.

<Aside type="tip">
Independentemente do método escolhido, mantenha seus certificados e chaves seguros. O acesso não autorizado pode levar ao uso indevido de seus recursos de notificação push.
</Aside>
## Configuração baseada em certificado para iOS
Aprenda a configurar o Pushwoosh para iOS usando autenticação baseada em certificado para o APNs (Apple Push Notification Service).

<LinkCard title="Saiba mais" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/" />

## Configuração baseada em token para iOS
Configure o Pushwoosh com autenticação baseada em token para o APNs, oferecendo uma alternativa mais segura e eficiente aos certificados.

<LinkCard title="Saiba mais" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/" />  

## Configuração de certificado VoIP para iOS
Habilite o Pushwoosh para entregar notificações push de VoIP ao seu aplicativo iOS para que você possa enviar alertas de chamadas recebidas e outros eventos de VoIP para os dispositivos dos usuários.

<LinkCard title="Saiba mais" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-voip-certificate-configuration/" />

## Configuração de passe do Apple Wallet para iOS
Faça o upload do seu certificado de assinatura do Pass Type ID para que o Pushwoosh possa assinar e atualizar os passes do Apple Wallet (`.pkpass`) para o seu aplicativo.

<LinkCard title="Saiba mais" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/" />

## Escolhendo entre certificados .p12 e chaves .p8 para notificações push do iOS

Ao configurar notificações push do iOS no Pushwoosh, você deve se autenticar no serviço de Notificação Push da Apple (APNs). Existem dois métodos suportados:

1. **Certificado `.p12`**: a abordagem tradicional, baseada em certificado.
2. **Chave `.p8`**: o método moderno, baseado em token, recomendado pela Apple.

Este guia ajudará você a determinar qual método se adapta melhor ao seu caso de uso.
<Aside type="caution" title="Importante">
[Live Activities](/pt/developer/pushwoosh-sdk/ios-sdk/ios-live-activities/) no Pushwoosh exigem [configuração baseada em token](/pt/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/). Se você pretende usar as Live Activities, certifique-se de que sua configuração do iOS use este método, pois a configuração baseada em certificado não é suportada.
</Aside> 


## Entendendo as opções

| Recurso               | Certificado `.p12`                                         | Chave de Autenticação `.p8`                                        |
|----------------------|------------------------------------------------------------|------------------------------------------------------------------|
| **Como funciona**     | Usa um certificado criptográfico para estabelecer confiança.       | Usa um token persistente assinado por uma chave privada.                |
| **Arquivo**             | Arquivo `.p12` contendo o certificado e a chave privada.    | Arquivo `.p8` contendo uma chave privada.                            |
| **Expiração**       | Expira (geralmente anualmente); requer renovação.          | Não expira automaticamente.                                           |
| **Configuração**            | Mais complexo para gerar e gerenciar.                       | Geralmente mais simples de configurar.                                    |
| **Uso**            | Um certificado por Bundle ID para cada ambiente.        | Uma chave suporta múltiplos aplicativos e ambos os ambientes.           |
| **Recomendação**   | Método legado. Use apenas para configurações existentes.               | Recomendado pela Apple e pelo Pushwoosh.                        |


## Prós e contras de cada método

### Certificado `.p12`: a abordagem tradicional

**Prós:**
- Amplamente suportado.
- Permite certificados separados para desenvolvimento e produção.

**Contras:**
- Os certificados expiram e requerem renovação. A não renovação pode interromper a entrega de pushes.
- Mais complexo de gerenciar.


### Chave `.p8`: a abordagem moderna e recomendada

**Prós:**
- Não são necessárias renovações, reduzindo a sobrecarga de manutenção.
- Mais fácil de gerar e integrar.
- Uma chave funciona em vários projetos.
- Recomendado pela Apple e pelo Pushwoosh.

**Contras:**
- Se comprometida, todos os aplicativos associados estarão em risco. Proteja sua chave `.p8` adequadamente.


## Qual método você deve escolher?

<Aside type="caution" title="Nota de segurança importante">
Independentemente do método que você escolher, sempre proteja seus certificados e chaves. O acesso não autorizado pode comprometer sua infraestrutura de notificação push.
</Aside>

Recomendamos usar o **método de chave `.p8`** para todos os novos projetos. É mais simples, mais escalável e alinhado com as melhores práticas da Apple.

Use certificados `.p12` apenas se:

- Você tem uma infraestrutura existente dependente de certificados `.p12`.
- Você requer uma separação rigorosa de ambientes que não pode ser alcançada com uma chave `.p8`.


## Guias de configuração

<CardGrid>
  <LinkCard title="Configuração baseada em certificado" href="ios-platform-configuration" />
  <LinkCard title="Configuração baseada em token" href="ios-token-based-configuration" />
  <LinkCard title="Configuração de certificado VoIP para iOS" href="ios-voip-certificate-configuration" />
  <LinkCard title="Configuração de passe do Apple Wallet para iOS" href="ios-wallet-pass-configuration" />
</CardGrid>