Esta página ainda não foi traduzida: mostrando a versão em inglês.
SSO & Auth
Em SSO & Auth você decide com quais provedores os jogadores podem fazer login. Cada provedor é um cartão: você informa as credenciais do console de desenvolvedor do provedor, testa e ativa o provedor. Abra a página em Players → SSO & Auth. Os provedores e as credenciais valem para o Project inteiro, em todos os Environments; só a lista de logins com falha e recusados acompanha o Environment selecionado na barra superior.
O cabeçalho mostra quantos provedores estão ativados entre os seis cartões, incluindo os dois que chegam em breve.
Provedores
| Provedor | Faz o login dos jogadores com | Status |
|---|---|---|
| Uma conta Google, via OAuth 2.0 | Disponível | |
| Uma conta Facebook ou Meta, via OAuth 2.0 | Disponível | |
| Apple | Sign in with Apple. Um app iOS que oferece qualquer outro login social precisa oferecer este também, pela diretriz 4.8 da App Store. | Disponível |
| Epic | Uma conta Epic Games, via Epic Online Services. Vale ativar se você publica na Epic Games Store ou mira quem tem conta Epic. | Disponível |
| PlayServ Webhook | O seu próprio servidor de autenticação chama o PlayServ: para jogos que já têm login próprio. | Em breve |
| PlayServ Auth Token | O SDK passa um token que você assina no seu servidor: para jogos que emitem os próprios JWTs. | Em breve |
O login com Steam é suportado pela plataforma e pelo SDK, mas ainda não pode ser configurado no Backoffice.
Configurar um provedor
Todo provedor segue o mesmo caminho: as credenciais vêm do console do provedor, a Redirect URI do cartão volta para esse console, e depois vêm Save, Test connection e o botão de ativação. O cartão mostra unsaved changes até você salvar.
Crie um cliente OAuth no Google Cloud
No console do Google Cloud, abra ou crie um projeto, vá em APIs & Services → Credentials e crie um OAuth 2.0 Client ID do tipo Web application.
Informe as credenciais
Expanda o cartão Google e preencha:
| Campo | O que informar |
|---|---|
| Client ID | O ID do cliente OAuth. |
| Client Secret | O segredo do cliente OAuth. |
| Redirect URI | Somente leitura: gerada pelo PlayServ; copie-a no próximo passo. |
Registre a Redirect URI
Adicione a Redirect URI do cartão em Authorised redirect URIs do cliente no Google Cloud e salve lá.
Salve, teste e ative
Clique em Save, depois em Test connection e então ligue o botão de ativação.
Obtenha as credenciais do app na Meta
No Meta for Developers, abra ou crie um app e copie o App ID e o App Secret em Settings → Basic.
Informe as credenciais
Expanda o cartão Facebook e preencha:
| Campo | O que informar |
|---|---|
| App ID | O ID numérico do app, de 15 a 17 dígitos. |
| App Secret | O segredo do app, com 32 caracteres hexadecimais. |
| Redirect URI | Somente leitura: gerada pelo PlayServ; copie-a no próximo passo. |
Registre a Redirect URI
Adicione a Redirect URI do cartão em Valid OAuth Redirect URIs, em Facebook Login → Settings, e salve lá.
Salve, teste e ative
Clique em Save, depois em Test connection e então ligue o botão de ativação.
Configure o Sign in with Apple
No Apple Developer → Certificates, Identifiers & Profiles, ative Sign in with Apple no identificador do seu app e crie um Services ID para ele.
Crie uma chave
Em Keys, crie uma chave com Sign in with Apple ativado e baixe o arquivo .p8 dela. Anote o Key ID e o seu Team ID, que fica no canto superior direito do portal.
Informe as credenciais
Expanda o cartão Apple e preencha:
| Campo | O que informar |
|---|---|
| Services ID | O Services ID registrado no seu App ID. |
| Team ID | O ID do seu time no Apple Developer. |
| Key ID | O ID da chave do Sign in with Apple. |
| Private key (.p8 PEM) | O conteúdo do arquivo .p8, uma chave P-256. |
| Redirect URI | Somente leitura: gerada pelo PlayServ; copie-a no próximo passo. |
Registre a Redirect URI
Adicione a Redirect URI do cartão em Return URLs do Services ID, em Sign in with Apple → Configure, e salve lá.
Salve, teste e ative
Clique em Save, depois em Test connection e então ligue o botão de ativação.
Obtenha as credenciais do cliente na Epic
No Epic Developer Portal, abra o seu produto e copie o Client ID e o Client Secret de um cliente em Product Settings → Clients, além do Deployment ID em que os jogadores devem fazer login.
Informe as credenciais
Expanda o cartão Epic e preencha:
| Campo | O que informar |
|---|---|
| Client ID | O ID do cliente no Epic Online Services. |
| Client Secret | O segredo do cliente. |
| Deployment ID | O deployment em que os jogadores fazem login. O PlayServ deduz dele o produto e o sandbox. |
| Redirect URI | Somente leitura: gerada pelo PlayServ; copie-a no próximo passo. |
Registre a Redirect URI
Adicione a Redirect URI do cartão em Redirect URL(s) do cliente, em Product Settings → Clients, e salve lá.
Salve, teste e ative
Clique em Save, depois em Test connection e então ligue o botão de ativação.
Test connection lista cada verificação como aprovada, com falha ou com aviso, e o cartão guarda quando foi o último teste e qual foi o resultado. O teste também roda sobre edições não salvas, para você experimentar credenciais antes de salvá-las; um teste assim não muda o status do cartão. O botão de ativação vale na hora.
Alterações não salvas se perdem
As edições em um cartão são só um rascunho até você clicar em Save. Sair da página ou clicar em Cancel descarta tudo.
Status da conexão
| Status | Significado |
|---|---|
| not configured | Nada foi salvo ainda. |
| incomplete | Falta um campo obrigatório. |
| configured | Todos os campos obrigatórios estão salvos, mas nenhum teste passou. |
| verified | Um teste passou. Salvar credenciais novas mantém esse status, então ele não prova que as credenciais atuais funcionam. |
Um provedor é oferecido aos jogadores quando está ativado e configured ou verified. Desativá-lo tira o provedor da lista oferecida ao seu jogo.
Ativado não é o mesmo que verificado
O botão de ativação não espera um teste, então um provedor pode estar ligado com credenciais que não funcionam. Rode Test connection antes de ativar um provedor e de novo sempre que mudar as credenciais dele.
Testar o login de ponta a ponta
Onde o Backoffice oferece, Test sign-in, no cabeçalho da aba, abre uma página que faz o login pelos provedores ativados exatamente como um jogo faria, sem escrever código.
Informe uma client key
Cole uma client key (pk_…) do Project em Public SDK key. A chave carrega o Project e o Environment, então a página os identifica sozinha.
As client keys são criadas em Projects, no painel API keys do Project: Create key, tipo Client. O segredo dela aparece uma única vez, em Save your token; se você não o guardou, crie uma nova chave.
Escolha um provedor
A página destaca um cartão para cada provedor ativado e configurado. Google, Apple e Epic executam o login completo, tela de consentimento incluída. Steam recebe um session ticket do Steamworks SDK, já que não tem login pelo navegador. O Facebook ainda não está na página.
Confira o resultado
Um login bem-sucedido mostra o player ID e o token de sessão emitidos pelo PlayServ.
Os logins de teste criam Players de verdade
A página faz o login de verdade: uma conta de provedor que nunca fez login antes vira um novo Player no Environment e aparece em Players.
Logins com falha e recusados
Recent failed and refused sign-ins, no fim da aba, lista os logins malsucedidos do Project, do mais recente para o mais antigo. Failed significa que a credencial estava errada; refused significa que o PlayServ a recusou, por exemplo por um aparelho ou uma conta banidos. Filtre por resultado e clique em uma linha para abrir o Player. Os logins que nem chegaram a uma conta mostram o fingerprint do aparelho no lugar. As tentativas de um único Player ficam nos detalhes dele.
Próximos passos
- Managing Players — as contas que os jogadores recebem ao fazer login
- Login do usuário — como fazer o login dos jogadores no seu jogo
- Gerenciamento de API keys — a client key usada pelo seu jogo e pela página de teste
Atualizado em 16 de out. de 2026