Saltar para o conteúdo principal

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.

Este guia apresenta o passo a passo para criar o App ID, o Services ID e a Chave Privada da Apple necessários para o Sign in with Apple. Você coletará um Team ID, um Services ID, um Key ID e uma Private Key para inserir no painel Auth.
Esta página cobre apenas a configuração do lado do provedor no portal de Desenvolvedores da Apple. Para o fluxo geral do Clerk Auth — incluindo ativar a Apple e inserir as credenciais no painel Auth — consulte Configurando credenciais OAuth para um provedor SSO na documentação do Clerk Auth.

​
Pré-requisitos

  • Uma conta de Desenvolvedor Apple (requer inscrição no Apple Developer Program)
  • Um app Replit publicado — credenciais OAuth personalizadas estão disponíveis apenas 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

​
Passo 1: Criar um Apple App ID

  1. Acesse o portal de Desenvolvedores Apple
  2. Vá para Certificates, IDs & Profiles e, em seguida, para Identifiers
  3. Selecione App IDs no menu suspenso
  4. Selecione o ícone + para registrar um novo identificador
  5. Selecione App IDs e, em seguida, Continue
  6. Escolha App e, em seguida, Continue
  7. Preencha:
    • Description: Nome para o seu App ID
    • Bundle ID: Seu identificador único
  8. Ative Sign In with Apple em Capabilities
  9. Selecione Continue e, em seguida, Register
  10. Salve seu App ID Prefix (mostrado no topo) — este é o seu Team ID

​
Passo 2: Criar um Apple Services ID

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

​
Configurar o Services ID

  1. Selecione o Services ID recém-criado
  2. Ative Sign In with Apple
  3. Selecione Configure
  4. Defina:
    • Primary App ID: Selecione seu App ID do Passo 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
    Consulte Configurando credenciais OAuth para um provedor SSO para saber como encontrar esses valores.
  5. Selecione Next, depois Done, depois Continue e, por fim, Save

​
Passo 3: Criar uma Apple Private Key

  1. Na barra lateral do portal de Desenvolvedores Apple, selecione Keys
  2. Selecione + para registrar uma nova chave
  3. Insira um Key Name
  4. Ative Sign In with Apple
  5. Selecione Configure e, em seguida, selecione seu App ID do Passo 1
  6. Selecione Save, depois Continue e, em seguida, Register
  7. Salve o Key ID
  8. Baixe o arquivo de chave privada (.p8)
Você só pode baixar a chave privada uma vez. Armazene-a em local seguro — não é possível baixá-la novamente.

​
Passo 4: Configurar o Apple Private Email Relay

O recurso Hide My Email da Apple permite que os usuários façam login sem revelar seu e-mail real. Para enviar e-mails a esses usuários, registre sua fonte de e-mail.
  1. Na barra lateral do portal de Desenvolvedores Apple, selecione Services
  2. Em Sign in with Apple for Email Communication, selecione Configure
  3. Selecione + para adicionar um Email Source
  4. Insira o valor de Email Source mostrado em Provider setup no painel Auth
  5. Selecione Next, depois Register e, em seguida, Done
  6. Aguarde a verificação de DNS (ícone de check verde)
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 nessas regiões.

​
Solução de problemas

​
Cliente inválido

  • 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

  • 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://)

​
E-mail relay não está funcionando

  • Verifique se o Email Source exibe um check verde no portal de Desenvolvedores Apple
  • Aguarde a propagação de DNS caso tenha sido adicionado recentemente

​
Não está funcionando no 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