Yönetim
Çoklu oturum açma ve SCIM
Bir kuruluşun SAML 2.0 kimlik sağlayıcısını (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping) veya kendi barındırdığınız bir sunucunun Active Directory'sini doğrudan bağlayın, e-posta alan adlarını doğrulayın, çoklu oturum açmayı zorunlu kılın, grupları rollerle eşleyin ve hesapları SCIM 2.0 ile sağlayın.
Bu sayfada
Bir kuruluş, üyelerinin Holarch'ta iş hesaplarıyla oturum açmasını sağlayabilir. Holarch hizmet sağlayıcıdır; kuruluşunuzun kimlik sağlayıcısı (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity veya herhangi bir SAML 2.0 sağlayıcısı) kim olduklarını denetler. Kimlik sağlayıcı ayrıca SCIM 2.0 üzerinden Holarch hesaplarını oluşturabilir, güncelleyebilir ve devre dışı bırakabilir.
Çoklu oturum açma bir kuruluş yöneticisi tarafından Kuruluş ayarları → kuruluş → Erişim ve oturum açma → Çoklu oturum açma altında ayarlanır. Barındırılan hizmette ve kendi barındırdığınız sunucularda çalışır, masaüstü uygulamasında çalışmaz. Kendi barındırdığınız bir sunucu, bir alan adını doğrulamak (DNS sorgusu) ve bir URL'den meta veri okumak için dışa doğru erişime ihtiyaç duyar. Kendi barındırdığınız bir sunucu şirket hesaplarını kimlik sağlayıcı olmadan, Active Directory veya başka bir LDAP diziniyle kendisi de denetleyebilir: bkz. Şirket dizini (Active Directory / LDAP).
Not: çoklu oturum açma ve SCIM hazırlama (kuruluşun) Team planının parçasıdır. Bunları 2.29.0 sürümünden önce kullanan kuruluşlar korur. Plan olmadan ayarlar saklanır, ancak üyeler parolalarıyla (Parolanızı mı unuttunuz? bir parola belirler), Google veya Microsoft ile oturum açar ve SCIM istekleri reddedilir.
Kavramlar
| Terim | Anlamı |
|---|---|
| Doğrulanmış alan adı | Kuruluşun bir DNS TXT kaydıyla denetlediğini kanıtladığı bir e-posta alan adı (example.com gibi). Çoklu oturum açma ve SCIM yalnızca doğrulanmış alan adlarındaki adresler için çalışır. Bir alan adı tek bir kuruluş tarafından doğrulanabilir. |
| Kimlik sağlayıcı (IdP) | Üyelerinizin oturumunu açan hizmet: varlık kimliği (yayımlayan), oturum açma URL'si ve imzalama sertifikası. |
| Hizmet sağlayıcı (SP) | Bu kuruluş için Holarch. Her kuruluşun kendi varlık kimliği, ACS URL'si ve meta veri URL'si vardır. |
| Yönetilen üyeler | E-posta adresi doğrulanmış bir alan adında bulunan ve kuruluş yöneticisi olmayan kuruluş üyeleri. Çoklu oturum açmayı zorunlu kıl onlara uygulanır. |
| SCIM belirteci | Kimlik sağlayıcının bu kuruluş için Holarch'ın SCIM API'sini çağırmak üzere kullandığı bir gizli anahtar. Bir kişiye bağlı değildir. |
Nasıl kullanılır
Bir e-posta alan adını doğrulama
- Kuruluş ayarları sayfasını açın, kuruluşu seçin, Erişim ve oturum açma grubunu açın ve Çoklu oturum açma bölümünü bulun.
- E-posta alan adları altında üyelerinizin adreslerinin alan adını girin ve Alan adı ekle seçeneğini seçin.
- Gösterilen TXT kaydını yayımlayın:
holarch-domain-verification=…değeriyle_holarch-challenge.<domain>adı. - Kontrol et seçeneğini seçin. DNS değişikliklerinin ulaşması birkaç dakika sürebilir; alan adı Doğrulandı gösterene kadar yeniden kontrol edin.
Üyelerinizin kullandığı her alan adını ekleyin (örneğin example.com ve eng.example.com). Kuruluş başına en fazla 20 alan adı.
Kimlik sağlayıcıyı bağlama
- Kimlik sağlayıcınızda, Holarch'ta Kimlik sağlayıcı altındaki değerlerle bir SAML 2.0 uygulaması oluşturun (aşağıdaki sağlayıcı bölümlerine bakın):
- Varlık kimliği (hedef kitle):
https://app.holarch.app/api/auth/saml/<organization id>/metadata - ACS URL'si (yanıt URL'si):
https://app.holarch.app/api/auth/saml/<organization id>/acs - Meta veri URL'si: varlık kimliğiyle aynı; SP meta verisini içe aktaran sağlayıcılar bunu kullanabilir.
- Varlık kimliği (hedef kitle):
- Sağlayıcının meta veri XML'ini veya meta veri URL'sini üstteki kutuya kopyalayın ve Meta veriyi oku seçeneğini seçin. Holarch varlık kimliğini, oturum açma URL'sini ve sertifikayı doldurur. Ya da bunları kendiniz girin.
- Öznitelikler ve roller altında, sağlayıcınız alışılmadık adlar kullanıyorsa öznitelik adlarını (bkz. Öznitelikler), Yeni üyelerin rolü ayarını ve isteğe bağlı Gruplardan rollere eşlemesini ayarlayın.
- Kimlik sağlayıcıyı kaydet seçeneğini seçin ve parolanızı girin.
Çoklu oturum açmayı açma
- Bu kuruluş için çoklu oturum açma kutusunu işaretleyin. Kaydedilmiş bir kimlik sağlayıcı ve doğrulanmış bir alan adı gerektirir.
- Üyelere Üyeler için oturum açma bağlantısı verin veya oturum açma ekranında Çoklu oturum açma ile oturum açın seçeneğini seçip iş e-posta adreslerini girmelerini söyleyin.
- Önce bir üyeyle deneyin.
Bir üyenin ilk oturum açışında Holarch hesabı oluşturur (onaylı, parolasız) ve kaydolma bir davet gerektirse bile onu kuruluşa ekler. O adrese sahip bir hesap varsa çoklu oturum açma ona bağlanır ve sahibi bir e-posta alır.
Çoklu oturum açmayı zorunlu kılma
Çoklu oturum açma çalıştıktan sonra Doğrulanmış alan adlarındaki üyeler için çoklu oturum açmayı zorunlu kıl kutusunu işaretleyin.
- Yönetilen üyeler bundan sonra yalnızca kimlik sağlayıcı üzerinden oturum açar. Parola, geçiş anahtarı, Google ve Microsoft ile oturum açma, kuruluşun çoklu oturum açmayı zorunlu kıldığını oraya giden bir düğmeyle yanıtlar. Diğer oturum açma yöntemlerinden gelen mevcut oturumları hemen sona erer.
- Kuruluş yöneticileri için zorunlu değildir: bozuk bir kimlik sağlayıcı ayarını düzeltebilmeleri için (acil durum erişimi) iki adımlı oturum açmayla parolalarını veya geçiş anahtarlarını korurlar. En az iki kuruluş yöneticisi tutun.
- Adresi doğrulanmış alan adlarının dışında olan üyeler (dış ortak çalışanlar) etkilenmez.
- Parola sıfırlama yeni parolayı yine belirler ancak üyenin oturumunu açmaz; üye bundan sonra kimlik sağlayıcı üzerinden oturum açar.
- Yönetilen üyelerin API belirteçleri ve bağlı uygulamaları çalışmaya devam eder. Bunları sonlandırmak için hesabı SCIM üzerinden devre dışı bırakın.
SCIM ile hesap hazırlama
- Hazırlama (SCIM 2.0) altında SCIM belirteci oluştur seçeneğini seçin ve parolanızı girin.
- Belirteci ve Temel URL'yi (
https://app.holarch.app/scim/v2) kimlik sağlayıcınızın hazırlama ayarlarına kopyalayın. Holarch belirteci bir kez gösterir. - Sağlayıcıda kullanıcıları oluşturma, güncelleme ve devre dışı bırakmayı açın.
Kuruluş başına en fazla 5 belirteç. İptal et bir belirteci hemen sonlandırır.
Kimlik sağlayıcının sertifikası değiştiğinde
- Yeni sertifikayı eskisinin altına yapıştırın (iki sertifikaya izin verilir) ve kaydedin.
- Sağlayıcıyı yeni sertifikaya geçirin.
- Eski sertifikayı kaldırın ve yeniden kaydedin.
Sertifika listesi her sertifikanın konusunu, son kullanma tarihini ve parmak izini gösterir.
Birden fazla kuruluş için şirket oturum açması (kendi sunucunuzda)
Bir e-posta alan adı tek bir kuruluşa aittir. Bir şirket kendi barındırdığı bir sunucuda departman başına bir kuruluş işlettiğinde, bir kuruluş (genellikle BT'ninki) şirket alan adını doğrular, kimlik sağlayıcıyı bağlar ve çoklu oturum açmayı açar. Diğer kuruluşlar ardından kimlik sağlayıcı gruplarını kendi rolleriyle eşler:
- Departmanın Kuruluş ayarları → Erişim ve oturum açma → Çoklu oturum açma bölümünde Şirket oturum açma kısmını bulun. Burada şirket oturum açmasını işleten kuruluşun adı yer alır.
- Gruplardan rollere altında her satıra bir eşleme yazın, örneğin
packs-engineers = membervepacks-leads = admin, ve Grupları Kaydet seçeneğini seçin. - İsteğe bağlı: grubun departman projelerine erişimini virgülden sonra ekleyin, örneğin
packs-contractors = member, viewer. Bkz. Departman projelerine erişim.
Şirket oturum açması üzerinden yapılan her oturum açmada, eşlenmiş bir gruptaki kişi o kuruluşa o rolle katılır veya orada kuruluş yöneticisi olur. Oturum açma hiçbir zaman kimseyi çıkarmaz veya düşürmez (SCIM grupları bunu yapabilir: bkz. SCIM grupları ve departmanlar); kuruluş yöneticileri kişileri Kuruluş ayarlarında çıkarır. Kimlik sağlayıcı grupları göndermelidir (şirket oturum açmasının Gruplar özniteliği).
Şirket oturum açmasını işleten kuruluşun kuruluş yöneticileri, alan adının her adresi için oturum açmayı denetler. Bu kuruluşu kimlik sağlayıcıyı işleten kişilerle sınırlı tutun.
Departman projelerine erişim (kendi sunucunuzda)
Her grup eşlemesi, kişilerinin bütün kuruluşla paylaşılan projelerde (Paylaş → Kuruluşlar) ne kadar erişim alacağını da belirtebilir: viewer, reviewer veya editor (varsayılan). Bir kişinin böyle bir projedeki rolü, paylaşımın rolü ile oradaki eşlenmiş gruplarının en yüksek erişiminden düşük olanıdır. Örneğin Düzenleyici olarak paylaşılmış bir projede ve packs-contractors = member, viewer ile bir yüklenici projeyi görüntüler; hem packs-contractors hem de packs-engineers = member içinde olan biri projeyi düzenler. Kural, gruplar nereden gelirse gelsin geçerlidir: şirket çoklu oturum açması, SCIM grupları ve şirket dizini. Bir kişiyle doğrudan paylaşılan projeler etkilenmez ve elle eklenmiş bir üye (eşlenmiş hiçbir grupta değil) paylaşımın rolünü alır. Bir grubun erişimini değiştirmek, grubun yerleştirdiği herkese hemen uygulanır.
Düzenleyici koltukları. Lisans düzenleyicileri sınırlar; görüntüleyiciler ve inceleyiciler ücretsizdir. Bir grubun Düzenleyici erişimi birini düzenleyici yapacakken boş koltuk yoksa o kişi bunun yerine Görüntüleyici olur ve oturum açma yine çalışır. Kuruluş ayarları ve Yönetici → Şirket dizini kaç kişinin Görüntüleyici'de tutulduğunu gösterir; Şirket dizini sayfası koltuğu bir gruptan gelen her düzenleyiciyi ve tutulan her kişiyi listeler. Koltuklar boşaldığında tutulan kişiler bir sonraki denetimde, en eski üyelikten başlayarak Düzenleyici olur.
Kapalı ağdaki sunucular. Sunucu genel DNS'te sorgulama yapamadığında bir site yöneticisi, TXT kaydını yayımlamak yerine doğrulanmamış bir alan adının yanındaki Doğrulandı Olarak İşaretle seçeneğini seçebilir. Alan adı yine yalnızca tek bir kuruluşa aittir ve değişiklik denetim günlüğüne kaydedilir.
Oturum açma kuralları
Holarch kimlik sağlayıcıdan gelen her yanıtı sıkı biçimde denetler. Şu durumlarda oturum açma reddedilir:
- onay, yapılandırılmış bir sertifikayla imzalanmamışsa veya SHA-1 ile imzalanmışsa;
- yayımlayan, hedef kitle (kuruluşun varlık kimliği), hedef veya alıcı (ACS URL'si) eşleşmiyorsa;
- onay henüz geçerli değilse veya süresi dolmuşsa (2 dakikalık saat farkına izin verilir);
- aynı tarayıcıda başlatılmamış bir oturum açmayı veya zaten kullanılmış birini yanıtlıyorsa (her oturum açma bir kez başlar ve 10 dakika sonra sona erer);
- aynı onay ikinci kez gelirse (yeniden oynatma);
- e-posta adresi eksikse veya kuruluşun doğrulanmış alan adlarının dışındaysa;
- hesap devre dışıysa.
Oturum açma ekranı bu durumda neyin yanlış gittiğini söyler ve kuruluşun denetim günlüğü bunu auth.sso-failed olarak kaydeder.
Kimlik sağlayıcının portalından oturum açma (IdP tarafından başlatılan; üyeler sağlayıcının uygulama panosundan başladığında), böyle bir yanıt tarayıcının başlattığı bir oturum açmaya bağlı olmadığı için varsayılan olarak kapalıdır. Kimlik sağlayıcının portalından oturum açmaya izin ver seçeneğini yalnızca üyelerinizin buna ihtiyacı olduğunda açın. Yeniden oynatma koruması ve diğer tüm denetimler yine geçerlidir.
İki adımlı oturum açma
Varsayılan olarak çoklu oturum açma ilk adımdır. İki adımlı oturum açması açık olan hesaplar yine bir geçiş anahtarını veya kodu onaylar ve kuruluşun İki adımlı oturum açmayı zorunlu kıl ayarı üyelerden bunu yine ister.
Kimlik sağlayıcının çok faktörlü oturum açmasına güven açıkken, onayı çok faktörlü kimlik doğrulama bildiren bir oturum açma Holarch'ın ikinci adımına ihtiyaç duymaz ve o oturum için bu kuruluşun iki adım gereksinimini karşılar (diğer kuruluşlarınkini değil). Holarch şu kimlik doğrulama bağlamlarını çok faktörlü olarak kabul eder:
| Kimlik doğrulama bağlamı | Gönderen |
|---|---|
https://refeds.org/profile/mfa | Bunun için yapılandırıldığında birçok sağlayıcı |
http://schemas.microsoft.com/claims/multipleauthn | Microsoft Entra ID |
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (ve …MobileTwoFactorUnregistered) | Okta ve diğerleri |
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncToken | Tek kullanımlık kod |
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard ve …SmartcardPKI | Akıllı kartlar |
Entra ID'nin multipleauthn içeren http://schemas.microsoft.com/claims/authnmethodsreferences talebi de sayılır. Kimlik sağlayıcıda yalnızca parolayla yapılan bir oturum açma, güven açık olsa bile çok faktörlü değildir.
Öznitelikler
| Holarch | Varsayılan öznitelik adları (bulunan ilki kullanılır) |
|---|---|
| E-posta (zorunlu) | email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, bir e-posta adresi olduğunda NameID veya aksi halde UPN talebi (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn) |
| Ad | displayName, name, http://schemas.microsoft.com/identity/claims/displayname, WS-Federation name talebi ya da ad ve soyad (givenName/firstName, sn/surname/lastName ve bunların talep biçimleri) |
| Gruplar | Gruplar özniteliği içinde adlandırdığınız öznitelik, örneğin groups. Hiçbiri adlandırılmamışsa: groups, memberOf, Role, AD FS'nin http://schemas.xmlsoap.org/claims/Group, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid ve …/claims/groups |
Hesap, kimlik sağlayıcının NameID'si (kalıcı, e-posta, Windows etki alanı nitelikli ad veya başka bir biçim) ile bulunur. NameID olmadan (AD FS, bir talep kuralı bunu vermedikçe NameID göndermez) hesabı e-posta adresi tanımlar. NameID değişip e-posta adresi aynı kaldığında hesap yeniden bağlanır.
Grup adları büyük/küçük harf ayrımı yapılmadan karşılaştırılır. CORP\Packs Engineers gibi etki alanı nitelikli bir ad, Packs Engineers için yazılmış bir eşlemeyle de eşleşir ve bir grup SID'si (S-1-5-21-…) o SID ile yazılmış bir eşlemeyle eşleşir.
Gruplardan rollere
Satır başına bir eşleme yazın: holarch-admins = admin veya engineering = member. Her oturum açışta admin ile eşlenmiş bir gruptaki üye kuruluş yöneticisi olur; aksi halde eşlenmiş bir gruptaki üye üye olur. Hiçbir eşlenmiş grupta olmayan üyeler rollerini korur. Son kuruluş yöneticisinin rolü asla düşürülmez.
SCIM
SCIM API, Authorization: Bearer hsc_… ile https://app.holarch.app/scim/v2 adresinde RFC 7643 ve RFC 7644'e uyar.
| Uç nokta | Ne yapar |
|---|---|
GET /ServiceProviderConfig, /ResourceTypes, /Schemas | Hizmeti tanımla |
GET /Users | Kuruluşun hazırlanmış kullanıcılarını ve doğrulanmış alan adlarındaki üyelerini listele; userName, externalId, id, emails.value veya emails[type eq "work"].value üzerinde eq ile filter; startIndex ve count |
POST /Users | Bir kullanıcı oluştur (veya o adrese sahip mevcut bir hesabı bağla) ve onu kuruluşa ekle |
GET, PUT, PATCH /Users/<id> | Bir kullanıcıyı oku, değiştir veya güncelle: userName, name, displayName, emails, externalId, active |
DELETE /Users/<id> | Kullanıcıyı devre dışı bırak ve dış kimliği unut |
/Groups | Kendi barındırdığınız sunucular: grupları listeleme, oluşturma, okuma, değiştirme, güncelleme (members, displayName, externalId üzerinde, Okta ve Microsoft Entra ID biçimlerinde PATCH) ve silme; displayName, externalId veya id üzerinde eq ile filter; excludedAttributes=members. Bkz. SCIM grupları ve departmanlar. Barındırılan hizmet: boş bir liste, değişiklikler reddedilir; bunun yerine grupları çoklu oturum açma altında rollere eşleyin. |
- Yalnızca kuruluşun doğrulanmış alan adlarındaki adresler oluşturulabilir veya değiştirilebilir.
- Devre dışı bırakma (
active: falseveyaDELETE) kişiyi kuruluştan kaldırır, hesabı devre dışı bırakır, tüm oturumlarını sonlandırır ve API belirteçlerini ve bağlı uygulamalarını iptal eder. Yeniden etkinleştirme hesabı etkinleştirir ve kuruluş rolünü geri yükler. Holarch'ın devre dışı bıraktığı bir hesap (örneğin kötüye kullanımdan sonra) devre dışı kalır. - Kurumsal uzantı öznitelikleri kabul edilir ve yok sayılır.
- Her belirteç dakikada 600 istek yapabilir. Her değişiklik kuruluşun denetim günlüğüne kaydedilir (scim.create, scim.deactivate vb.).
SCIM grupları ve departmanlar (kendi sunucunuzda)
Kendi barındırdığınız bir sunucuda kimlik sağlayıcı gruplarını, şirket alan adına sahip kuruluşun SCIM uç noktasına gönderebilir. Departmanların Şirket oturum açma altındaki Gruplardan rollere eşlemeleri ardından kimin hangi departmana hangi rolle ait olduğuna karar verir. Tek bir eşleme her ikisine de hizmet eder: şirketin çoklu oturum açması üzerinden oturum açma ve SCIM grupları.
- Eşlenmiş bir gruba eklenen kişi o kuruluşa eşlenen rolle katılır; grup değişikliği rolü değiştirir.
- Eşlenmiş tüm gruplardan çıkarılan kişi, grupların kendisini eklediği kuruluşlardan ayrılır.
- Başka bir yolla eklenen üyelikler (bir kuruluş yöneticisi, bir davet, bir içe aktarma veya bir oturum açma ile) gruplar tarafından hiçbir zaman kaldırılmaz veya düşürülmez; gruplar bunları yalnızca kuruluş yöneticisine yükseltebilir. Bir kuruluş yöneticisi bir üyenin rolünü elle değiştirdiğinde üyelik o andan itibaren ona ait olur.
- Bir kuruluşun son kuruluş yöneticisi hiçbir zaman kaldırılmaz veya düşürülmez.
- Bir departmanın Gruplardan rollere eşlemesini değiştirmek, gruplardaki herkese hemen uygulanır.
- Grup üyeleri bu belirtecin sağladığı veya yönettiği kullanıcılar olmalıdır; diğer kimlikler yok sayılır.
- Bir kullanıcıyı devre dışı bırakmak eskisi gibi çalışır; departmanları gruplarını izler.
- Her değişiklik kaydedilir: şirket kuruluşunun denetim günlüğünde scim.group-create, scim.group-update ve scim.group-delete, departmanın günlüğünde de her üyelik değişikliği.
Kimlik sağlayıcınızı ayarlama
Okta
- Applications → Create App Integration → SAML 2.0.
- Single sign-on URL: ACS URL'si. Use this for Recipient URL and Destination URL işaretli kalsın. Audience URI (SP Entity ID): varlık kimliği.
- Name ID format:
EmailAddressveyaPersistent. Application username: Email. - Attribute statements:
email→user.email,displayName→user.displayName. Group attribute statements (isteğe bağlı):groups, gerektiği gibi filtreleyin. - Bitirin, ardından Sign On sekmesindeki Metadata URL değerini Holarch'a kopyalayın ve Meta veriyi oku seçeneğini seçin.
- SCIM için: uygulamanın General sekmesinde SCIM provisioning seçeneğini etkinleştirin; Provisioning içinde SCIM connector base URL Temel URL'dir, Unique identifier field
userName, Authentication Mode SCIM belirteciyle HTTP Header; Create Users, Update User Attributes ve Deactivate Users seçeneklerini etkinleştirin.
Microsoft Entra ID
- Enterprise applications → New application → Create your own application (galeri dışı), ardından Single sign-on → SAML.
- Identifier (Entity ID): varlık kimliği. Reply URL (Assertion Consumer Service URL): ACS URL'si.
- Attributes & Claims: varsayılan
emailaddresstalebi çalışır; grupları eşliyorsanız bir grup talebi ekleyin. - SAML Certificates altında App Federation Metadata Url değerini Holarch'a kopyalayın ve Meta veriyi oku seçeneğini seçin.
- Entra'nın çok faktörlü oturum açmasına güvenmek için uygulama için bir Conditional Access ilkesinde MFA'yı zorunlu kılın; Entra bu durumda
multipleauthngönderir. - SCIM için: Provisioning → Automatic; Tenant URL Temel URL'dir, Secret Token SCIM belirtecidir. Test Connection, ardından hazırlamayı başlatın.
Microsoft AD FS
AD FS (Active Directory Federation Services, Windows Server 2016 veya üzeri), şirket içi Active Directory'nizdeki kişilerin oturumunu açar. AD FS Management konsolunda:
- Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online seçin ve Holarch'ın Meta veri URL'si değerini girin. AD FS sunucusu Holarch'a ulaşamıyorsa meta veriyi dosya olarak kaydedin ve Import data about the relying party from a file seçin. Display name: Holarch.
- Access control policy: Permit everyone veya Permit everyone and require MFA (bkz. 6. adım).
- Güvenin Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims penceresini açın, öznitelik deposu Active Directory:
| LDAP özniteliği | Giden talep türü |
|---|---|
| E-Mail-Addresses | E-Mail Address |
| Display-Name | Ad |
| Token-Groups – Unqualified Names | Grup |
İki etki alanında aynı adlı gruplar varsa bunun yerine Token-Groups – Qualified by Domain Name; grup adları değişiyorsa Token-Groups as SIDs (talep türü Group SID) kullanın. Holarch Group, Role ve Group SID taleplerini Gruplar özniteliği olmadan okur.
AD FS her grubun görünen adını veya cn değerini değil, pre-Windows 2000 name adını (sAMAccountName) gönderir ve birincil grubu (genellikle Domain Users) da dahil eder. Grupları bu adla veya SID ile eşleyin. Şirket dizini bağlı bir sunucuda Yönetici → Şirket dizini → Kullanıcı test et bir kişinin her grubu için ikisini de listeler.
- İsteğe bağlı, kararlı bir NameID: Add Rule → Transform an Incoming Claim, gelen E-Mail Address (veya UPN), giden Name ID, biçim Email (veya Persistent Identifier). Bu olmadan Holarch hesabı e-posta adresiyle tanımlar.
- Güvenin Properties → Advanced sekmesinde SHA-256 değerini koruyun. Encryption sekmesini boş bırakın: Holarch onayların şifresini çözmez ve bağlantı https'dir. AD FS onayı varsayılan olarak imzalar (
SamlResponseSignatureAssertionOnly); Holarch bunu gerektirir. https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xmladresini Holarch'ın Meta veri URL'si alanına kopyalayın ve Meta veriyi oku seçeneğini seçin. Bu; varlık kimliğini (http://<host>/adfs/services/trust), oturum açma URL'sini (https://<host>/adfs/ls/) ve belirteç imzalama sertifikasını doldurur. AD FS'nin çok faktörlü oturum açmasına güvenmek için erişim denetimi ilkesinde MFA'yı zorunlu kılın ve Kimlik sağlayıcının çok faktörlü oturum açmasına güven seçeneğini açın; AD FS ardındanhttp://schemas.microsoft.com/claims/multipleauthngönderir.
Kendi barındırdığınız bir sunucuda meta veri URL'si bir iç adres (https://adfs.corp.example.com/…, özel bir IP) olabilir ve sertifikası sistemin güvenilen CA'larının yanı sıra tls/ldap-ca.pem içindeki şirket CA'sına göre de denetlenir. AD FS'nin belirteç imzalama sertifikası her yıl yenilenir: Holarch son geçerlilik tarihini gösterir; AD FS yenisini eklediğinde Meta veriyi oku işlemini yeniden yapın (çakışma süresince ikisi de tutulur). AD FS'de SCIM yoktur; kendi barındırdığınız bir sunucuda şirket dizini varsa Holarch hesapları kendisi denetler (aşağıda).
Google Workspace
- Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
- IdP metadata verisini kopyalayın (indirin, ardından XML'i Holarch'a yapıştırın).
- ACS URL: ACS URL'si. Entity ID: varlık kimliği. Name ID format:
EMAIL, Name ID: Basic Information › Primary email. - Attribute mapping: Primary email →
email; First name →givenName; Last name →sn. Group membership →groups(isteğe bağlı). - Uygulamayı ON for everyone olarak açın (veya bir kuruluş birimi için).
- Google Workspace bir MFA kimlik doğrulama bağlamı göndermez; Kimlik sağlayıcının çok faktörlü oturum açmasına güven seçeneğini kapalı bırakın. Google'ın SCIM hazırlaması yalnızca galeri uygulamalarıyla çalışır; bunun yerine hesapları çoklu oturum açmayla oluşturun.
Ping Identity
- PingOne: Applications → Add Application → SAML Application (PingFederate: bir SP bağlantısı).
- Holarch'ın Meta veri URL'si değerini içe aktarın veya ACS URL ve Entity ID değerlerini girin.
- Attribute mapping:
saml_subject→ Email Address;emailvedisplayNameekleyin. - IdP meta veri URL'sini Holarch'a kopyalayın ve Meta veriyi oku seçeneğini seçin.
- SCIM için: bir SCIM bağlantısıyla PingOne hazırlaması; Temel URL ve SCIM belirteciyle OAuth 2 Bearer Token kimlik doğrulaması.
Şirket dizini (Active Directory / LDAP)
Kendi barındırdığınız bir sunucuda kişiler, şirket dizini tarafından denetlenen şirket kullanıcı adları ve parolalarıyla oturum açabilir: Active Directory (etki alanı denetleyicileri) veya OpenLDAP ya da FreeIPA gibi başka bir LDAP dizini. Kimlik sağlayıcı gerekmez. Bir site yöneticisi bunu Yönetici → Şirket dizini içinde kurar; sunucunun .env dosyası başlangıç değerlerini verebilir (HOLARCH_LDAP_*, kendi sunucunuzda kurulum teslimatındaki SIGN-IN.md). Barındırılan hizmette sunulmaz.
Şirket dizinini kurun
Önce Yönetici → Şirket dizini sayfasının üstünden Dizin türü seçin: Active Directory veya Diğer LDAP dizini (OpenLDAP, FreeIPA, …). Her iki durumda da tek bir bağlantıdır; tür, hangi grup aramalarının sunulacağını, Active Directory varsayılanlarını kullan veya LDAP varsayılanlarını kullan düğmelerinin forma hangi değerleri koyacağını, ayrıca ipuçlarını ve örnekleri belirler. Türü değiştirmek, hâlâ diğer türün varsayılanında olan kullanıcı filtresini veya grup aramasını değiştirir, kendi yazdığınız filtreyi korur. Sayfa türü kayıtlı ayarlardan çıkarır (iç içe gruplar veya bir Active Directory filtresi Active Directory anlamına gelir).
- Dizinde bir salt okunur hizmet hesabı oluşturun (örneğin
svc-holarch). Adını Bağlama hesabı alanına, parolasını sunucunun.envdosyasınaHOLARCH_LDAP_BIND_PASSWORDolarak yazın, ardından sunucuyu yeniden başlatın. Parola Yönetici sayfasında hiçbir zaman gösterilmez. - Dizin sunucuları altında her etki alanı denetleyicisini veya LDAP sunucusunu
ldaps://dc1.corp.example.com(bağlantı noktası 636) biçiminde, satır başına bir tane girin; sırayla denenirler.ldap://host:389yalnızca ldap:// adreslerinde StartTLS kullan açıkken çalışır. Düz LDAP reddedilir; böylece parola ağı hiçbir zaman şifrelenmeden geçmez. Her sunucunun ana bilgisayar adını sertifikasında göründüğü gibi kullanın. - Sunucuların sertifikalarını veren CA'nın sertifikasını CA sertifikası (PEM) alanına veya sunucuda
tls/ldap-ca.pemiçine koyun. Boş bırakılırsa sistemin güvenilen CA'ları kullanılır. - Temel DN (
DC=corp,DC=example,DC=comveya başka bir LDAP dizinindedc=example,dc=com) ve İzin verilen e-posta alan adları değerlerini girin. - Bağlantıyı test et seçeneğini seçin. Formdaki değerlerle kaydetmeden bağlanır ve bir şey başarısız olduğunda sorunu belirtir (hiçbir sunucu yanıt vermedi, sertifika, bağlama hesabı, temel DN).
- Kullanıcı test et altında oturum açmanın ne bulacağını görmek için bir kullanıcı adı girin: e-posta adresi, hesabın etkin olup olmadığı, grupları ve katılacağı kuruluşlar. Parola isteğe bağlıdır; bir kez denetlenir ve hiçbir zaman saklanmaz.
- Şirket hesaplarıyla oturum açmaya izin ver seçeneğini açın ve Kaydet seçeneğini seçin. Oturum açma ekranı ardından Şirket hesabıyla oturum açın (veya Düğme metni içindeki metniniz) gösterir.
Active Directory: varsayılan Kullanıcı filtresi etkin kullanıcıları sAMAccountName, userPrincipalName veya mail ile bulur; böylece kişiler jsmith, [email protected] veya CORP\jsmith yazabilir. Devre dışı hesaplar dışarıda bırakılır. Grup arama, Active Directory, iç içe gruplarla (varsayılan) ve memberOf özniteliği (yalnızca doğrudan gruplar) seçeneklerini sunar.
Diğer LDAP dizini: LDAP varsayılanlarını kullan, Kullanıcı filtresi alanına (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) koyar; böylece kişiler uid veya e-posta adreslerini yazar. Yazılan adın geleceği yerde {username} bulunan her filtre çalışır. Grup arama, memberOf özniteliği (memberof overlay'li OpenLDAP, FreeIPA, 389 Directory Server) ve Kişiyi üye olarak listeleyen gruplar (groupOfNames ve groupOfUniqueNames; Grup temel DN'si nerede olduklarını belirtir) seçeneklerini sunar. İç içe gruplar sayılmaz.
Dizin gruplarından departmanlar
Dizin grupları kişileri, SAML ile aynı Şirket oturum açma altındaki Gruplardan rollere eşlemeleriyle kuruluşlara yerleştirir (bkz. Birden fazla kuruluş için şirket oturum açması): her kuruluşun Çoklu oturum açma kutusunda grupları rollerle eşleyin, örneğin Packs Engineers = member ve Packs Leads = admin. Adlar büyük/küçük harf ayrımı yapılmadan karşılaştırılır; bir grubun DN'si ve Active Directory'de SID'si de çalışır. Active Directory, iç içe gruplarla, bir grubun içindeki başka gruplar üzerinden o grupta bulunan kişiyi de sayar.
Her oturum açmada ve her düzenli denetimde, eşlenmiş bir gruptaki kişi o kuruluşa o rolle ve grubun departman projelerine erişimiyle katılır. Dizinin verdiği bir üyelik, kişi ona eşlenen tüm gruplardan ayrıldığında kaldırılır; elle eklenen üyelikler kalır (dizin orada bir üyeyi kuruluş yöneticisine yükseltebilir, ancak hiçbir zaman düşürmez). Son kuruluş yöneticisi hiçbir zaman kaldırılmaz.
Kimler oturum açabilir
- Hesap dizinde etkin olmalıdır: devre dışı, kilitli ve süresi dolmuş hesaplar reddedilir; parolasının süresi dolmuş veya bir sonraki oturum açmada değiştirilmesi gereken hesaplar da.
- Dizin kaydında izin verilen bir alan adında bir e-posta adresi olmalıdır. İlk oturum açma Holarch hesabını oluşturur veya o adrese sahip mevcut hesabı bağlar. Farklı bir dizin kaydına zaten bağlı bir hesap devralınmaz.
- Bağlı hesaplar için şirket oturum açmasını zorunlu kıl, bağlı hesapların Holarch parolasıyla oturum açmasını engeller. Site yöneticileri parolalarını korur; böylece bir dizin kesintisi hiçbir zaman herkesi dışarıda bırakmaz.
- Yanlış parolalar, adın hangi biçimi yazılmış olursa olsun (
jsmith,[email protected],CORP\jsmith), Duraklamadan önceki başarısız deneme sayısı (varsayılan 3) aşıldıktan sonra o şirket hesabı için oturum açmayı 15 dakika duraklatır. Holarch'ın bir şirket hesabını hiçbir zaman kilitlememesi için bu değeri etki alanının kilitleme eşiğinin altında tutun. Bilinmeyen kullanıcı adları ve yanlış parolalar aynı yanıtı, yaklaşık aynı sürede alır.
Düzenli denetim
Hesapları şu aralıkla denetle ayarında belirtilen aralıkla (varsayılan 15 dakika) sunucu, oturumu açık olan veya dizin üyeliklerine sahip her bağlı hesabı sorgular. Devre dışı bırakılan, kilitlenen, dizinden çıkarılan veya parolasının süresi dolmuş ya da bir sonraki oturum açmada değiştirilmesi gereken (çoğunlukla şüpheli bir ele geçirme sonrası yöneticinin yaptığı bir sıfırlama) kişinin oturumu her yerde kapatılır ve dizinin verdiği üyelikleri kaybeder; grup değişiklikleri üyelikleri günceller. Kilitlenen bir hesap, kilidi açıldıktan sonraki ilk oturum açmasında üyeliklerini geri alır. Dizine ulaşılamadığında hiçbir şey değişmez. Denetlenen hesapların çoğu eksik olduğunda (örneğin yanlış bir temel DN sonrasında) hiçbir şey sonlandırılmaz ve Yönetici sayfası uyarıyı gösterir. Şimdi denetle denetimi hemen çalıştırır. Yönetici sayfası son denetimin sonucunu gösterir.
Her denetim ayrıca eşlenmiş her grubun üyelerini sorgular (iç içe gruplar Active Directory, iç içe gruplarla ile sayılır) ve henüz hesabı olmayan kişiler için oturum açmayla aynı kurallar altında (etkin, izin verilen bir e-posta alan adı, başka yere bağlı bir hesabın devralınmaması) hesap kurar. E-posta gönderilmez; kişi Holarch'a ilk ihtiyaç duyduğunda şirket hesabıyla oturum açar ve zaten departmanlarındadır; böylece projeler bundan önce onunla paylaşılabilir. Bir denetim en fazla 200 hesap kurar; Yönetici sayfası kaç tanesinin bir sonraki denetimi beklediğini gösterir. Yalnızca SID ile adlandırılan gruplar bu şekilde sorgulanmaz; kişileri oturum açmada yerleştirilir.
Şirket diziniyle iki adımlı oturum açma
Şirket oturum açması ilk adımdır. İki adımlı oturum açmayı zorunlu kılan kuruluşlar yine Holarch'ın ikinci adımını (bir geçiş anahtarı veya kod) ister ve iki adımlı oturum açması açık olan hesaplar yine bunu onaylar. Şirket oturum açmasını iki adımlı oturum açma say seçeneğini yalnızca şirket hesabının kendisi ikinci bir faktör gerektiriyorsa açın; bu durumda o oturum için her kuruluşun iki adımlı oturum açma zorunluluğunu karşılar.
Her dizin oturum açması, reddi ve ayar değişikliği denetim günlüğünde (admin.directory-save, admin.directory-test, directory.account-ended) ve her hesabın oturum açma kayıtlarında yer alır. Parolalar hiçbir zaman kaydedilmez.
Sınırlar ve güvenlik notları
Sınır: çoklu oturum açma, kimlik sağlayıcıya HTTP-Redirect bağlamasını ve Holarch'a geri dönüşte HTTP-POST'u kullanır. İmzalı ve şifreli kimlik doğrulama istekleri, şifreli onaylar ve tekli oturum kapatma desteklenmez. SCIM grupları yalnızca kendi barındırdığınız sunucularda desteklenir (SCIM grupları ve departmanlar). Şirket dizini kullanıcı adı ve parolayla oturum açar (TLS üzerinden basit bağlama); Kerberos ve Windows tümleşik oturum açma desteklenmez.
- Ayar değişiklikleri yakın zamanda yapılmış bir parola doğrulaması gerektirir, tüm kuruluş yöneticilerine e-postayla bildirilir ve denetim günlüğüne kaydedilir (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
- Meta veri URL'leri genel internette https kullanmalıdır (kendi barındırdığınız bir sunucuda iç adreslere de izin verilir); Holarch bunları Meta veriyi oku seçeneğini seçtiğinizde bir kez getirir.
- SCIM belirteçleri yalnızca karma değer olarak saklanır.