---
title: Configuração de marca branca e empresarial
description: Domínios personalizados, portais de marca, SAML SSO e acesso à API para
  clubes empresariais
order: 86
source_hash: 2cf29b121add
slug: configuracao-de-marca-branca-e-empresarial
---

# Configuração de marca branca e empresarial

Alguns clubes operam o DistantRace em uma implantação de **marca branca**: um portal de participantes com marca em um domínio personalizado, conectado ao mesmo console do organizador e dados de eventos no DistantRace.

A marca branca é uma oferta **gerida pela plataforma**. O DistantRace habilita a bandeira do clube, credenciais OAuth, páginas de login temáticas, hospedagem de domínio personalizado e provedores de identidade SAML. Os organizadores continuam a criar eventos e gerenciar participantes no **console do gerente** como de costume.

Entre em contato com o suporte do DistantRace para discutir a marca branca para sua organização.

## O que a marca branca permite

| Capacidade | Experiência do participante | Organizador / plataforma |
|------------|-----------------------------|--------------------------|
| **Domínio personalizado** | Navegue e registre-se no URL do seu clube (por exemplo, `events.yourcompany.com`) | DNS + TLS provisionados pelo DistantRace; domínio verificado via [Domínios incorporados](embed-domains-for-iframes.md) |
| **Portal de marca** | Nome do clube, logotipo, cores e interface localizada | Marca SPA configurada no momento da implantação; conteúdo do evento ainda vem do DistantRace |
| **Login temático** | Páginas de login e conta correspondem à sua marca durante o OAuth | Modelos `domain_theme` no host de autenticação do DistantRace |
| **Login de participante OAuth** | Faça login no seu portal; sessão persiste no navegador | Aplicativo OAuth2 com código de autorização vinculado à sua organização |
| **Token de API da organização** | Listagens públicas (eventos, desafios, classificações) sem login | Token de leitura de longa duração para o backend do site de marca |
| **API de imagens heroicas** | Banners de carrossel na página inicial do portal | [Marca do clube e imagens heroicas](club-branding-and-hero-images.md) — disponível quando `is_whitelabel` está habilitado |
| **SAML / SSO empresarial** | Faça login com e-mail corporativo via Microsoft Entra ID ou outro IdP | Mapeamento de IdP por domínio; descoberta em `/saml2/discovery/` — veja [SAML empresarial e login de marca branca](../joining-events/enterprise-saml-and-whitelabel-login.md) |
| **E-mail de marca** | Códigos de login e e-mails transacionais do seu remetente | Integração [SendGrid](../integrations/sendgrid.md) no clube |
| **Códigos de adesão e convites** | Resgate códigos e links de convite por e-mail no site de marca | Mesmos códigos de adesão que distantrace.com; inscrição automática por link mágico via API |
| **Conexões de aplicativos esportivos** | Conecte Garmin, Strava, fontes de passos, etc. | Fluxos de conexão OAuth executados no host de autenticação canônico do DistantRace, depois retornam ao seu portal |
| **REST API** | Ações completas do participante após o login (aderir, sincronizar treinos, perfil) | Mesma superfície `/api/v1/` que o aplicativo móvel — [Visão geral da API pública](../more-tools/public-api-overview.md) |
| **Console do gerente** | N/A — organizadores usam distantrace.com | Inalterado; [Autenticação de dois fatores](../joining-events/two-factor-authentication.md) ainda necessária |

::: note Escopo da plataforma vs. portal
Um portal de participante de marca branca é uma interface focada sobre a API do DistantRace. Quais telas são expostas (apenas desafios, competições com checkout, classificações de equipe, etc.) depende da implantação. Todos os tipos de eventos e configurações subjacentes são configurados no console do gerente.
:::

## Como tudo se encaixa

```mermaid
flowchart LR
  subgraph portal [Portal de participante de marca]
    SPA[SPA de domínio personalizado]
  end
  subgraph drace [Plataforma DistantRace]
    API["/api/v1/"]
    Auth[OAuth + login temático]
    Console[Console do gerente]
    SAML[Descoberta SAML]
  end
  SPA -->|token da organização — dados públicos| API
  SPA -->|token do usuário — após login| API
  SPA -->|redirecionar| Auth
  Auth --> SAML
  Console --> API
```

1. **Portal do participante** — um aplicativo web no seu domínio. Ele carrega dados de eventos públicos com um token de API com escopo de organização e envia participantes para o OAuth do DistantRace para login.
2. **Autenticação DistantRace** — lida com códigos de login, OAuth, SAML e conexões de aplicativos esportivos. Modelos temáticos são aplicados quando o pedido OAuth inclui o contexto da sua organização.
3. **Console do gerente** — organizadores criam desafios, competições, ingressos e marketing no distantrace.com. As alterações aparecem no portal de marca através da API.

## Configuração (gerida pela plataforma)

O DistantRace geralmente cuida de:

| Item | Detalhes |
|------|---------|
| Bandeira do clube `is_whitelabel` | Desbloqueia a gestão de imagens heroicas e a API de imagens heroicas |
| Aplicações OAuth | **Cliente do usuário** (código de autorização) para login de participante; **token da organização** para listagens públicas |
| `domain_theme` | Seleciona modelos de login/cadastro de marca no host de autenticação |
| Hospedagem de domínio personalizado | Certificado TLS, entrada e nome de host de teste opcional `*.wl.distantrace.com` (corresponde ao seu slug `domain_theme`) |
| Provedores de identidade SAML | Registros `SAMLIdentityProvider` mapeados para domínios de e-mail |
| Implantação do portal | Construção SPA de marca, proxy de cache e CI/CD na infraestrutura de marca branca |

## O que os organizadores configuram por conta própria

| Tarefa | Onde |
|------|-------|
| Eventos, ingressos, códigos de adesão | Console do gerente — igual a qualquer clube |
| Imagens heroicas para o carrossel do portal | Marketing → **Hero images** (apenas clubes de marca branca) |
| Domínios incorporados / personalizados | Clube → **Embed domains** — [Domínios incorporados para iframes](embed-domains-for-iframes.md) |
| Remetente de e-mail de marca | Clube → Integrações → [SendGrid](../integrations/sendgrid.md) |
| Logotipo do clube | Clube → Configurações |
| Desativar e-mails de visão geral diária | Configuração a nível de clube ou por desafio (clubes de marca branca) |

## Fluxos de login do participante

Portais de marca branca geralmente usam **código de autorização OAuth**:

1. O participante clica em **Sign in** no site de marca.
2. O navegador redireciona para DistantRace `/oauth/authorize/` com o UUID da sua organização.
3. O DistantRace exibe uma página de login **temática** (código de e-mail, chave de acesso ou SAML — dependendo da configuração do clube).
4. Após a autenticação, o navegador retorna ao seu portal com um código trocado por tokens de acesso e atualização.
5. O portal chama `/api/v1/` com o token do usuário para ações pessoais (aderir ao desafio, sincronizar treinos, atualizar perfil).

**Links de convite por e-mail** podem fazer login automático dos participantes via o endpoint da API `redeem-email-token` quando o portal está configurado com um token da organização.

**SAML SSO** está disponível para clubes empresariais. Os participantes inserem um e-mail corporativo; o DistantRace direciona para o IdP correto por domínio. Veja [SAML empresarial e login de marca branca](../joining-events/enterprise-saml-and-whitelabel-login.md).

## Credenciais de API (visão geral)

Integrações de marca branca usam dois tipos de credenciais:

| Credencial | Concessão / tipo | Uso típico |
|------------|------------------|------------|
| **Token da organização** | Token de portador de longa duração (usuário administrador da organização) | Listagens públicas de desafios/eventos, imagens heroicas, validação de códigos de adesão, resgate de token de e-mail |
| **Cliente OAuth do usuário** | Código de autorização (+ token de atualização) | Login do participante, adesão a eventos, treinos, perfil, checkout |

Ambos são criados e rotacionados pelo DistantRace durante a integração. URIs de redirecionamento devem corresponder ao caminho `/auth/callback` do seu portal em cada ambiente (teste `*.wl.distantrace.com` e domínio personalizado de produção).

### URL de autorização OAuth

O login do participante começa em `/oauth/authorize/` com:

- `client_id` — sua aplicação OAuth do usuário
- `redirect_uri` — retorno de chamada registrado no seu portal
- `response_type=code`
- `org=<club-uuid>` — vincula a página de login à sua organização e seleciona o modelo temático

Após o participante autenticar-se (código de e-mail, chave de acesso ou SAML), o DistantRace redireciona para o seu retorno de chamada com um código de autorização. Troque-o no lado do servidor ou no SPA por tokens de acesso e atualização.

### Códigos de adesão e e-mails de convite

| Etapa | API |
|------|-----|
| Validar um código antes de mostrar o checkout | `GET /api/v1/event/joincode/{code}/validate/` (token da organização) |
| Resgatar link mágico de e-mail | `POST /api/v1/event/joincode/redeem-email-token/` com `{ "token": "…" }` |
| Criar códigos do seu back office | `POST /api/v1/event/joincode/` (token de usuário administrador — não o token público da organização) |

O resgate de link mágico pode criar automaticamente uma conta a partir de dados pré-preenchidos do código de adesão, retornar tokens OAuth e inscrever automaticamente o participante em um desafio vinculado quando configurado.

Mapa completo de endpoints: [Visão geral da API pública](../more-tools/public-api-overview.md).

## E-mail e notificações

Quando [SendGrid](../integrations/sendgrid.md) está conectado:

- E-mails de **código de login** usam o modelo transacional e endereço do remetente da sua organização.
- Modelos de registro e marketing seguem a mesma integração.

Clubes de marca branca podem suprimir o e-mail automático **Visão Geral Diária** para desafios de passos no nível da organização (`daily_email_disabled`) ou por desafio.

## Aplicativo móvel

O **aplicativo móvel DistantRace** padrão continua disponível. Os participantes podem conectar aplicativos esportivos e sincronizar passos através do aplicativo, mesmo quando se registram em um portal web de marca. O aplicativo não é de marca branca; os dados da conta são compartilhados entre distantrace.com, o aplicativo móvel e o portal de marca.

## Acesso do organizador

Os organizadores e a equipe continuam a usar o **console do gerente** no distantrace.com:

- Padrão de URL: `/console/<org-code>/`
- [Autenticação de dois fatores](../joining-events/two-factor-authentication.md) é necessária
- SAML pode ser usado para login de equipe em clubes empresariais, mas o acesso ao console é separado do fluxo OAuth do portal do participante

Veja [Como acessar o console do organizador](access-the-organizer-console.md).

## Relacionados

- [SAML empresarial e login de marca branca](../joining-events/enterprise-saml-and-whitelabel-login.md) — login do participante
- [Marca do clube e imagens heroicas](club-branding-and-hero-images.md)
- [Domínios incorporados para iframes](embed-domains-for-iframes.md)
- [Visão geral da API pública](../more-tools/public-api-overview.md)
- [SendGrid](../integrations/sendgrid.md)