Beyaz Etiket ve Kurumsal Kurulum

Bazı kulüpler, DistantRace'i beyaz etiket dağıtımı üzerinde çalıştırır: DistantRace üzerindeki aynı organizatör konsolu ve etkinlik verilerine bağlı, özel bir alan adında markalı bir katılımcı portalı.

Beyaz etiket, platform tarafından yönetilen bir hizmettir. DistantRace, kulüp bayrağını, OAuth kimlik bilgilerini, temalı giriş sayfalarını, özel alan adı barındırmayı ve SAML kimlik sağlayıcılarını etkinleştirir. Organizatörler, her zamanki gibi yönetici konsolu üzerinden etkinlikler oluşturup katılımcıları yönetmeye devam eder.

Kuruluşunuz için beyaz etiket hakkında konuşmak için DistantRace desteği ile iletişime geçin.

Beyaz Etiketin Sağladıkları #

Nasıl Bir Araya Gelir #

flowchart LR
  subgraph portal [Markalı katılımcı portalı]
    SPA[Özel alan adı SPA]
  end
  subgraph drace [DistantRace platformu]
    API["/api/v1/"]
    Auth[OAuth + temalı giriş]
    Console[Yönetici konsolu]
    SAML[SAML keşfi]
  end
  SPA -->|kuruluş belirteci — halka açık veri| API
  SPA -->|kullanıcı belirteci — girişten sonra| API
  SPA -->|yönlendirme| Auth
  Auth --> SAML
  Console --> API

1. Katılımcı portalı — alan adınızda bir web uygulaması. Organizasyona özel bir API belirteci ile halka açık etkinlik verilerini yükler ve katılımcıları DistantRace OAuth'a giriş için gönderir.
2. DistantRace kimlik doğrulama — giriş kodlarını, OAuth, SAML ve spor uygulama bağlantılarını yönetir. OAuth isteği kuruluş bağlamınızı içerdiğinde temalı şablonlar uygulanır.
3. Yönetici konsolu — organizatörler distantrace.com'da yarışmalar, yarışmalar, biletler ve pazarlama oluşturur. Değişiklikler API aracılığıyla markalı portala yansır.

Kurulum (platform tarafından yönetilen) #

DistantRace genellikle şunları sağlar:

Organizatörlerin Kendilerinin Yapılandırdığı #

Katılımcı Giriş Akışları #

Beyaz etiket portalları genellikle OAuth yetkilendirme kodu kullanır:

1. Katılımcı markalı sitede Giriş yap'a tıklar.
2. Tarayıcı, organizasyonunuzun UUID'si ile DistantRace /oauth/authorize/ adresine yönlendirilir.
3. DistantRace, temalı bir giriş sayfası gösterir (e-posta kodu, erişim anahtarı veya SAML — kulüp yapılandırmasına bağlı olarak).
4. Kimlik doğrulamasından sonra, tarayıcı erişim ve yenileme belirteçleri ile değiştirilecek bir kod ile portalınıza döner.
5. Portal, kişisel eylemler için kullanıcı belirteci ile /api/v1/ çağrısı yapar (yarışmaya katılma, antrenmanları senkronize etme, profili güncelleme).

E-posta davet bağlantıları, portal bir kuruluş belirteci ile yapılandırıldığında redeem-email-token API uç noktası aracılığıyla katılımcıları otomatik olarak oturum açabilir.

SAML SSO, kurumsal kulüpler için mevcuttur. Katılımcılar bir iş e-postası girer; DistantRace, alan adına göre doğru IdP'ye yönlendirir. Bkz. Kurumsal SAML ve beyaz etiket girişi.

API Kimlik Bilgileri (Genel Bakış) #

Beyaz etiket entegrasyonları iki kimlik bilgisi türü kullanır:

Her ikisi de DistantRace tarafından katılım sırasında oluşturulur ve döndürülür. Yönlendirme URI'leri, her ortamda portalınızın /auth/callback yoluna uymalıdır (test *.wl.distantrace.com ve üretim özel alan adı).

OAuth yetkilendirme URL'si #

Katılımcı girişi /oauth/authorize/ ile başlar:

• client_id — kullanıcı OAuth uygulamanız
• redirect_uri — portalınızda kayıtlı geri çağırma
• response_type=code
• org=<club-uuid> — giriş sayfasını kuruluşunuza bağlar ve temalı şablonu seçer

Katılımcı kimlik doğruladıktan sonra (e-posta kodu, erişim anahtarı veya SAML), DistantRace, yetkilendirme kodu ile geri çağırmanıza yönlendirir. Erişim ve yenileme belirteçleri için sunucu tarafında veya SPA'da değiştirin.

Katılım Kodları ve Davet E-postaları #

Sihirli bağlantı kullanımı, katılım kodu önceden doldurma verilerinden otomatik olarak bir hesap oluşturabilir, OAuth belirteçlerini döndürebilir ve yapılandırıldığında katılımcıyı bağlı bir yarışmaya otomatik olarak kaydedebilir.

Tam uç nokta haritası: Genel API genel bakış.

E-posta ve Bildirimler #

SendGrid bağlandığında:

• Giriş kodu e-postaları, kuruluşunuzun işlem şablonunu ve gönderici adresini kullanır.
• Kayıt ve pazarlama şablonları aynı entegrasyonu takip eder.

Beyaz etiket kulüpleri, adım yarışmaları için otomatik Günlük Genel Bakış e-postasını organizasyon düzeyinde (daily_email_disabled) veya yarışma başına bastırabilir.

Mobil Uygulama #

Standart DistantRace mobil uygulaması hala kullanılabilir. Katılımcılar, markalı bir web portalında kaydolduklarında bile spor uygulamalarını bağlayabilir ve adımları uygulama aracılığıyla senkronize edebilir. Uygulama beyaz etiketli değildir; hesap verileri distantrace.com, mobil uygulama ve markalı portal arasında paylaşılır.

Organizatör Erişimi #

Organizatörler ve personel, distantrace.com'daki yönetici konsolu kullanmaya devam eder:

• URL deseni: /console/<org-code>/
• İki faktörlü kimlik doğrulama gereklidir
• SAML, kurumsal kulüplerde personel girişi için kullanılabilir, ancak konsol erişimi katılımcı portalı OAuth akışından ayrıdır

Bkz. Organizatör konsoluna nasıl erişilir.

İlgili #

• Kurumsal SAML ve beyaz etiket girişi — katılımcı girişi
• Kulüp markalama ve kahraman görselleri
• Gömülü alan adları için iframe'ler
• Genel API genel bakış
• SendGrid