---
title: Login empresarial com SAML e whitelabel
description: Faça login em um portal de clube personalizado com SSO, OAuth ou códigos
  de login por e-mail
order: 57
source_hash: e9db77099340
slug: 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](sign-in-options.md) (e-mail, Google, Apple, chave de acesso).

## Portal de participantes personalizado

Em um site whitelabel, você geralmente:

1. Abre o **URL personalizado do seu clube** (não distantrace.com).
2. Navega por desafios e eventos publicados sem fazer login.
3. 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:

1. **Flags de sessão** definidos durante um login temático no seu portal
2. **Domínio incorporado verificado** — o host no URL do seu portal ou link `next` do OAuth mapeia para o seu clube via [Domínios incorporados](../running-events/embed-domains-for-iframes.md)

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](../running-events/whitelabel-and-enterprise-setup.md).

## SAML / SSO empresarial

Para clubes com SAML configurado:

1. Abra o URL personalizado do clube ou um link direto para o evento.
2. Clique em **Entrar com conta corporativa** / login da organização (ou comece de um ponto de entrada compatível com SAML).
3. 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/`).
4. Complete a autenticação no portal Microsoft da sua empresa (ou IdP configurado).
5. 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](../integrations/sendgrid.md) 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](two-factor-authentication.md). 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](../more-tools/public-api-overview.md).

## Relacionados

- [Configuração de whitelabel e empresarial](../running-events/whitelabel-and-enterprise-setup.md)
- [Personalização de clube e imagens de destaque](../running-events/club-branding-and-hero-images.md)
- [Opções de login](sign-in-options.md)
- [Links de convite por e-mail](email-invitation-links.md)