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 explica como criar o App ID, Services ID e Chave Privada da Apple necessários para o Sign in with Apple. Você vai obter um Team ID, Services ID, Key ID e Private Key para inserir no painel Auth.
Esta página cobre apenas a configuração do lado do provedor no portal Apple Developer. Para o fluxo geral do Clerk Auth — incluindo como 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 Apple Developer (exige 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 Configurar → seção Provedores SSO → selecione o ambiente de Produção → selecione Editar ao lado de Apple

​
Etapa 1: Criar um App ID da Apple

  1. Acesse o portal Apple Developer
  2. Vá para 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 e depois Continue
  6. Escolha App e depois 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 depois Register
  10. Salve o seu App ID Prefix (exibido no topo) — este é o seu Team ID

​
Etapa 2: Criar um Services ID da Apple

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

​
Configurar o Services ID

  1. Selecione o Services ID que você acabou de criar
  2. Ative Sign In with Apple
  3. Selecione Configure
  4. Defina:
    • Primary App ID: Selecione o App ID da Etapa 1
    • Domains and Subdomains: Copie o valor exibido em Configuração do provedor no painel Auth (sem o prefixo de protocolo https://)
    • Return URLs: Copie o valor exibido em Configuração do provedor 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

​
Etapa 3: Criar uma Chave Privada da Apple

  1. Na barra lateral do portal Apple Developer, selecione Keys
  2. Selecione + para registrar uma nova chave
  3. Insira um Key Name
  4. Ative Sign In with Apple
  5. Selecione Configure e depois selecione o App ID da Etapa 1
  6. Selecione Save, depois Continue e, por fim, Register
  7. Salve o Key ID
  8. Faça o download do arquivo de chave privada (.p8)
Você só pode fazer o download da chave privada uma vez. Armazene-a com segurança — você não poderá baixá-la novamente.

​
Etapa 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 a origem do 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. Insira o valor da Email Source exibido em Configuração do provedor no painel Auth
  5. Selecione Next, depois Register e, por fim, Done
  6. Aguarde a verificação de DNS (ícone de visto verde)
Em algumas regiões (China, Índia), os Apple IDs podem estar vinculados a números de telefone em vez de e-mails. 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 Chave Privada inclui as linhas BEGIN e END
  • Verifique se o Services ID está configurado corretamente

​
URI de redirecionamento inválido

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

​
Relay de e-mail não está funcionando

  • Verifique se a Email Source exibe um visto verde no portal Apple Developer
  • Aguarde a propagação de DNS se foi adicionada recentemente

​
Não funciona no domínio personalizado

  • Adicione as entradas do domínio personalizado exibidas em Configuração do provedor no painel Auth em Domains and Subdomains (sem https://) e em Return URLs

​
Recursos adicionais