---
title: Kurumsal SAML ve whitelabel giriş
description: SSO, OAuth veya e-posta giriş kodları ile markalı bir kulüp portalına
  giriş yapın
order: 57
source_hash: e9db77099340
slug: kurumsal-saml-ve-whitelabel-giris
---

# Kurumsal SAML ve whitelabel giriş

Bazı kulüpler, SAML aracılığıyla **kurumsal tek oturum açma (SSO)** (genellikle Microsoft Entra ID / Azure AD) veya DistantRace üzerinden OAuth tabanlı giriş ile özel bir alan adında markalı bir web sitesi olan bir **whitelabel** DistantRace dağıtımı üzerinde çalışır.

## Bu kimler için geçerli

- Whitelabel etkinleştirilmiş kurumsal veya federasyon kulüpleri
- **İş e-posta** alanı kullanması beklenen katılımcılar (SAML için)
- Giriş işlemini distantrace.com yerine markalı bir portal üzerinden yönlendiren organizasyonlar

Standart distantrace.com kullanıcıları [Giriş seçenekleri](sign-in-options.md) (e-posta, Google, Apple, geçiş anahtarı) kullanır.

## Markalı katılımcı portalı

Whitelabel bir sitede genellikle:

1. **Kulübünüzün markalı URL'sini** (distantrace.com değil) açarsınız.
2. Giriş yapmadan yayınlanmış challenge ve etkinliklere göz atarsınız.
3. Katılmak, antrenmanları senkronize etmek veya profilinizi yönetmek istediğinizde **Giriş yap**'a tıklarsınız.

Giriş, organizasyonunuzun UUID'si ile yetkilendirme URL'sinde DistantRace OAuth'a yönlendirir. Giriş sayfaları, kulübünüzün **temalı** şablonlarını (logo, renkler, metin) kullanır, eğer kulübün varsayılan olmayan bir `domain_theme`i varsa. Kimlik doğrulamasından sonra, zaten giriş yapmış olarak markalı siteye geri dönersiniz.

DistantRace, markalamayı şu şekilde belirler:

1. Portalınızda temalı bir giriş sırasında ayarlanan **Oturum bayrakları**
2. **Doğrulanmış gömme alan adı** — portal URL'nizdeki veya OAuth `next` bağlantısındaki ana bilgisayar, kulübünüzle [Gömme alan adları](../running-events/embed-domains-for-iframes.md) aracılığıyla eşleştirilir

Portalda gösterilenler — liderlik tabloları, takım sonuçları, yarışma ödeme, antrenman geçmişi — kulübünüzün portalının nasıl yapılandırıldığına bağlıdır. Etkinlik kuralları ve kayıt hala organizatörün DistantRace ayarlarından gelir.

Organizatörlere yönelik genel bakış: [Whitelabel ve kurumsal kurulum](../running-events/whitelabel-and-enterprise-setup.md).

## SAML / kurumsal SSO

SAML yapılandırılmış kulüpler için:

1. Kulübün markalı URL'sini veya doğrudan etkinlik bağlantısını açın.
2. **İş hesabı ile giriş yap** / organizasyon girişi (veya SAML farkında bir giriş noktasından başlayın) tıklayın.
3. İstendiğinde **iş e-postanızı** girin — DistantRace sizi e-posta alanına göre doğru kimlik sağlayıcısına yönlendirir (`/saml2/discovery/`).
4. Şirketinizin Microsoft (veya yapılandırılmış IdP) portalında kimlik doğrulamasını tamamlayın.
5. DistantRace'e giriş yapmış olarak geri dönün — etkinliklere her zamanki gibi kaydolun.

Alanınız yapılandırılmamışsa, IT yöneticinizle iletişime geçmenizi isteyen bir hata görürsünüz.

### Birden fazla kimlik sağlayıcı

Birden fazla SAML sağlayıcısı varsa, keşif sayfası e-posta **alanınızı** doğru IdP ile eşleştirir ve sizi `/saml2/login/?idp=…` adresine yönlendirmeden önce yönlendirir.

Yalnızca bir IdP yapılandırılmışsa, keşif formu atlar ve sizi doğrudan girişe gönderir.

### Keşif hataları

| Mesaj | Anlamı |
|---------|---------|
| Geçerli bir iş e-postası girin | Eksik veya hatalı biçimlendirilmiş adres |
| Bu alan için Tek Oturum Açma yapılandırılmamış | IT ekibiniz bu e-posta alanını DistantRace ile kaydetmemiş |

Alanınızın desteklenmesi gerektiğini düşünüyorsanız, kulüp yöneticiniz veya IT ile iletişime geçin.

## Whitelabel üzerinde diğer giriş yöntemleri

Kulüp yapılandırmasına bağlı olarak, temalı giriş sayfaları ayrıca şunları sunabilir:

| Yöntem | Notlar |
|--------|-------|
| **E-posta giriş kodu** | Gelen kutunuza gönderilen tek seferlik kod; yapılandırıldığında kulübünüzün [SendGrid](../integrations/sendgrid.md) göndericisini kullanır |
| **Geçiş anahtarı (WebAuthn)** | Önceki bir ziyarette bir geçiş anahtarı kaydettiyseniz şifresiz giriş |
| **OAuth (yetkilendirme kodu)** | Markalı web portalları için varsayılan akış — tarayıcı DistantRace üzerinden ve geri yönlendirir |

Spor uygulaması bağlantıları (Garmin, Strava, adım kaynakları) OAuth sağlayıcı yönlendirmeleri için kanonik DistantRace kimlik doğrulama ana bilgisayarında açılır. URL'deki imzalı **sosyal dönüş** belirteci, sağlayıcı OAuth distantrace.com'da çalışsa bile sizi aynı temayla markalı portala geri getirir.

## Whitelabel markalama

Whitelabel kulüpleri şunları gösterebilir:

- Giriş ve hesap sayfalarında kulüp logosu ve renkleri
- Genel portaldaki özel kahraman resimleri
- SendGrid aracılığıyla markalı işlem e-postaları (giriş kodları, davetiyeler)

Alanlar, SAML ve portal barındırma için organizatör kurulumu platform tarafından yönetilir — organizasyonunuz için whitelabel etkinleştirmek için DistantRace ile iletişime geçin.

## Whitelabel kulüplerde organizatörler

Yönetici konsolu erişimi hala [İki faktörlü kimlik doğrulama](two-factor-authentication.md) gerektirir. SSO veya OAuth, markalı sitede katılımcı girişini yönetir; 2FA, distantrace.com'daki `/console/` görünümleri için ayrı bir güvenlik adımıdır.

## API erişimi

Whitelabel organizasyonları, organizasyon kapsamlı kimlik bilgileriyle REST API'yi kullanabilir — bkz. [Genel API genel bakış](../more-tools/public-api-overview.md).

## İlgili

- [Whitelabel ve kurumsal kurulum](../running-events/whitelabel-and-enterprise-setup.md)
- [Kulüp markalama ve kahraman resimleri](../running-events/club-branding-and-hero-images.md)
- [Giriş seçenekleri](sign-in-options.md)
- [E-posta davet bağlantıları](email-invitation-links.md)