Login empresarial com SAML e whitelabel
Login empresarial com SAML e whitelabel
Alguns clubes operam em uma implantação whitelabel do DistantRace — um site personalizado em um domínio próprio com single sign-on (SSO) empresarial via SAML (geralmente Microsoft Entra ID / Azure AD) ou login baseado em OAuth através do DistantRace.
Para quem isso se aplica #
- Clubes corporativos ou de federação com whitelabel habilitado
- Participantes que devem usar um domínio de e-mail corporativo (para SAML)
- Organizações que direcionam o login através de um portal personalizado em vez de distantrace.com
Usuários padrão do distantrace.com utilizam Opções de login (e-mail, Google, Apple, chave de acesso).
Portal de participantes personalizado #
Em um site whitelabel, você geralmente:
- Abre o URL personalizado do seu clube (não distantrace.com).
- Navega por desafios e eventos publicados sem fazer login.
- Clica em Entrar quando quiser participar, sincronizar treinos ou gerenciar seu perfil.
O login redireciona para o OAuth do DistantRace com o UUID da sua organização na URL de autorização. As páginas de login usam os modelos temáticos do seu clube (logotipo, cores, texto) quando o clube tem um domain_theme não padrão. Após a autenticação, você retorna ao site personalizado, já logado.
O DistantRace resolve a personalização a partir de:
- Flags de sessão definidos durante um login temático no seu portal
- Domínio incorporado verificado — o host no URL do seu portal ou link
nextdo OAuth mapeia para o seu clube via Domínios incorporados
O que o portal exibe — classificações, resultados de equipes, checkout de competições, histórico de treinos — depende de como o portal do seu clube está configurado. As regras do evento e o registro ainda vêm das configurações do DistantRace do organizador.
Visão geral para organizadores: Configuração de whitelabel e empresarial.
SAML / SSO empresarial #
Para clubes com SAML configurado:
- Abra o URL personalizado do clube ou um link direto para o evento.
- Clique em Entrar com conta corporativa / login da organização (ou comece de um ponto de entrada compatível com SAML).
- Insira seu e-mail corporativo se solicitado — o DistantRace o direciona para o provedor de identidade correto pelo domínio do e-mail (
/saml2/discovery/). - Complete a autenticação no portal Microsoft da sua empresa (ou IdP configurado).
- Retorne ao DistantRace logado — registre-se para eventos como de costume.
Se o seu domínio não estiver configurado, você verá um erro pedindo para contatar o administrador de TI.
Múltiplos provedores de identidade #
Quando existem vários provedores SAML, a página de descoberta combina seu domínio de e-mail com o IdP correto antes de redirecionar para /saml2/login/?idp=….
Se apenas um IdP estiver configurado, a descoberta pula o formulário e o envia diretamente para o login.
Erros de descoberta #
| Mensagem | Significado |
|---|---|
| Insira um e-mail corporativo válido | Endereço ausente ou mal formatado |
| Não temos Single Sign-On configurado para este domínio | Sua equipe de TI não registrou esse domínio de e-mail no DistantRace |
Contate o administrador do seu clube ou TI se seu domínio deveria ser suportado.
Outros métodos de login no whitelabel #
Dependendo da configuração do clube, as páginas de login temáticas também podem oferecer:
| Método | Notas |
|---|---|
| Código de login por e-mail | Código único enviado para sua caixa de entrada; usa o remetente SendGrid do seu clube quando configurado |
| Chave de acesso (WebAuthn) | Login sem senha se você registrou uma chave de acesso em uma visita anterior |
| OAuth (código de autorização) | Fluxo padrão para portais web personalizados — o navegador redireciona através do DistantRace e de volta |
Conexões de aplicativos esportivos (Garmin, Strava, fontes de passos) abrem no host de autenticação canônico do DistantRace para redirecionamentos do provedor OAuth. Um token de retorno social assinado na URL traz você de volta ao portal personalizado com o mesmo tema, mesmo que o OAuth do provedor funcione no distantrace.com.
Personalização whitelabel #
Clubes whitelabel podem exibir:
- Logotipo e cores do clube nas páginas de login e conta
- Imagens de destaque personalizadas no portal público
- E-mails transacionais personalizados (códigos de login, convites) via SendGrid
A configuração do organizador para domínios, SAML e hospedagem de portal é gerenciada pela plataforma — contate o DistantRace para habilitar o whitelabel para sua organização.
Organizadores em clubes whitelabel #
O acesso ao console de gerenciamento ainda requer Autenticação de dois fatores. SSO ou OAuth gerencia o login dos participantes no site personalizado; 2FA é uma etapa de segurança separada para visualizações /console/ no distantrace.com.
Acesso à API #
Organizações whitelabel podem usar a API REST com credenciais de escopo organizacional — veja Visão geral da API pública.