> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar OAuth da Apple

> Configure o Sign in with Apple para a autenticação do seu app

Este guia mostra como criar o Apple App ID, o Services ID e a Private Key necessários para o Sign in with Apple. Você vai coletar um **Team ID**, **Services ID**, **Key ID** e **Private Key** para inserir no **painel Auth**.

<Note>
  Esta página cobre apenas a configuração do lado do provedor no portal Apple Developer. Para o fluxo completo do Clerk Auth — incluindo habilitar o Apple e inserir credenciais no **painel Auth** — veja [Configurando credenciais OAuth para um provedor SSO](/pt/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) na documentação do Clerk Auth.
</Note>

## Pré-requisitos

* Uma [conta Apple Developer](https://developer.apple.com/account) (requer inscrição no Apple Developer Program)
* Um [app do Replit publicado](/pt/learn/projects-and-artifacts/replit-deployments) — credenciais OAuth personalizadas só estão disponíveis no ambiente de **Produção**
* O painel de edição do provedor **Apple** aberto em: **painel Auth** → aba **Configure** → seção **SSO providers** → selecione o ambiente **Production** → selecione **Edit** ao lado de **Apple**

## Etapa 1: Crie um Apple App ID

1. Acesse o [portal Apple Developer](https://developer.apple.com/account)
2. Vá em **Certificates, IDs & Profiles** e depois **Identifiers**
3. Selecione **App IDs** no menu suspenso
4. Selecione o ícone **+** para registrar um novo identificador
5. Selecione **App IDs**, depois **Continue**
6. Escolha **App**, depois **Continue**
7. Preencha:
   * **Description**: Nome para o seu App ID
   * **Bundle ID**: Seu identificador único
8. Habilite **Sign In with Apple** em Capabilities
9. Selecione **Continue**, depois **Register**
10. **Salve o seu App ID Prefix** (mostrado no topo) - este é o seu **Team ID**

## Etapa 2: Crie um Apple Services ID

1. Na página Identifiers, selecione **Services IDs** no menu suspenso
2. Selecione **+** para registrar um novo identificador
3. Selecione **Services IDs**, depois **Continue**
4. Preencha:
   * **Description**: Nome para o seu Services ID
   * **Identifier**: Seu identificador único (salve isso - é o seu **Services ID**)
5. Selecione **Continue**, depois **Register**

### Configure o Services ID

1. Selecione o Services ID que você acabou de criar
2. Habilite **Sign In with Apple**
3. Selecione **Configure**
4. Defina:

   * **Primary App ID**: Selecione seu App ID da Etapa 1
   * **Domains and Subdomains**: Copie o valor mostrado em **Provider setup** no **painel Auth** (sem o prefixo de protocolo `https://`)
   * **Return URLs**: Copie o valor mostrado em **Provider setup** no **painel Auth**

   Veja [Configurando credenciais OAuth para um provedor SSO](/pt/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) para saber como encontrar esses valores.
5. Selecione **Next**, depois **Done**, depois **Continue**, depois **Save**

## Etapa 3: Crie uma Apple Private Key

1. Na barra lateral do portal Apple Developer, selecione **Keys**
2. Selecione **+** para registrar uma nova chave
3. Digite um **Key Name**
4. Habilite **Sign In with Apple**
5. Selecione **Configure**, depois selecione seu App ID da Etapa 1
6. Selecione **Save**, depois **Continue**, depois **Register**
7. **Salve o Key ID**
8. **Baixe** o arquivo da chave privada (.p8)

<Warning>
  Você só pode baixar a chave privada uma vez. Armazene-a com segurança — você não conseguirá baixá-la novamente.
</Warning>

## Etapa 4: Configure o Apple Private Email Relay

O recurso Hide My Email da Apple permite que os usuários façam login sem revelar o e-mail real. Para enviar e-mails a esses usuários, registre sua fonte de e-mail.

1. Na barra lateral do portal Apple Developer, selecione **Services**
2. Em **Sign in with Apple for Email Communication**, selecione **Configure**
3. Selecione **+** para adicionar uma Email Source
4. Digite o valor de Email Source mostrado em **Provider setup** no **painel Auth**
5. Selecione **Next**, depois **Register**, depois **Done**
6. Aguarde a verificação de DNS (ícone verde de confirmação)

<Info>
  Em algumas regiões (China, Índia), os Apple IDs podem estar vinculados a números de telefone em vez de e-mail. Se o seu app exigir e-mail para todos os usuários, o Sign in with Apple pode falhar para usuários dessas regiões.
</Info>

## Solução de problemas

### Cliente inválido (Invalid client)

* Verifique se todas as credenciais foram inseridas corretamente
* Certifique-se de que a Private Key inclui as linhas BEGIN e END
* Verifique se o seu Services ID está configurado corretamente

### URI de redirecionamento inválida (Invalid redirect URI)

* Verifique se a Return URL na configuração do Apple Services ID corresponde exatamente ao valor mostrado em **Provider setup** no **painel Auth**
* Verifique se o domínio em Domains and Subdomains corresponde ao seu domínio publicado (sem `https://`)

### Email relay não funciona

* Verifique se a Email Source mostra um ícone verde de confirmação no portal Apple Developer
* Aguarde a propagação do DNS se foi adicionada recentemente

### Não funciona em domínio personalizado

* Adicione as entradas de domínio personalizado mostradas em **Provider setup** no **painel Auth** em Domains and Subdomains (sem `https://`) e em Return URLs

## Recursos adicionais

* [Documentação do Apple Sign in with Apple](https://developer.apple.com/sign-in-with-apple/)
* [Guia do Private Email Relay Service](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service)