---
title: Beyaz Etiket ve Kurumsal Kurulum
description: Kurumsal kulüpler için özel alan adları, markalı portallar, SAML SSO
  ve API erişimi
order: 86
source_hash: 2cf29b121add
slug: beyaz-etiket-ve-kurumsal-kurulum
---

# 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ı

| Özellik | Katılımcı Deneyimi | Organizatör / Platform |
|------------|------------------------|----------------------|
| **Özel alan adı** | Kulüp URL'nizde gezin ve kaydolun (ör. `events.yourcompany.com`) | DNS + TLS DistantRace tarafından sağlanır; alan adı [Gömülü alan adları](embed-domains-for-iframes.md) aracılığıyla doğrulanır |
| **Markalı portal** | Kulüp adı, logosu, renkler ve yerelleştirilmiş UI | SPA markalaması dağıtım sırasında yapılandırılır; etkinlik içeriği hala DistantRace'ten gelir |
| **Temalı giriş** | Giriş ve hesap sayfaları OAuth sırasında markanıza uygun olur | DistantRace kimlik doğrulama sunucusundaki `domain_theme` şablonları |
| **OAuth katılımcı girişi** | Portalınızda oturum açın; oturum tarayıcıda kalır | Kuruluşunuza özel yetkilendirme kodu OAuth2 uygulaması |
| **Kuruluş API belirteci** | Giriş yapmadan halka açık listeler (etkinlikler, yarışmalar, liderlik tabloları) | Markalı site arka planı için uzun ömürlü okuma belirteci |
| **Kahraman görselleri API** | Portal ana sayfasında karusel afişleri | [Kulüp markalama ve kahraman görselleri](club-branding-and-hero-images.md) — `is_whitelabel` etkinleştirildiğinde kullanılabilir |
| **SAML / kurumsal SSO** | Microsoft Entra ID veya başka bir IdP üzerinden iş e-postası ile oturum açın | Alan adına göre IdP eşlemesi; `/saml2/discovery/` adresinde keşif — bkz. [Kurumsal SAML ve beyaz etiket girişi](../joining-events/enterprise-saml-and-whitelabel-login.md) |
| **Markalı e-posta** | Giriş kodları ve işlem e-postaları göndericinizden gelir | Kulüpte [SendGrid](../integrations/sendgrid.md) entegrasyonu |
| **Katılım kodları ve davetler** | Markalı sitede kodları ve e-posta davet bağlantılarını kullanın | distantrace.com ile aynı katılım kodları; API aracılığıyla sihirli bağlantı otomatik kaydı |
| **Spor uygulama bağlantıları** | Garmin, Strava, adım kaynakları vb. bağlayın | OAuth bağlantı akışları kanonik DistantRace kimlik doğrulama sunucusunda çalışır, ardından portalınıza döner |
| **REST API** | Girişten sonra tam katılımcı eylemleri (katılma, antrenmanları senkronize etme, profil) | Mobil uygulama ile aynı `/api/v1/` yüzeyi — [Genel API genel bakış](../more-tools/public-api-overview.md) |
| **Yönetici konsolu** | N/A — organizatörler distantrace.com'u kullanır | Değişmez; [İki faktörlü kimlik doğrulama](../joining-events/two-factor-authentication.md) hala gereklidir |

::: note Platform vs. portal kapsamı
Bir beyaz etiket katılımcı portalı, DistantRace API üzerinde odaklanmış bir ön uçtur. Hangi ekranların gösterileceği (sadece yarışmalar, ödeme ile yarışmalar, takım liderlik tabloları vb.) dağıtıma bağlıdır. Tüm temel etkinlik türleri ve ayarları yönetici konsolunda yapılandırılır.
:::

## Nasıl Bir Araya Gelir

```mermaid
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:

| Öğe | Detaylar |
|------|---------|
| `is_whitelabel` kulüp bayrağı | Kahraman görsel yönetimini ve kahraman görselleri API'sini açar |
| OAuth uygulamaları | Katılımcı girişi için **Kullanıcı istemcisi** (yetkilendirme kodu); halka açık listeler için **kuruluş belirteci** |
| `domain_theme` | Kimlik doğrulama sunucusunda markalı giriş/kayıt şablonlarını seçer |
| Özel alan adı barındırma | TLS sertifikası, giriş ve isteğe bağlı `*.wl.distantrace.com` test ana bilgisayar adı (sizin `domain_theme` slug'ınıza uyar) |
| SAML kimlik sağlayıcıları | E-posta alan adlarına eşlenmiş `SAMLIdentityProvider` kayıtları |
| Portal dağıtımı | Markalı SPA yapısı, önbellek proxy'si ve beyaz etiket altyapısında CI/CD |

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

| Görev | Nerede |
|------|-------|
| Etkinlikler, biletler, katılım kodları | Yönetici konsolu — herhangi bir kulüp gibi |
| Portal karuseli için kahraman görselleri | Pazarlama → **Kahraman görselleri** (sadece beyaz etiket kulüpleri için) |
| Gömülü / özel alan adları | Kulüp → **Gömülü alan adları** — [Gömülü alan adları için iframe'ler](embed-domains-for-iframes.md) |
| Markalı e-posta gönderici | Kulüp → Entegrasyonlar → [SendGrid](../integrations/sendgrid.md) |
| Kulüp logosu | Kulüp → Ayarlar |
| Günlük genel bakış e-postalarını devre dışı bırak | Kulüp düzeyinde veya yarışma başına ayar (beyaz etiket kulüpleri) |

## 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](../joining-events/enterprise-saml-and-whitelabel-login.md).

## API Kimlik Bilgileri (Genel Bakış)

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

| Kimlik Bilgisi | Yetkilendirme / tür | Tipik kullanım |
|------------|--------------|-------------|
| **Kuruluş belirteci** | Uzun ömürlü taşıyıcı belirteci (kuruluş yönetici kullanıcısı) | Halka açık yarışma/etkinlik listeleri, kahraman görselleri, katılım kodu doğrulama, e-posta belirteci kullanımı |
| **Kullanıcı OAuth istemcisi** | Yetkilendirme kodu (+ yenileme belirteci) | Katılımcı girişi, etkinliklere katılma, antrenmanlar, profil, ödeme |

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ı

| Adım | API |
|------|-----|
| Ödeme göstermeden önce bir kodu doğrula | `GET /api/v1/event/joincode/{code}/validate/` (kuruluş belirteci) |
| E-posta sihirli bağlantısını kullan | `POST /api/v1/event/joincode/redeem-email-token/` ile `{ "token": "…" }` |
| Arka ofisinizden kodlar oluşturun | `POST /api/v1/event/joincode/` (yönetici kullanıcı belirteci — halka açık kuruluş belirteci değil) |

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ış](../more-tools/public-api-overview.md).

## E-posta ve Bildirimler

[SendGrid](../integrations/sendgrid.md) 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](../joining-events/two-factor-authentication.md) 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](access-the-organizer-console.md).

## İlgili

- [Kurumsal SAML ve beyaz etiket girişi](../joining-events/enterprise-saml-and-whitelabel-login.md) — katılımcı girişi
- [Kulüp markalama ve kahraman görselleri](club-branding-and-hero-images.md)
- [Gömülü alan adları için iframe'ler](embed-domains-for-iframes.md)
- [Genel API genel bakış](../more-tools/public-api-overview.md)
- [SendGrid](../integrations/sendgrid.md)