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 #

Como tudo se encaixa #

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:

O que os organizadores configuram por conta própria #

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.

Credenciais de API (visão geral) #

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

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 #

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.

E-mail e notificações #

Quando SendGrid 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 é 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.

Relacionados #

• SAML empresarial e login de marca branca — login do participante
• Marca do clube e imagens heroicas
• Domínios incorporados para iframes
• Visão geral da API pública
• SendGrid