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 na documentação do Clerk Auth.
Pré-requisitos
- Uma conta Apple Developer (requer inscrição no Apple Developer Program)
- Um app do Replit publicado — 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
- Acesse o portal Apple Developer
- Vá em Certificates, IDs & Profiles e depois Identifiers
- Selecione App IDs no menu suspenso
- Selecione o ícone + para registrar um novo identificador
- Selecione App IDs, depois Continue
- Escolha App, depois Continue
- Preencha:
- Description: Nome para o seu App ID
- Bundle ID: Seu identificador único
- Habilite Sign In with Apple em Capabilities
- Selecione Continue, depois Register
- Salve o seu App ID Prefix (mostrado no topo) - este é o seu Team ID
Etapa 2: Crie um Apple Services ID
- Na página Identifiers, selecione Services IDs no menu suspenso
- Selecione + para registrar um novo identificador
- Selecione Services IDs, depois Continue
- Preencha:
- Description: Nome para o seu Services ID
- Identifier: Seu identificador único (salve isso - é o seu Services ID)
- Selecione Continue, depois Register
Configure o Services ID
- Selecione o Services ID que você acabou de criar
- Habilite Sign In with Apple
- Selecione Configure
-
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
- Selecione Next, depois Done, depois Continue, depois Save
Etapa 3: Crie uma Apple Private Key
- Na barra lateral do portal Apple Developer, selecione Keys
- Selecione + para registrar uma nova chave
- Digite um Key Name
- Habilite Sign In with Apple
- Selecione Configure, depois selecione seu App ID da Etapa 1
- Selecione Save, depois Continue, depois Register
- Salve o Key ID
- Baixe o arquivo da chave privada (.p8)
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.- Na barra lateral do portal Apple Developer, selecione Services
- Em Sign in with Apple for Email Communication, selecione Configure
- Selecione + para adicionar uma Email Source
- Digite o valor de Email Source mostrado em Provider setup no painel Auth
- Selecione Next, depois Register, depois Done
- Aguarde a verificação de DNS (ícone verde de confirmação)
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.
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