Kurumsal SAML ve whitelabel giriş
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 (e-posta, Google, Apple, geçiş anahtarı) kullanır.
Markalı katılımcı portalı #
Whitelabel bir sitede genellikle:
- Kulübünüzün markalı URL'sini (distantrace.com değil) açarsınız.
- Giriş yapmadan yayınlanmış challenge ve etkinliklere göz atarsınız.
- 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_themei varsa. Kimlik doğrulamasından sonra, zaten giriş yapmış olarak markalı siteye geri dönersiniz.
DistantRace, markalamayı şu şekilde belirler:
- Portalınızda temalı bir giriş sırasında ayarlanan Oturum bayrakları
- Doğrulanmış gömme alan adı — portal URL'nizdeki veya OAuth
nextbağlantısındaki ana bilgisayar, kulübünüzle Gömme alan adları 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.
SAML / kurumsal SSO #
SAML yapılandırılmış kulüpler için:
- Kulübün markalı URL'sini veya doğrudan etkinlik bağlantısını açın.
- İş hesabı ile giriş yap / organizasyon girişi (veya SAML farkında bir giriş noktasından başlayın) tıklayın.
- İ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/). - Şirketinizin Microsoft (veya yapılandırılmış IdP) portalında kimlik doğrulamasını tamamlayın.
- 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 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 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ış.