Pular para o conteúdo principal
Authentication e Players

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

ProvedorFaz o login dos jogadores comStatus
GoogleUma conta Google, via OAuth 2.0Disponível
FacebookUma conta Facebook ou Meta, via OAuth 2.0Disponível
AppleSign 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
EpicUma 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 WebhookO seu próprio servidor de autenticação chama o PlayServ: para jogos que já têm login próprio.Em breve
PlayServ Auth TokenO 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:

CampoO que informar
Client IDO ID do cliente OAuth.
Client SecretO segredo do cliente OAuth.
Redirect URISomente 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:

CampoO que informar
App IDO ID numérico do app, de 15 a 17 dígitos.
App SecretO segredo do app, com 32 caracteres hexadecimais.
Redirect URISomente 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:

CampoO que informar
Services IDO Services ID registrado no seu App ID.
Team IDO ID do seu time no Apple Developer.
Key IDO ID da chave do Sign in with Apple.
Private key (.p8 PEM)O conteúdo do arquivo .p8, uma chave P-256.
Redirect URISomente 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:

CampoO que informar
Client IDO ID do cliente no Epic Online Services.
Client SecretO segredo do cliente.
Deployment IDO deployment em que os jogadores fazem login. O PlayServ deduz dele o produto e o sandbox.
Redirect URISomente 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

StatusSignificado
not configuredNada foi salvo ainda.
incompleteFalta um campo obrigatório.
configuredTodos os campos obrigatórios estão salvos, mas nenhum teste passou.
verifiedUm 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

Atualizado em 16 de out. de 2026