Bu makale, kuruluşunuzun kimlik sağlayıcısını (IdP) kullanarak EloView 4 (EV4) içinde SAML 2.0 Tek Oturum Açma (SSO) kimlik doğrulamasını yapılandırmak için gereken adımları sağlamaktadır.
Güvenlik Beyan Dili (SAML), kullanıcıların başka bir güvenilir sistemden alınan kimlik bilgilerini kullanarak EloView'a güvenli bir şekilde giriş yapmalarını sağlayan açık bir standarttır. Kullanıcılar, EloView için ayrı bir kullanıcı adı ve şifre tutmak yerine, kuruluşunuzun merkezi kimlik sağlayıcısı aracılığıyla kimlik doğrulaması yaparlar.
SAML kullanmanın birçok avantajı vardır:
- Yükseltilmiş Güvenlik: Merkezi kimlik yönetimi ve çok faktörlü kimlik doğrulama (MFA) ile güvence altına alınır.
- Basitleştirilmiş Kullanıcı Erişimi: Tek Oturum Açma (SSO) ile iş akışı verimliliğini artırır.
- Azaltılmış Efor: Kullanıcıların ayrı EloView şifrelerini manuel olarak yönetmelerine, döndürmelerine veya hatırlamalarına gerek yoktur.
- Otomatik Sağlama: IdP yapılandırma eşlemeleri temelinde uygun rolleri dinamik olarak atar.
İçindekiler
- Başlamadan Önce
- Adım 1: EloView 4’te SAML Ayarlarına Erişim
- Adım 2: EloView SAML Yapılandırma Değerlerini Alma
- Adım 3: Kimlik Sağlayıcınızı Yapılandırın
- Adım 4: Gerekli SAML Özellik Eşleştirmelerini Yapılandır
- Adım 5: EloView'de Kimlik Sağlayıcı Metadata'sını Yapılandırın
- Adım 6: Kullanıcıları Atayın ve Kimlik Doğrulamasını Test Edin
- İsteğe Bağlı: Tek Çıkış (SLO) Yapılandırın
- Mevcut Bir Eski SAML Yapılandırmasını Taşımak
- SAML Kimlik Doğrulama Sorun Giderme
- SSO (SAML) Girişleri için API Tokenı
Başlamadan Önce
SAML kimlik doğrulamasını yapılandırmak için, aşağıdakilere sahip olduğunuzdan emin olun:
- EloView 4 hesabınıza yönetici erişimi.
- Kuruluşunuzun kimlik sağlayıcısına (IdP) yönetici erişimi.
- Kimlik sağlayıcınız içinde SAML uygulamaları oluşturma veya değiştirme izinleri.
- Kimlik doğrulaması yapacak kullanıcılara atanmış uygun EloView Organizasyon ID ve Rol ID’leri.
Adım 1: EloView 4’te SAML Ayarlarına Erişim
SAML ayarları paneline erişmek ve etkinleştirmek için:
- EloView Cloud Portal’a giriş yapın.
- Sağ üst köşedeki kullanıcı profili açılır menüsüne tıklayın ve Hesapı seçin.
-
Sağ üst alandaki Dişli simgesine tıklayarak Hesap Ayarları sayfasını açın.
-
Sol taraftaki navigasyon panelinde SAML sekmesini seçin ve Düzenleye tıklayın.
-
Giriş için yalnızca SAML ile Giriş Yap anahtarını etkinleştirerek SAML yapılandırma formunu gösterin.
Adım 2: EloView SAML Yapılandırma Değerlerini Alma
SAML formu görünür olduğunda, kimlik sağlayıcınızda uygulamayı kurarken kullanmak üzere EloView'dan birkaç Hizmet Sağlayıcı (SP) parametresini kaydetmeli veya kopyalamalısınız:
- ACS (Tüketici) URL: Kullanıcının başarıyla giriş yaptığı sonrası SAML beyanlarının gönderildiği son nokta.
- ACS (Tüketici) URL Doğrulayıcı: Beyanlar için doğrulama son noktası.
- Hedef Kitle (Varlık ID): SAML kimlik doğrulama sürecinizde EloView hizmet sağlayıcısının benzersiz kimlik tanımlayıcısı.
- SAML Giriş URL: Yapılandırılmış kimlik sağlayıcınızla doğrudan SSO kimlik doğrulaması başlatmak için kullanılan URL.
- Tek Çıkış URL: Koordineli çıkış işlemlerini gerçekleştirmek için kullanılan son nokta.
Bu değerleri güvenli bir şekilde kopyalamak için her alanın yanındaki mavi Kopyala simgesini kullanın.
Adım 3: Kimlik Sağlayıcınızı Yapılandırın
Seçtiğiniz kimlik sağlayıcısı içinde yeni bir SAML 2.0 uygulaması oluşturun. EloView parametreleri ile standart IdP ayarları arasındaki genel eşleşme aşağıdaki gibidir:
| Kimlik Sağlayıcı Ayarı | EloView Değeri |
|---|---|
| Tek Oturum Açma URL'si / Yanıt URL'si | ACS (Tüketici) URL |
| Hedef Kitle URI / Tanımlayıcı / Varlık ID | Hedef Kitle |
| Oturum Açma URL'si / Giriş URL'si | SAML Giriş URL |
Microsoft Entra ID (Azure AD)
- Microsoft Azure Portal’a giriş yapın.
- Şuraya gidin: Microsoft Entra ID → Kurumsal Uygulamalar.
- Yeni bir uygulama seçin: Yeni Uygulama → Kendi uygulamanızı oluşturun (veya Microsoft Entra SAML Toolkit’i kullanın).
- Yeni uygulamanızı açın, Tek Oturum Açma bölümüne gidin ve SAMLı seçin.
- Temel SAML Yapılandırması altında, şunları girin:
- Tanımlayıcı (Varlık ID): EloView'dan kopyalanan Hedef Kitle değeri.
- Yanıt URL'si (Beyan Tüketici Hizmet URL'si): EloView'dan kopyalanan ACS (Tüketici) URL.
- Giriş URL'si: EloView'dan kopyalanan SAML Giriş URL.
- Yapılandırmayı kaydedin.
- Özellikler & Talepler altında, Adım 4'te tanımlanan gereken EloView özelliklerini yapılandırın.
- SAML Sertifikaları altında, Adım 5'te kullanmak üzere Uygulama Federasyon Metadata URL'sini kopyalayın.
Okta
- Okta Yönetici Gösteriminde oturum açın.
- Şuraya gidin: Uygulamalar → Uygulamalar → Uygulama Entegrasyonu Ekle.
- Giriş yöntemi olarak SAML 2.0yı seçin ve İleri’ye tıklayın.
- Açıklayıcı bir uygulama adı girin ve İleri’ye tıklayın.
- SAML'ı Yapılandırın altında, şunları girin:
- Tek Oturum Açma URL'si: EloView’dan kopyalanan ACS (Tüketici) URL.
- Hedef Kitle URI (SP Varlık ID): EloView’dan kopyalanan Hedef Kitle değeri.
- Özellikler Bildirimleri altında, Adım 4'te açıklanan gerekli EloView özelliklerini ekleyin.
- Uygulama kurulumunu tamamlayın.
- Uygulamanın Oturum Açma sekmesini açın, SAML İmzalı Sertifikalar altında aktif sertifikayı bulun, İşlemlere tıklayın ve Kimlik Sağlayıcı Metadata'sını Görüntüleyi seçin.
- Adım 5'te kullanmak için oluşan metadata sayfasının URL'sini kopyalayın.
OneLogin
- OneLogin Yönetici Gösterimine giriş yapın.
- Şuraya gidin: Uygulamalar → Uygulama Ekle, arama yapın ve SAML Özel Bağlayıcı (Gelişmiş)yi seçin.
- Bir uygulama adı sağlayın ve Kaydet’e tıklayın.
- Uygulamanın Yapılandırma sayfasında, şunları girin:
- ACS (Tüketici) URL: EloView'dan kopyalanan ACS (Tüketici) URL.
- ACS (Tüketici) URL Doğrulayıcı: EloView'dan kopyalanan ACS (Tüketici) URL Doğrulayıcı.
- Hedef Kitle (VarlıkID): EloView'dan kopyalanan Hedef Kitle değeri.
- Giriş URL'si: EloView'dan kopyalanan SAML Giriş URL.
- SAML Başlatıcısını Hizmet Sağlayıcı olarak ayarlayın ve kaydedin.
- Kullanıcı için
elo_orgIdveelo_roleiçin özel kullanıcı alanları oluşturun. - Özellikler sekmesinde, Adım 4’te tanımlanan özel özellikleri yapılandırın ve bunların SAML beyanında yer aldığından emin olun.
- Uygulamaya uygun kullanıcıları atayın ve gerekli organizasyon ve rol değerlerini doldurun.
- Adım 5’te kullanmak üzere uygulamanın SSO sayfasından kimlik sağlayıcı metadata URL'sini alın.
Ping Identity / PingFederate
- Ping Identity Yönetim Konsolunuza giriş yapın.
- Şuraya gidin: Uygulamalar ve yeni bir SAML Uygulaması oluşturun.
- Manuel yapılandırmayı seçin ve EloView'dan kopyalanan ACS URL ve Hedef Kitle (Varlık ID) değerlerini girin.
- Uygulamanın Özellik Eşleme ayarlarını açın ve Adım 4'te tanımlanan gerekli özellikleri ekleyin.
- Kullanıcı alanları için
elo_orgIdveelo_roleiçin EloView tarafından sağlanan belirli değerleri kullanın. - Özellik eşleştirmelerini kaydedin ve uygulamanın etkin olduğunu doğrulayın.
- Uygulamanın bağlantı detayları altında Kimlik Sağlayıcı metadata URL’sini bulun ve kopyalayın, Adım 5'te kullanın.
Adım 4: Gerekli SAML Özellik Eşleştirmelerini Yapılandır
EloView, kullanıcı profillerini doğrulamak, organizasyon üyeliğini yetkilendirmek ve izinleri dinamik olarak atamak için SAML beyan özelliklerini kullanır. Bu özellikleri IdP'nizde yapılandırın:
| Özellik Adı | Açıklama | Kaynak Eşleme / Notlar |
|---|---|---|
elo_orgId |
EloView Organizasyon Tanımlayıcısı | EloView Hesap Ayarları'nda SAML yapılandırma sayfasından belirli değeri kopyalayın. |
elo_role |
Kullanıcıya atanan EloView Rol ID'si | Rol ID'si (görüntü adı değil) kullanılmalıdır. EloView → Roller bölümünde Rol ID'sini bulabilirsiniz. |
firstName |
Kullanıcının Adı | ör. user.givenname / user.firstName
|
lastName |
Kullanıcının Soyadı | ör. user.surname / user.lastName
|
email |
Kullanıcının E-posta Adresi | ör. user.email
|
Adım 5: EloView'de Kimlik Sağlayıcı Metadata'sını Yapılandırın
EloView 4, giriş son noktaları, çıkış son noktaları ve güvenlik sertifikalarının manuel olarak girilmesini ortadan kaldırmak için doğrudan metadata ithalatını kullanır:
- EloView 4 Portal'ınıza SAML Ayarları ekranında geri dönün.
- Düzenleme (Edit) modunda olduğunuzdan emin olun.
- Sayfanın sağ tarafında, bu iki yapılandırma seçeneğinden birini seçin:
- Seçenek A (Tavsiye Edilir): Kimlik Sağlayıcınızdan SAML Metadata bağlantısını Metadata URL alanına yapıştırın.
- Seçenek B: Eğer kimlik sağlayıcınız halka açık bir metadata URL'si sunmuyorsa, IdP'den metadata XML dosyasını yerel olarak indirin, Metadata Belgesi altında Dosya Seç'e tıklayın ve XML dosyasını yükleyin.
- Yapılandırmaları uygulamak için Uygula / Kaydet'e tıklayın.
Adım 6: Kullanıcıları Atayın ve Kimlik Doğrulamasını Test Edin
- Hedef kullanıcıların, kimlik sağlayıcınızdaki SAML uygulamasına atandığından emin olun.
- Doğru
elo_orgIdveelo_roledeğerlerinin kullanıcılar için yapılandırıldığını doğrulayın. - EloView SAML yapılandırma sayfasından SAML Giriş URL'sini kopyalayın.
- Bir gizli ya da özel tarayıcı penceresi açın ve kopyalanan URL'ye gidin.
- Kurumsal kimlik bilgilerinizi kullanarak kimlik doğrulaması yapın. Eğer başarılıysanız, otomatik olarak yönlendirileceksiniz ve EloView Cloud Portal'da oturum açacaksınız.
İsteğe Bağlı: Tek Çıkış (SLO) Yapılandırın
EloView 4, isteğe bağlı bir kimlik sağlayıcı oturum kapatma akışını (Tek Çıkış) destekler. Yapılandırıldığında, EloView'dan çıkış yapmak, kurumsal kimlik sağlayıcınızla güvenli bir oturum sona erdirmeyi koordine edebilir.
- Şuraya gidin: Hesap → Hesap Ayarları → SAML.
- Düzenleye tıklayın.
- Kimlik Sağlayıcı oturum kapatma akışını etkinleştir seçeneğini işaretleyin.
- Kaydet'e tıklayın.
- Gerekirse, kimlik sağlayıcınızdaki herhangi bir ek çıkış yapılandırmalarını tamamlayın veya hizmet sağlayıcı sertifikalarını (SAML ayarlar sayfasında mevcut) kaydedin.
Mevcut Bir Eski SAML Yapılandırmasını Taşımak
EloView 4, eski SAML yapılandırmalarını yeni özel SAML çerçevesine yükseltmeyi destekler.
- Yönetici hesabı ile EloView 4'te oturum açın.
- Şuraya gidin: Hesap → Hesap Ayarları → SAML.
- Eski SAML sayfasında, SAML'ı Yükselt seçeneğini seçin.
- Onaylamak için Evet butonuna tıklayın.
- Eski yapılandırma temizlendikten sonra, yukarıdaki standart Adım 1 ile Adım 6 talimatlarını izleyerek entegrasyonunuzu yeniden inşa edin.
SAML Kimlik Doğrulama Sorun Giderme
- Kullanıcılar giriş yapamıyor: SAML uygulamasının IdP'nizde etkin olduğunu ve Hedef Kitle (Varlık ID) ile ACS URL'sinin EloView ayarlarıyla tam olarak eşleştiğini kontrol edin. Metadata URL'sinin veya Belgesinin doğru ve erişilebilir olduğundan emin olun.
-
Girişte yanlış izinler: IdP’nizdeki
elo_roleözelliğinin, EloView Roller panelinden kopyalanan benzersiz alfasayısal Rol ID'si ile eşleştiğini doğrulayın, rolün görüntü adıyla değil. -
Kullanıcılar yanlış organizasyona yönlendiriliyor:
elo_orgIddeğerini gözden geçirin. IdP'nizde çok kiracılı yapılandırmaların kullanıcıları doğru organizasyona haritalandığından emin olun. -
Kullanıcı profil özellikleri boş:
firstName,lastNameveemailözelliklerinin uygun şekilde yapılandırıldığından ve büyük/küçük harf duyarlı olduğundan emin olun.
SSO (SAML) Girişleri için API Tokenı
SSO/SAML bağlantılarını kısıtlayan kuruluşların, entegrasyonlar için API kimlik doğrulaması gerektirmesi mümkündür. EloView, kullanıcı şifre kimlik doğrulaması olmadan güvenli erişim sağlayan API tokenlarını destekler.
İstemci kimlik bilgileri, kullanıcı profili üzerinden üretilir ve EloView DevZone API'si aracılığıyla kimlik doğrulama tokenları oluşturmak için kullanılır.
OAuth Kimlik Bilgileri Oluşturun
1\. Kullanıcı Profili'ne gidin ve OAuth Kimlik Bilgileri Oluştur'a tıklayarak İstemci ID ve İstemci Sırrı oluşturun.
- Not: Bu kimlik bilgilerini hemen kaydedin. Onaylandıktan sonra bir daha görünmeyecekler.
Bir Kimlik Doğrulama Tokenı Oluşturun
2\. DevZone API Kimlik Doğrulaması sayfasına gidin ve kimlik doğrulama tokenını oluşturmak için gerekli alanlara İstemci ID ve İstemci Sırrı girin (authPayload değeri).
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article