Holarch

ניהול מערכת

כניסה יחידה ו-SCIM

חיבור ספק הזהויות SAML 2.0 של ארגון (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping), או ישירות של Active Directory של שרת באירוח עצמי, אימות דומייני הדוא״ל שלו, חיוב כניסה יחידה, מיפוי קבוצות לתפקידים והקצאת חשבונות עם SCIM 2.0.

אופן השימוש ←

בדף זה
  1. מושגים
  2. איך להשתמש בה
    1. אימות דומיין דוא״ל
    2. חיבור ספק הזהויות
    3. הפעלת הכניסה היחידה
    4. חיוב כניסה יחידה
    5. הקצאת חשבונות עם SCIM
    6. כשהאישור של ספק הזהויות משתנה
    7. כניסת החברה לכמה ארגונים (אירוח עצמי)
    8. גישה לפרויקטים של המחלקה (אירוח עצמי)
  3. כללי כניסה
    1. כניסה דו-שלבית
  4. מאפיינים
    1. קבוצות לתפקידים
  5. SCIM
    1. קבוצות SCIM ומחלקות (אירוח עצמי)
  6. הגדרת ספק הזהויות שלך
    1. Okta
    2. Microsoft Entra ID
    3. Microsoft AD FS
    4. Google Workspace
    5. Ping Identity
  7. ספריית החברה (Active Directory / LDAP)
    1. הגדרת ספריית החברה
    2. מחלקות מקבוצות הספרייה
    3. מי יכול להיכנס
    4. בדיקה תקופתית
    5. כניסה דו-שלבית עם ספריית החברה
  8. מגבלות והערות אבטחה

ארגון יכול לאפשר לחברים שלו להתחבר ל-Holarch עם חשבון העבודה שלהם. Holarch הוא ספק השירות; ספק הזהויות של הארגון שלך (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity או כל ספק SAML 2.0) בודק מי הם. ספק הזהויות יכול גם ליצור, לעדכן ולהשבית חשבונות Holarch דרך SCIM 2.0.

את הכניסה היחידה מגדיר מנהל ארגון תחת הגדרות הארגון ← הארגון ← גישה וכניסה ← כניסה יחידה. היא פועלת בשירות המתארח ובשרתים באירוח עצמי, לא באפליקציית שולחן העבודה. שרת באירוח עצמי צריך גישה יוצאת כדי לאמת דומיין (בדיקת DNS) וכדי לקרוא מטא-נתונים מכתובת URL. שרת באירוח עצמי יכול גם לבדוק חשבונות חברה בעצמו מול Active Directory או ספריית LDAP אחרת, בלי ספק זהויות: ראו ספריית החברה (Active Directory / LDAP).

הערה: כניסה יחידה והקצאת SCIM הן חלק מתוכנית Team (של הארגון). ארגונים שהשתמשו בהן לפני גרסה 2.29.0 שומרים עליהן. בלי התוכנית, ההגדרות נשמרות, אבל החברים מתחברים עם הסיסמה שלהם (שכחת את הסיסמה? קובע סיסמה), עם Google או עם Microsoft, ובקשות SCIM נדחות.

מושגים

מונחמשמעות
דומיין מאומתדומיין דוא״ל (כגון example.com) שהארגון הוכיח שהוא שולט בו באמצעות רשומת DNS TXT. כניסה יחידה ו-SCIM פועלות רק לכתובות בדומיינים מאומתים. דומיין יכול להיות מאומת על ידי ארגון אחד.
ספק זהויות (IdP)השירות שמחבר את החברים שלך: ה-entity ID (המנפיק) שלו, כתובת ה-URL לכניסה שלו ואישור החתימה שלו.
ספק שירות (SP)Holarch, עבור הארגון הזה. לכל ארגון יש entity ID, ACS URL וכתובת URL של מטא-נתונים משלו.
חברים מנוהליםחברים בארגון שכתובת הדוא״ל שלהם בדומיין מאומת ושאינם מנהלי ארגון. חיוב כניסה יחידה חל עליהם.
אסימון SCIMסוד שספק הזהויות משתמש בו כדי לקרוא ל-SCIM API של Holarch עבור הארגון הזה. הוא אינו קשור לאדם.

איך להשתמש בה

אימות דומיין דוא״ל

  1. פותחים את הגדרות הארגון, בוחרים את הארגון, פותחים את גישה וכניסה ומוצאים את כניסה אחידה.
  2. תחת דומייני דוא״ל מזינים את הדומיין של הכתובות של החברים שלך ובוחרים הוספת דומיין.
  3. מפרסמים את רשומת ה-TXT שמוצגת: השם _holarch-challenge.<domain> עם הערך holarch-domain-verification=….
  4. בוחרים בדיקה. שינויי DNS יכולים לקחת כמה דקות להגיע; בודקים שוב עד שהדומיין מציג מאומת.

מוסיפים כל דומיין שהחברים שלך משתמשים בו (למשל example.com ו-eng.example.com). עד 20 דומיינים לארגון.

חיבור ספק הזהויות

  1. בספק הזהויות שלך יוצרים אפליקציית SAML 2.0 (ראו את המקטעים של הספקים למטה) עם הערכים שמופיעים תחת ספק זהויות ב-Holarch:
    • Entity ID (audience): https://app.holarch.app/api/auth/saml/<organization id>/metadata
    • ACS URL (כתובת URL להחזרה): https://app.holarch.app/api/auth/saml/<organization id>/acs
    • כתובת URL של המטא-נתונים: זהה ל-entity ID; ספקים שמייבאים מטא-נתונים של SP יכולים להשתמש בה.
  2. מעתיקים את ה-XML של המטא-נתונים של הספק או את כתובת ה-URL של המטא-נתונים שלו לתיבה למעלה ובוחרים קריאת המטא-נתונים. Holarch ממלא את ה-entity ID, את כתובת ה-URL לכניסה ואת האישור. או שמזינים אותם בעצמך.
  3. תחת מאפיינים ותפקידים קובעים את שמות המאפיינים אם הספק שלך משתמש בשמות לא רגילים (ראו מאפיינים), את התפקיד של חברים חדשים, ואת קבוצות לתפקידים האופציונלי.
  4. בוחרים שמירת ספק הזהויות ומזינים את הסיסמה.

הפעלת הכניסה היחידה

  1. מסמנים את כניסה יחידה לארגון הזה. היא דורשת ספק זהויות שמור ודומיין מאומת.
  2. נותנים לחברים את קישור כניסה לחברים, או אומרים להם לבחור כניסה יחידה במסך ההתחברות ולהזין את כתובת הדוא״ל של העבודה שלהם.
  3. כדאי לנסות קודם עם חבר אחד.

בכניסה הראשונה של חבר, Holarch יוצר את החשבון (מאושר, בלי סיסמה) ומוסיף אותו לארגון, גם כשההרשמה דורשת הזמנה. כשקיים חשבון עם הכתובת הזו, הכניסה היחידה מקושרת אליו והבעלים שלו מקבל הודעת דוא״ל.

חיוב כניסה יחידה

מסמנים את חיוב כניסה יחידה לחברים בדומיינים המאומתים אחרי שהכניסה היחידה פועלת.

  • חברים מנוהלים מתחברים אז רק דרך ספק הזהויות. כניסה עם סיסמה, מפתח גישה, Google ו-Microsoft עונות שהארגון מחייב כניסה יחידה, עם לחצן שמוביל לשם. ההפעלות הנוכחיות שלהם משיטות כניסה אחרות מסתיימות מיד.
  • מנהלי ארגון אינם מחויבים: הם שומרים על הסיסמה או מפתח הגישה שלהם עם כניסה בשני שלבים, כדי שיוכלו לתקן הגדרה שבורה של ספק הזהויות (גישת חירום). כדאי להחזיק לפחות שני מנהלי ארגון.
  • חברים שהכתובת שלהם מחוץ לדומיינים המאומתים (שותפים חיצוניים) אינם מושפעים.
  • איפוס סיסמה עדיין קובע את הסיסמה החדשה אבל אינו מחבר את החבר; הוא מתחבר אז דרך ספק הזהויות.
  • אסימוני API ואפליקציות מחוברות של חברים מנוהלים ממשיכים לפעול. כדי לסיים אותם, משביתים את החשבון דרך SCIM.

הקצאת חשבונות עם SCIM

  1. תחת הקצאה (SCIM 2.0) בוחרים יצירת אסימון SCIM ומזינים את הסיסמה.
  2. מעתיקים את האסימון ואת כתובת URL בסיסית (https://app.holarch.app/scim/v2) להגדרות ההקצאה של ספק הזהויות שלך. Holarch מציג את האסימון פעם אחת.
  3. מפעילים בספק יצירה, עדכון והשבתה של משתמשים.

עד 5 אסימונים לארגון. ביטול מסיים אסימון מיד.

כשהאישור של ספק הזהויות משתנה

  1. מדביקים את האישור החדש מתחת לישן (מותרים שני אישורים) ושומרים.
  2. מעבירים את הספק לאישור החדש.
  3. מסירים את האישור הישן ושומרים שוב.

רשימת האישורים מציגה את הנושא, תאריך התפוגה וטביעת האצבע של כל אישור.

כניסת החברה לכמה ארגונים (אירוח עצמי)

דומיין דוא״ל שייך לארגון אחד. כשחברה מפעילה ארגון אחד לכל מחלקה בשרת באירוח עצמי, ארגון אחד (בדרך כלל של ה-IT) מאמת את דומיין החברה, מחבר את ספק הזהויות ומפעיל את הכניסה היחידה. אחר כך הארגונים האחרים ממפים קבוצות של ספק הזהויות לתפקידים משלהם:

  1. בהגדרות הארגון ← גישה וכניסה ← כניסה יחידה של המחלקה, מאתרים את כניסת החברה. שם מצוין הארגון שמפעיל את כניסת החברה.
  2. תחת קבוצות לתפקידים, כותבים מיפוי אחד בכל שורה, למשל packs-engineers = member ו-packs-leads = admin, ובוחרים שמירת קבוצות.
  3. אופציונלי: מוסיפים אחרי פסיק את הגישה לפרויקטים של המחלקה של הקבוצה, למשל packs-contractors = member, viewer. ראו גישה לפרויקטים של המחלקה.

בכל כניסה דרך כניסת החברה, אדם בקבוצה ממופה מצטרף לארגון הזה עם התפקיד הזה, או הופך שם למנהל ארגון. כניסה אף פעם אינה מסירה או מורידה אף אחד (קבוצות SCIM יכולות: ראו קבוצות SCIM ומחלקות); מנהלי ארגון מסירים אנשים בהגדרות הארגון. ספק הזהויות חייב לשלוח את הקבוצות (מאפיין קבוצות של כניסת החברה).

מנהלי הארגון של הארגון שמפעיל את כניסת החברה שולטים בכניסה של כל כתובת בדומיין. כדאי להגביל את הארגון הזה לאנשים שמפעילים את ספק הזהויות.

גישה לפרויקטים של המחלקה (אירוח עצמי)

כל מיפוי קבוצה יכול גם לקבוע כמה האנשים שלה מקבלים בפרויקטים ששותפו עם הארגון כולו (שיתוף ← ארגונים): viewer, reviewer או editor (ברירת המחדל). התפקיד של אדם בפרויקט כזה הוא הנמוך מבין התפקיד של השיתוף והגישה הגבוהה ביותר מבין הקבוצות הממופות שלו שם. למשל, עם פרויקט ששותף כעורך ועם packs-contractors = member, viewer, קבלן משנה צופה בו; מי שנמצא גם ב-packs-contractors וגם ב-packs-engineers = member עורך אותו. הכלל חל בכל מקום שממנו מגיעות הקבוצות: כניסה יחידה של החברה, קבוצות SCIM וספריית החברה. פרויקטים ששותפו ישירות עם אדם אינם מושפעים, וחבר שנוסף ידנית (שאינו באף קבוצה ממופה) מקבל את התפקיד של השיתוף. שינוי הגישה של קבוצה חל מיד על כל מי שהיא שייכה.

מושבי עורכים. הרישיון מגביל עורכים; צופים ומבקרים אינם נספרים. כשגישת העורך של קבוצה הייתה הופכת מישהו לעורך ואין מושב פנוי, האדם מקבל במקום זאת צופה, והכניסה עדיין פועלת. הגדרות הארגון ומנהל ← ספריית החברה מציגים כמה אנשים נשארו כצופים; הדף של ספריית החברה מציג כל עורך שהמושב שלו מגיע מקבוצה, ואת כל אדם שנשאר כצופה. כשמושבים מתפנים, אנשים שנשארו כצופים מקבלים עורך בבדיקה הבאה, החברות הוותיקה ביותר ראשונה.

שרתים ברשת סגורה. כשהשרת אינו יכול לבצע בדיקות DNS ציבוריות, מנהל אתר יכול לבחור סימון כמאומת ליד דומיין שאינו מאומת במקום לפרסם את רשומת ה-TXT. הדומיין עדיין שייך לארגון אחד בלבד, והשינוי נרשם ביומן הביקורת.

כללי כניסה

Holarch בודק בקפדנות כל תשובה מספק הזהויות. כניסה נדחית כש:

  • ה-assertion אינו חתום באישור מוגדר, או חתום ב-SHA-1;
  • המנפיק, ה-audience (ה-entity ID של הארגון), היעד או הנמען (ה-ACS URL) אינם תואמים;
  • ה-assertion עדיין אינו תקף או שפג תוקפו (מותר הפרש שעון של 2 דקות);
  • הוא עונה לכניסה שלא התחילה באותו דפדפן, או לכניסה שכבר נוצלה (כל כניסה מתחילה פעם אחת ופגה אחרי 10 דקות);
  • אותו assertion מגיע בפעם השנייה (שידור חוזר);
  • כתובת הדוא״ל חסרה או מחוץ לדומיינים המאומתים של הארגון;
  • החשבון מושבת.

מסך ההתחברות אומר אז מה השתבש, ויומן הביקורת של הארגון רושם זאת כ-auth.sso-failed.

כניסה מהפורטל של ספק הזהויות (ביוזמת ה-IdP, כשחברים מתחילים מלוח האפליקציות של הספק) כבויה כברירת מחדל, כי תשובה כזו אינה קשורה לכניסה שהדפדפן התחיל. מפעילים את התרת כניסה מהפורטל של ספק הזהויות רק כשהחברים שלך צריכים זאת. ההגנה מפני שידור חוזר וכל שאר הבדיקות עדיין חלות.

כניסה דו-שלבית

כברירת מחדל כניסה יחידה היא השלב הראשון. חשבונות שהכניסה בשני שלבים פעילה בהם עדיין מאשרים מפתח גישה או קוד, וההגדרה חיוב כניסה בשני שלבים של הארגון עדיין מבקשת אותה מהחברים.

כשאמון בכניסה רב-שלבית של ספק הזהויות פעיל, כניסה שה-assertion שלה מדווח על אימות רב-שלבי אינה צריכה שלב שני של Holarch, והיא עומדת בדרישת הכניסה בשני שלבים של הארגון הזה בהפעלה הזו (לא של ארגונים אחרים). Holarch מקבל את הקשרי האימות האלה כרב-שלביים:

הקשר אימותנשלח על ידי
https://refeds.org/profile/mfaספקים רבים כשהם מוגדרים לכך
http://schemas.microsoft.com/claims/multipleauthnMicrosoft Entra ID
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (ו-…MobileTwoFactorUnregistered)Okta ואחרים
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncTokenקוד חד-פעמי
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard ו-…SmartcardPKIכרטיסים חכמים

גם ה-claim http://schemas.microsoft.com/claims/authnmethodsreferences של Entra ID עם multipleauthn נחשב. כניסה עם סיסמה בלבד אצל ספק הזהויות אינה רב-שלבית, גם כשהאמון פעיל.

מאפיינים

Holarchשמות מאפיינים ברירת מחדל (נעשה שימוש בראשון שקיים)
דוא״ל (חובה)email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, ה-NameID כשהוא כתובת דוא״ל, או אחרת ה-claim של UPN (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn)
שםdisplayName, name, http://schemas.microsoft.com/identity/claims/displayname, ה-claim name של WS-Federation, או שם פרטי ושם משפחה (givenName/firstName, sn/surname/lastName וצורות ה-claim שלהם)
קבוצותהמאפיין שמציינים במאפיין קבוצות, למשל groups. כשלא מציינים אף מאפיין: groups, memberOf, Role, ה-http://schemas.xmlsoap.org/claims/Group של AD FS, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid ו-…/claims/groups

החשבון נמצא לפי ה-NameID של ספק הזהויות (persistent, email, שם מלא של דומיין Windows או פורמט אחר). בלי NameID (AD FS אינו שולח אחד אלא אם כלל claim מנפיק אותו), כתובת הדוא״ל מזהה את החשבון. כשה-NameID משתנה אבל כתובת הדוא״ל נשארת, החשבון מקושר מחדש.

שמות קבוצות מושווים בלי הבדל בין אותיות גדולות לקטנות. שם עם דומיין כמו CORP\Packs Engineers מתאים גם למיפוי של Packs Engineers, ו-SID של קבוצה (S-1-5-21-…) מתאים למיפוי שנכתב עם ה-SID הזה.

קבוצות לתפקידים

כותבים מיפוי אחד בכל שורה: holarch-admins = admin או engineering = member. בכל כניסה, חבר בקבוצה שממופה ל-admin הופך למנהל ארגון; אחרת חבר בקבוצה ממופה הופך לחבר. חברים שאינם באף קבוצה ממופה שומרים על התפקיד שלהם. מנהל הארגון האחרון לעולם אינו מורד בדרגה.

SCIM

ה-SCIM API פועל לפי RFC 7643 ו-RFC 7644 בכתובת https://app.holarch.app/scim/v2 עם Authorization: Bearer hsc_….

נקודת קצהמה הוא עושה
GET /ServiceProviderConfig, /ResourceTypes, /Schemasתיאור השירות
GET /Usersהצגת המשתמשים שהוקצו לארגון והחברים בדומיינים המאומתים שלו; filter עם eq על userName, externalId, id, emails.value או emails[type eq "work"].value; startIndex ו-count
POST /Usersיצירת משתמש (או קישור חשבון קיים עם הכתובת הזו) והוספתו לארגון
GET, PUT, PATCH /Users/<id>קריאה, החלפה או שינוי של משתמש: userName, name, displayName, emails, externalId, active
DELETE /Users/<id>השבתת המשתמש ושכחת המזהה החיצוני
/Groupsשרתים באירוח עצמי: רשימה, יצירה, קריאה, החלפה, שינוי (PATCH על members, displayName, externalId, בצורות של Okta ושל Microsoft Entra ID) ומחיקה של קבוצות; filter עם eq על displayName, externalId או id; excludedAttributes=members. ראו קבוצות SCIM ומחלקות. השירות המתארח: רשימה ריקה, שינויים נדחים; במקום זאת ממפים קבוצות לתפקידים תחת כניסה יחידה.
  • אפשר ליצור או לשנות רק כתובות בדומיינים המאומתים של הארגון.
  • השבתה (active: false, או DELETE) מסירה את האדם מהארגון, משביתה את החשבון, מסיימת את כל ההפעלות שלו, ומבטלת את אסימוני ה-API והאפליקציות המחוברות שלו. הפעלה מחדש מפעילה את החשבון ומשחזרת את התפקיד שלו בארגון. חשבון ש-Holarch השבית (למשל אחרי שימוש לרעה) נשאר מושבת.
  • מאפייני הרחבת Enterprise מתקבלים ומתעלמים מהם.
  • כל אסימון רשאי לבצע 600 בקשות בדקה. כל שינוי נרשם ביומן הביקורת של הארגון (scim.create, scim.deactivate וכן הלאה).

קבוצות SCIM ומחלקות (אירוח עצמי)

בשרת באירוח עצמי, ספק הזהויות יכול לדחוף את הקבוצות שלו לנקודת הקצה של SCIM של הארגון שמחזיק בדומיין החברה. אחר כך קבוצות לתפקידים של המחלקות תחת כניסת החברה קובעות מי שייך לאיזו מחלקה, ובאיזה תפקיד. מיפוי אחד משרת את שניהם: כניסה דרך הכניסה היחידה של החברה וקבוצות SCIM.

  • אדם שנוסף לקבוצה ממופה מצטרף לארגון הזה עם התפקיד הממופה; שינוי קבוצה משנה את התפקיד.
  • אדם שהוסר מכל קבוצה ממופה עוזב את הארגונים שהקבוצות הוסיפו אותו אליהם.
  • חברויות שנוספו בדרך אחרת (על ידי מנהל ארגון, הזמנה, ייבוא או כניסה) אף פעם אינן מוסרות או מורדות על ידי קבוצות; קבוצות יכולות רק להעלות אותן למנהל ארגון. כשמנהל ארגון משנה ידנית את התפקיד של חבר, החברות שייכת לו מאותו רגע.
  • מנהל הארגון האחרון של ארגון אף פעם אינו מוסר או מורד.
  • שינוי בקבוצות לתפקידים של מחלקה חל מיד על כל מי שבקבוצות.
  • חברי קבוצה חייבים להיות משתמשים שהאסימון הזה מקצה או מנהל; מזהים אחרים אינם נלקחים בחשבון.
  • השבתת משתמש פועלת כמו קודם; המחלקות שלו עוקבות אחרי הקבוצות שלו.
  • כל שינוי נרשם: scim.group-create, scim.group-update ו-scim.group-delete ביומן הביקורת של ארגון החברה, וכל שינוי חברות ביומן של המחלקה.

הגדרת ספק הזהויות שלך

Okta

  1. Applications → Create App Integration → SAML 2.0.
  2. Single sign-on URL: ה-ACS URL. משאירים את Use this for Recipient URL and Destination URL מסומן. Audience URI (SP Entity ID): ה-entity ID.
  3. Name ID format: EmailAddress או Persistent. Application username: Email.
  4. Attribute statements: email → user.email, displayName → user.displayName. Group attribute statements (אופציונלי): groups, עם מסנן לפי הצורך.
  5. מסיימים, ואז מעתיקים את ה-Metadata URL מהכרטיסייה Sign On ל-Holarch ובוחרים קריאת המטא-נתונים.
  6. ל-SCIM: בכרטיסייה General של האפליקציה מפעילים את SCIM provisioning; ב-Provisioning, SCIM connector base URL הוא כתובת ה-URL הבסיסית, Unique identifier field הוא userName, Authentication Mode הוא HTTP Header עם אסימון ה-SCIM; מפעילים את Create Users, Update User Attributes ו-Deactivate Users.

Microsoft Entra ID

  1. Enterprise applications → New application → Create your own application (לא מהגלריה), ואז Single sign-on → SAML.
  2. Identifier (Entity ID): ה-entity ID. Reply URL (Assertion Consumer Service URL): ה-ACS URL.
  3. Attributes & Claims: ה-claim emailaddress שכברירת מחדל פועל; מוסיפים claim של קבוצה אם ממפים קבוצות.
  4. תחת SAML Certificates מעתיקים את App Federation Metadata Url ל-Holarch ובוחרים קריאת המטא-נתונים.
  5. כדי לסמוך על הכניסה הרב-שלבית של Entra, מחייבים MFA במדיניות Conditional Access לאפליקציה; Entra שולח אז multipleauthn.
  6. ל-SCIM: Provisioning → Automatic; Tenant URL הוא כתובת ה-URL הבסיסית ו-Secret Token הוא אסימון ה-SCIM. Test Connection, ואז מתחילים את ההקצאה.

Microsoft AD FS

AD FS (Active Directory Federation Services, Windows Server 2016 ואילך) מכניס אנשים מה-Active Directory המקומי שלכם. במסוף AD FS Management:

  1. Relying Party Trusts ← Add Relying Party Trust ← Claims aware ← Import data about the relying party published online, ומזינים את כתובת URL של המטא-נתונים של Holarch. אם שרת AD FS אינו יכול להגיע ל-Holarch, שומרים את המטא-נתונים כקובץ ובוחרים Import data about the relying party from a file. שם תצוגה: Holarch.
  2. Access control policy: Permit everyone, או Permit everyone and require MFA (ראו שלב 6).
  3. פותחים את Edit Claim Issuance Policy ← Add Rule ← Send LDAP Attributes as Claims של ה-trust, עם מאגר המאפיינים Active Directory:
מאפיין LDAPסוג ה-claim היוצא
E-Mail-AddressesE-Mail Address
Display-Nameשם
Token-Groups – Unqualified Namesקבוצה

משתמשים במקום זאת ב-Token-Groups – Qualified by Domain Name כשבשני דומיינים יש קבוצות עם אותו שם; ב-Token-Groups as SIDs (סוג claim Group SID) כששמות הקבוצות משתנים. Holarch קורא את ה-claims מסוג Group, Role ו-Group SID בלי מאפיין קבוצות.

AD FS שולח את pre-Windows 2000 name של כל קבוצה (sAMAccountName), לא את שם התצוגה שלה או את cn, והוא כולל את הקבוצה הראשית (בדרך כלל Domain Users). ממפים קבוצות לפי השם הזה, או לפי SID. בשרת שספריית החברה מחוברת אליו, מנהל ← ספריית החברה ← בדיקת משתמש מציג את שניהם לכל אחת מהקבוצות של אדם.

  1. אופציונלי, NameID יציב: Add Rule ← Transform an Incoming Claim, נכנס E-Mail Address (או UPN), יוצא Name ID, פורמט Email (או Persistent Identifier). בלי זה Holarch מזהה את החשבון לפי כתובת הדוא״ל שלו.
  2. ב-Properties ← Advanced של ה-trust, משאירים SHA-256. משאירים את הכרטיסייה Encryption ריקה: Holarch אינו מפענח assertions, והחיבור הוא https. AD FS חותם על ה-assertion כברירת מחדל (SamlResponseSignature AssertionOnly), ו-Holarch דורש זאת.
  3. מעתיקים את https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xml אל כתובת URL של המטא-נתונים של Holarch ובוחרים קריאת המטא-נתונים. הפעולה ממלאת את מזהה הישות (http://<host>/adfs/services/trust), את כתובת הכניסה (https://<host>/adfs/ls/) ואת אישור חתימת האסימונים. כדי לסמוך על הכניסה הרב-שלבית של AD FS, דורשים MFA ב-access control policy ומפעילים את אמון בכניסה רב-שלבית של ספק הזהויות; אז AD FS שולח http://schemas.microsoft.com/claims/multipleauthn.

בשרת באירוח עצמי כתובת ה-URL של המטא-נתונים יכולה להיות כתובת פנימית (https://adfs.corp.example.com/…, כתובת IP פרטית), והאישור שלה נבדק מול רשות האישורים של החברה ב-tls/ldap-ca.pem וגם מול רשויות האישורים המהימנות של המערכת. אישור חתימת האסימונים של AD FS מתחלף בכל שנה: Holarch מציג את תאריך התפוגה; בוחרים שוב קריאת המטא-נתונים כש-AD FS מוסיף את האישור החדש (שניהם נשמרים בתקופת החפיפה). ל-AD FS אין SCIM; עם ספריית חברה בשרת באירוח עצמי, Holarch בודק את החשבונות בעצמו (בהמשך).

Google Workspace

  1. Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
  2. מעתיקים את IdP metadata (מורידים אותו, ואז מדביקים את ה-XML ב-Holarch).
  3. ACS URL: ה-ACS URL. Entity ID: ה-entity ID. Name ID format: EMAIL, Name ID: Basic Information › Primary email.
  4. Attribute mapping: Primary email → email; First name → givenName; Last name → sn. Group membership → groups (אופציונלי).
  5. מעבירים את האפליקציה ל-ON for everyone (או ליחידה ארגונית).
  6. Google Workspace אינו שולח הקשר אימות MFA; משאירים את אמון בכניסה רב-שלבית של ספק הזהויות כבוי. הקצאת SCIM של Google פועלת רק עם אפליקציות מהגלריה; במקום זאת יוצרים חשבונות בכניסה יחידה.

Ping Identity

  1. PingOne: Applications → Add Application → SAML Application (PingFederate: חיבור SP).
  2. מייבאים את כתובת URL של המטא-נתונים של Holarch, או מזינים את ACS URL ואת Entity ID.
  3. Attribute mapping: saml_subject → Email Address; מוסיפים email ו-displayName.
  4. מעתיקים את כתובת ה-URL של המטא-נתונים של ה-IdP ל-Holarch ובוחרים קריאת המטא-נתונים.
  5. ל-SCIM: הקצאת PingOne עם חיבור SCIM; כתובת ה-URL הבסיסית ואימות OAuth 2 Bearer Token עם אסימון ה-SCIM.

ספריית החברה (Active Directory / LDAP)

בשרת באירוח עצמי, אנשים יכולים להיכנס עם שם המשתמש והסיסמה שלהם בחברה, שנבדקים על ידי ספריית החברה: Active Directory (בקרי התחום שלה) או ספריית LDAP אחרת כגון OpenLDAP או FreeIPA. אין צורך בספק זהויות. מנהל אתר מגדיר זאת במנהל ← ספריית החברה; קובץ ה-.env של השרת יכול לתת את ערכי ההתחלה (HOLARCH_LDAP_*, SIGN-IN.md בחבילת האירוח העצמי). האפשרות אינה מוצעת בשירות המתארח.

הגדרת ספריית החברה

קודם בוחרים את סוג הספרייה בראש מנהל ← ספריית החברה: Active Directory או ספריית LDAP אחרת (OpenLDAP, FreeIPA, …). בשני המקרים זה חיבור אחד; הסוג קובע אילו חיפושי קבוצות מוצעים, אילו ערכים שימוש בברירות המחדל של Active Directory או שימוש בברירות המחדל של LDAP מכניסים לטופס, ואת הרמזים והדוגמאות. שינוי הסוג מחליף מסנן משתמשים או חיפוש קבוצות שעדיין נמצאים בברירת המחדל של הסוג האחר, ומשאיר מסנן שכתבת בעצמך. הדף מסיק את הסוג מההגדרות השמורות (קבוצות מקוננות או מסנן של Active Directory פירושם Active Directory).

  1. יוצרים בספרייה חשבון שירות לקריאה בלבד (למשל svc-holarch). כותבים את השם שלו בחשבון קישור ואת הסיסמה שלו ב-.env של השרת בתור HOLARCH_LDAP_BIND_PASSWORD, ואז מפעילים מחדש את השרת. הסיסמה אף פעם אינה מוצגת במנהל.
  2. תחת שרתי ספרייה, מזינים כל בקר תחום או שרת LDAP בצורה ldaps://dc1.corp.example.com (יציאה 636), אחד בכל שורה; הם נוסים לפי הסדר. ldap://host:389 עובד רק כש-שימוש ב-StartTLS בכתובות ldap:// מופעל. LDAP רגיל נדחה, כך שסיסמה לעולם לא עוברת ברשת בלי הצפנה. יש להשתמש בשם המארח של כל שרת כפי שהוא מופיע בתעודה שלו.
  3. מכניסים את התעודה של ה-CA שהנפיק את התעודות של השרתים ב-תעודת CA (PEM), או ב-tls/ldap-ca.pem בשרת. ריק פירושו רשויות ה-CA המהימנות של המערכת.
  4. מזינים את DN בסיסי (DC=corp,DC=example,DC=com, או dc=example,dc=com בספריית LDAP אחרת) ואת דומייני דוא"ל מורשים.
  5. בוחרים בדיקת החיבור. הבדיקה מתחברת עם הערכים שבטופס, בלי לשמור, ומציינת את הבעיה כשמשהו נכשל (אף שרת לא ענה, אישור, חשבון קישור, DN בסיסי).
  6. תחת בדיקת משתמש, מזינים שם משתמש כדי לראות מה הכניסה תמצא: את כתובת הדוא״ל, אם החשבון פעיל, את הקבוצות שלו ואת הארגונים שיצטרף אליהם. הסיסמה אופציונלית; היא נבדקת פעם אחת ואף פעם אינה נשמרת.
  7. מפעילים את לאפשר כניסה עם חשבונות החברה ובוחרים שמירה. אז מסך הכניסה מציג כניסה עם חשבון החברה (או את טקסט הכפתור שלכם).

Active Directory: מסנן משתמשים המוגדר כברירת מחדל מוצא משתמשים פעילים לפי sAMAccountName, userPrincipalName או mail, כך שאנשים יכולים להקליד jsmith, [email protected] או CORP\jsmith. חשבונות מושבתים אינם נכללים. חיפוש קבוצות מציע Active Directory, כולל קבוצות מקוננות (ברירת המחדל) ו-המאפיין memberOf ‏(קבוצות ישירות בלבד).

ספריית LDAP אחרת: שימוש בברירות המחדל של LDAP מכניס (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) ל-מסנן משתמשים, כך שאנשים מקלידים את ה-uid או את כתובת הדוא״ל שלהם; כל מסנן עובד עם {username} במקום שבו נכנס השם שהוקלד. חיפוש קבוצות מציע המאפיין memberOf (OpenLDAP עם שכבת memberof, FreeIPA, 389 Directory Server) ו-קבוצות שמציינות את האדם כחבר (groupOfNames ו-groupOfUniqueNames; DN בסיסי לקבוצות מציין היכן הן נמצאות). קבוצות מקוננות אינן נספרות.

מחלקות מקבוצות הספרייה

קבוצות הספרייה משייכות אנשים לארגונים עם אותן קבוצות לתפקידים תחת כניסת החברה כמו ב-SAML (ראו כניסת החברה לכמה ארגונים): בתיבה כניסה אחידה של כל ארגון, ממפים קבוצות לתפקידים, למשל Packs Engineers = member ו-Packs Leads = admin. השמות מושווים בלי הבדל בין אותיות גדולות לקטנות; גם DN של קבוצה עובד, וב-Active Directory גם ה-SID שלה. Active Directory, כולל קבוצות מקוננות סופר אדם בקבוצה גם דרך קבוצות אחרות שבתוכה.

בכל כניסה ובכל בדיקה תקופתית, אדם בקבוצה ממופה מצטרף לארגון הזה עם התפקיד הזה, ועם הגישה לפרויקטים של המחלקה של הקבוצה. חברות שהספרייה נתנה מוסרת כשהאדם עוזב כל קבוצה שממופה אליה; חברויות שנוספו ידנית נשארות (הספרייה יכולה להעלות חבר שם למנהל ארגון, אבל אף פעם אינה מורידה אותו). מנהל הארגון האחרון אף פעם אינו מוסר.

מי יכול להיכנס

  • החשבון חייב להיות פעיל בספרייה: חשבונות מושבתים, נעולים ופגי תוקף נדחים, וכך גם חשבונות שהסיסמה שלהם פגה או שחייבים לשנות אותה בכניסה הבאה.
  • ברשומה בספרייה חייבת להיות כתובת דוא״ל בדומיין מורשה. הכניסה הראשונה יוצרת את חשבון Holarch, או מקשרת את החשבון הקיים עם הכתובת הזו. חשבון שכבר מקושר לרשומה אחרת בספרייה אינו נלקח.
  • לדרוש כניסה עם חשבון החברה בחשבונות מקושרים מונע מחשבונות מקושרים להיכנס עם סיסמת Holarch. מנהלי אתר שומרים על הסיסמה שלהם, כך שתקלה בספרייה אף פעם אינה נועלת את כולם בחוץ.
  • סיסמאות שגויות משהות את הכניסה לחשבון החברה הזה ל-15 דקות אחרי ניסיונות כושלים לפני השהיה (ברירת מחדל 3), בכל צורה של השם שהוקלדה (jsmith, [email protected], CORP\jsmith). כדאי להשאיר את הערך מתחת לסף הנעילה של הדומיין, כך ש-Holarch אף פעם לא ינעל חשבון חברה. שמות משתמש לא ידועים וסיסמאות שגויות מקבלים אותה תשובה, בערך באותו זמן.

בדיקה תקופתית

בכל פרק זמן שנקבע בבדיקת חשבונות כל (בדקות, ברירת מחדל 15), השרת בודק כל חשבון מקושר שמחובר או שמחזיק חברויות מהספרייה. אדם שהושבת, ננעל, הוסר מהספרייה, או שהסיסמה שלו פגה או שחייבים לשנות אותה בכניסה הבאה (לעיתים קרובות איפוס של מנהל אחרי חשד לפריצה) מנותק בכל מקום ומאבד את החברויות שהספרייה נתנה; שינויים בקבוצות מעדכנים חברויות. חשבון נעול מקבל את החברויות שלו בחזרה בכניסה הבאה שלו אחרי שהנעילה מוסרת. כשאי אפשר להגיע לספרייה, שום דבר אינו משתנה. כשרוב החשבונות שנבדקו חסרים (למשל אחרי DN בסיסי שגוי), שום דבר אינו מסתיים והמנהל מציג אזהרה. בדיקה עכשיו מריץ את הבדיקה מיד. המנהל מציג את התוצאה של הבדיקה האחרונה.

כל בדיקה גם מחפשת את החברים של כל קבוצה ממופה (קבוצות מקוננות נספרות עם Active Directory, כולל קבוצות מקוננות) ומקימה חשבונות לאנשים שעדיין אין להם, לפי אותם כללים כמו בכניסה (פעיל, דומיין דוא״ל מורשה, אין השתלטות על חשבון שמקושר במקום אחר). לא נשלח דוא״ל; האדם נכנס עם חשבון החברה שלו כשהוא צריך את Holarch לראשונה, וכבר נמצא במחלקות שלו, כך שאפשר לשתף איתו פרויקטים לפני כן. בדיקה מקימה לכל היותר 200 חשבונות; המנהל מציג כמה נוספים ממתינים לבדיקה הבאה. קבוצות שמצוינות רק לפי SID אינן נבדקות כך; האנשים שלהן משויכים בכניסה.

כניסה דו-שלבית עם ספריית החברה

כניסת החברה היא השלב הראשון. ארגונים שדורשים כניסה דו-שלבית עדיין מבקשים את השלב השני של Holarch (מפתח גישה או קוד), וחשבונות עם כניסה דו-שלבית פעילה עדיין מאשרים אותה. מפעילים את לראות בכניסה עם חשבון החברה כניסה דו-שלבית רק כשחשבון החברה עצמו דורש גורם שני; אז הוא עומד בדרישת הכניסה הדו-שלבית של כל ארגון לאותו סשן.

כל כניסה דרך הספרייה, דחייה ושינוי הגדרות נמצאים ביומן הביקורת (admin.directory-save, admin.directory-test, directory.account-ended) וברשומות הכניסה של כל חשבון. סיסמאות אף פעם אינן נרשמות.

מגבלות והערות אבטחה

מגבלה: הכניסה היחידה משתמשת ב-binding מסוג HTTP-Redirect אל ספק הזהויות וב-HTTP-POST בחזרה אל Holarch. בקשות אימות חתומות ומוצפנות, assertions מוצפנים ויציאה יחידה אינם נתמכים. קבוצות SCIM נתמכות בשרתים באירוח עצמי בלבד (קבוצות SCIM ומחלקות). ספריית החברה מכניסה עם שם משתמש וסיסמה (simple bind על גבי TLS); Kerberos וכניסה משולבת של Windows אינם נתמכים.

  • שינויי הגדרות דורשים בדיקת סיסמה עדכנית, נשלחים בדוא״ל לכל מנהלי הארגון ונרשמים ביומן הביקורת (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
  • כתובות URL של מטא-נתונים חייבות להשתמש ב-https באינטרנט הציבורי (בשרת באירוח עצמי מותרות גם כתובות פנימיות); Holarch מוריד אותן פעם אחת, כשבוחרים קריאת המטא-נתונים.
  • אסימוני SCIM נשמרים רק כגיבוב (hash).