איסוף יומני הקשר של משתמשי Okta

נתמך ב:

במאמר הזה מוסבר איך להגדיר פיד של Google Security Operations באמצעות ממשק API של צד שלישי כדי לאסוף יומני הקשר של משתמשים ב-Okta.

לפני שמתחילים

ודאו שאתם עומדים בדרישות המוקדמות הבאות:

  • מכונה של Google SecOps
  • גישה מורשית לדייר או למסוף Admin של Okta
  • הרשאות ליצירת אסימון API ב-Okta

הגדרת רשימת היתרים של כתובות IP

לפני שיוצרים את הפיד, צריך להוסיף את טווחי כתובות ה-IP של Google SecOps לרשימת ההיתרים בחומת האש או בהגדרות הרשת של Okta.

איך מקבלים את טווחי כתובות ה-IP של Google SecOps

הוספת טווחי IP להקשר המשתמש ב-Okta

  1. נכנסים למסוף Admin של Okta.
  2. עוברים אל אבטחה > רשתות.
  3. בקטע הגבלות על כתובות IP, לוחצים על עריכה.
  4. מוסיפים כל טווח כתובות IP של Google SecOps בסימון CIDR לכתובות ה-IP המהימנות.
  5. לוחצים על Save.

הגדרת הגישה ל-Okta User Context API

כדי לאפשר ל-Google SecOps לשלוף נתוני הקשר של משתמשים, צריך ליצור אסימון API עם הרשאות קריאה.

יצירת טוקן API

  1. נכנסים למסוף Admin של Okta.
  2. עוברים אל אבטחה > API.
  3. לוחצים על הכרטיסייה טוקנים.
  4. לוחצים על Create Token (יצירת אסימון).
  5. מזינים את פרטי ההגדרה הבאים:
    • שם: מזינים שם תיאורי (לדוגמה, Google SecOps Integration).
    • תיאור (אופציונלי): מזינים תיאור.
  6. לוחצים על Create Token (יצירת אסימון).

תיעוד פרטי הכניסה של ה-API

אחרי שתיצרו את אסימון ה-API, תקבלו את פרטי הכניסה הבאים:

  • טוקן API: הערך של טוקן ה-API (לדוגמה, 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1)

הרשאות ה-API הנדרשות

האסימון של ה-API דורש את ההרשאות הבאות ב-Okta:

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

הגדרת פידים

כדי להגדיר פיד:

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. בדף הבא, לוחצים על הגדרת פיד יחיד.
  4. בשדה שם הפיד, מזינים שם לפיד (לדוגמה, Okta User Context).
  5. בוחרים באפשרות API של צד שלישי בתור סוג המקור.
  6. בוחרים באפשרות Okta User Context בתור Log type.
  7. לוחצים על הבא.
  8. מציינים ערכים לפרמטרים הבאים של הקלט:

    • כותרת HTTP לאימות: מזינים את פרטי הכניסה לאימות בפורמט הבא:

      Authorization:SSWS your-api-token
      
      • לדוגמה: Authorization:SSWS 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1
    • שם המארח של ה-API: שם הדומיין שמוגדר במלואו של המכונה של Okta (למשל, example.okta.com, ולא דומיין מותאם אישית שאולי הוגדר).

      • לדוגמה: company.okta.com
    • שדה הפניה למזהה מנהל: מזהה שנדרש כשמשתמשים במזהה שאינו של Okta כדי להפנות למנהלים (אופציונלי).

    • מרחב השמות של הנכס: מרחב השמות של הנכס.

    • תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.

  9. לוחצים על הבא.

  10. בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.

אחרי ההגדרה, הפיד מתחיל לאחזר יומנים מהמופע של Okta User Context בסדר כרונולוגי.

נקודות קצה אזוריות

ב-Okta משתמשים בנקודות קצה שונות ל-API בהתאם לאזור של הארגון:

אזור כתובת URL בסיסית / שם מארח
ארה"ב (ברירת מחדל) {org-name}.okta.com
האיחוד האירופי (EMEA) {org-name}.okta-emea.com
אסיה-פסיפיק (APAC) {org-name}.okta.com.au
תצוגה מקדימה (בדיקה) {org-name}.oktapreview.com

משתמשים בשם המארח שתואם לאזור של המכונה של Okta.

מגבלות קצב של יצירת בקשות ל-API

אלה מגבלות הקצב של Okta API:

  • מגבלת קצב ברירת המחדל: 600 בקשות לדקה ברוב נקודות הקצה (endpoints)
  • ‫System Log API: ‏60 בקשות לדקה
  • נקודות קצה (endpoints) של משתמשים: 600 בקשות לדקה

מערכת Google SecOps מטפלת באופן אוטומטי בהגבלת קצב של יצירת בקשות באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff). אם נתקלים בבעיות, פונים לתמיכה של Okta כדי להגדיל את מכסת בקשות ה-API.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
activated event.idm.entity.entity.labels אם activated קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "activated".
created event.idm.entity.entity.labels אם created קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "created".
profile.costCenter event.idm.entity.entity.labels אם profile.costCenter קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "costCenter".
profile.Function event.idm.entity.entity.labels אם profile.Function קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Function".
statusChanged event.idm.entity.entity.labels אם statusChanged קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "statusChanged".
type.id event.idm.entity.entity.labels אם type.id קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "type_id".
profile.location event.idm.entity.entity.location.name הערך נלקח מ-profile.location.
profile.AD_ObjectGUID event.idm.entity.entity.user.attribute.labels אם profile.AD_ObjectGUID קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "AD_ObjectGUID".
profile.ADpwdLastSet event.idm.entity.entity.user.attribute.labels אם profile.ADpwdLastSet קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "ADpwdLastSet".
profile.AFF_Code event.idm.entity.entity.user.attribute.labels אם profile.AFF_Code קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "AFF_Code".
profile.Desk_Location_WD event.idm.entity.entity.user.attribute.labels אם profile.Desk_Location_WD קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Desk_Location_WD".
profile.Mailing_Address_WD event.idm.entity.entity.user.attribute.labels אם profile.Mailing_Address_WD קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Mailing_Address_WD".
profile.Manager_UPN event.idm.entity.entity.user.attribute.labels אם profile.Manager_UPN קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Manager_UPN".
profile.PRIVATE_CONF_Profile event.idm.entity.entity.user.attribute.labels אם profile.PRIVATE_CONF_Profile קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "PRIVATE_CONF_Profile".
profile.Region_WD event.idm.entity.entity.user.attribute.labels אם profile.Region_WD קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Region_WD".
profile.Subsidiary_Company event.idm.entity.entity.user.attribute.labels אם profile.Subsidiary_Company קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח Subsidiary_Company.
profile.Telephone_Work event.idm.entity.entity.user.attribute.labels אם profile.Telephone_Work קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Telephone_Work".
profile.Temp_WD_Primary_Email event.idm.entity.entity.user.attribute.labels אם profile.Temp_WD_Primary_Email קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Temp_WD_Primary_Email".
profile.VMware_WS1_Username event.idm.entity.entity.user.attribute.labels אם profile.VMware_WS1_Username קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "VMware_WS1_Username".
profile.Work_Street_Address_WD event.idm.entity.entity.user.attribute.labels אם profile.Work_Street_Address_WD קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Work_Street_Address_WD".
profile.Workato_WD_Primary_Email event.idm.entity.entity.user.attribute.labels אם profile.Workato_WD_Primary_Email קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Workato_WD_Primary_Email".
profile.Workday_ID event.idm.entity.entity.user.attribute.labels אם profile.Workday_ID קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Workday_ID".
profile.Worker_Type_WD event.idm.entity.entity.user.attribute.labels אם profile.Worker_Type_WD קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "Worker_Type_WD".
profile.businessUnit event.idm.entity.entity.user.attribute.labels אם profile.businessUnit קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "businessUnit".
profile.companyName event.idm.entity.entity.user.attribute.labels אם profile.companyName קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "companyName".
profile.contingentSupplierName event.idm.entity.entity.user.attribute.labels אם profile.contingentSupplierName קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "contingentSupplierName".
profile.conversationId event.idm.entity.entity.user.attribute.labels אם profile.conversationId קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "conversationId".
profile.distinguishedName event.idm.entity.entity.user.attribute.labels אם profile.distinguishedName קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "distinguishedName".
profile.division event.idm.entity.entity.user.attribute.labels אם profile.division קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "division".
profile.emailPrefix event.idm.entity.entity.user.attribute.labels אם profile.emailPrefix קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "emailPrefix".
profile.employeeType event.idm.entity.entity.user.attribute.labels אם profile.employeeType קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "employeeType".
profile.homePostalAddress event.idm.entity.entity.user.attribute.labels אם profile.homePostalAddress קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "homePostalAddress".
profile.isManager event.idm.entity.entity.user.attribute.labels אם profile.isManager קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "isManager".
lastLogin event.idm.entity.entity.user.attribute.labels אם lastLogin קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "lastLogin".
profile.leaveOfAbsence event.idm.entity.entity.user.attribute.labels אם profile.leaveOfAbsence קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "leaveOfAbsence".
profile.managerDn event.idm.entity.entity.user.attribute.labels אם profile.managerDn קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "managerDn".
profile.payGroup event.idm.entity.entity.user.attribute.labels אם profile.payGroup קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "payGroup".
profile.wdemployeeID event.idm.entity.entity.user.attribute.labels אם profile.wdemployeeID קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "wdemployeeID".
profile.zipCode event.idm.entity.entity.user.attribute.labels אם profile.zipCode קיים, הערך שלו מתווסף כצמד מפתח/ערך עם המפתח "zipCode".
profile.userType event.idm.entity.entity.user.attribute.roles אם profile.userType קיים, הערך שלו מתווסף למערך של תפקידים.
profile.organization, profile.company event.idm.entity.entity.user.company_name הערך נלקח מ-profile.organization, או מ-profile.company אם הראשון לא קיים.
profile.department event.idm.entity.entity.user.department הערך נלקח מ-profile.department.
profile.email, profile.secondEmail, profile.login event.idm.entity.entity.user.email_addresses ערכים מ-profile.email, מ-profile.secondEmail ומ-profile.login (אם מדובר בכתובת אימייל ולא בכפילות) מוזגו לשדה הזה.
profile.employeeNumber event.idm.entity.entity.user.employee_id הערך נלקח מ-profile.employeeNumber.
profile.firstName, profile.Preferred_First_Name event.idm.entity.entity.user.first_name הערך נלקח מ-profile.firstName, או מ-profile.Preferred_First_Name אם הראשון לא קיים.
profile.EmployeeWorkGroup event.idm.entity.entity.user.group_identifiers הערך נלקח מ-profile.EmployeeWorkGroup.
profile.HireDate, profile.hiredate event.idm.entity.entity.user.hire_date הערך מנותח מ-profile.HireDate או מ-profile.hiredate אם הראשון לא קיים.
profile.lastName, profile.preferred_Last_Name event.idm.entity.entity.user.last_name הערך נלקח מ-profile.lastName אם profile.lastName או profile.preferred_Last_Name קיימים.
lastLogin event.idm.entity.entity.user.last_login_time הערך מנותח מ-lastLogin.
passwordChanged event.idm.entity.entity.user.last_password_change_time הערך מנותח מ-passwordChanged.
profile.manager, profile.managerEmail, profile.managerId event.idm.entity.entity.user.managers מאוכלס באובייקט שמכיל את user_display_name מ-profile.manager, את email_addresses מ-profile.managerEmail ואת employee_id מ-profile.managerId.
profile.city, profile.firstBaseCity event.idm.entity.entity.user.office_address.city הערך נלקח מ-profile.city, או מ-profile.firstBaseCity אם הראשון לא קיים.
profile.countryCode, profile.country event.idm.entity.entity.user.office_address.country_or_region הערך נלקח מ-profile.countryCode, או מ-profile.country אם הראשון לא קיים.
profile.streetAddress event.idm.entity.entity.user.personal_address.name הערך נלקח מ-profile.streetAddress.
profile.state event.idm.entity.entity.user.personal_address.state הערך נלקח מ-profile.state.
profile.primaryPhone, profile.mobilePhone, profile.mobile event.idm.entity.entity.user.phone_numbers הערכים מהשדות profile.primaryPhone,‏ profile.mobilePhone ו-profile.mobile מוזגו לשדה הזה.
profile.terminationDate, profile.terminationdate event.idm.entity.entity.user.termination_date הערך מנותח מ-profile.terminationDate או מ-profile.terminationdate אם הראשון לא קיים.
profile.title event.idm.entity.entity.user.title הערך נלקח מ-profile.title.
status event.idm.entity.entity.user.user_authentication_status מופה מ-status: ACTIVE/RECOVERY/LOCKED_OUT/PASSWORD_EXPIRED -> ACTIVE; SUSPENDED -> SUSPENDED; DEPROVISIONED -> DELETED; אחרת UNKNOWN_AUTHENTICATION_STATUS.
profile.displayName event.idm.entity.entity.user.user_display_name הערך נלקח מ-profile.displayName.
profile.samAccountName,‏ profile.samaccountname,‏ profile.login,‏ profile.ldapUid event.idm.entity.entity.user.userid מאוכלס לפי סדר הקדימות הבא: profile.samAccountName, profile.samaccountname, profile.login (אם לא מדובר באימייל), profile.ldapUid (אם profile.login לא מדובר באימייל).
event.idm.entity.metadata.entity_type הגדרת הערך USER.
id event.idm.entity.metadata.product_entity_id הערך נלקח מ-id.
event.idm.entity.metadata.product_name הגדרת הערך Identity Cloud.
event.idm.entity.metadata.vendor_name הגדרת הערך Okta.
activated", "created", "statusChanged", and "type.id entity.entity.labels מופה מיומן השינויים
profile.AD_ObjectGUID", "profile.ADpwdLastSet", "profile.AFF_Code", "profile.Desk_Location_WD", "profile.Mailing_Address_WD", "profile.Manager_UPN", "profile.PRIVATE_CONF_Profile", "profile.Region_WD", "profile.Subsidiary_Company", "profile.Telephone_Work", "profile.Temp_WD_Primary_Email", "profile.VMware_WS1_Username", "profile.Work_Street_Address_WD", "profile.Workato_WD_Primary_Email", "profile.Workday_ID", "profile.Worker_Type_WD", "profile.businessUnit", "profile.companyName", "profile.contingentSupplierName", "profile.conversationId", "profile.distinguishedName", "profile.division", "profile.emailPrefix", "profile.employeeType", "profile.homePostalAddress", "profile.isManager", "profile.leaveOfAbsence", "profile.managerDn", "profile.payGroup", "profile.wdemployeeID", and "profile.zipCode entity.entity.user.attribute.labels מופה מיומן השינויים
profile.country entity.user.country מופה מיומן השינויים
profile.firstBaseCity entity.user.firstBaseCity מופה מיומן השינויים
profile.preferred_Last_Name entity.user.preferred_Last_Name מופה מיומן השינויים
profile.EmployeeWorkGroup entity.user.EmployeeWorkGroup מופה מיומן השינויים
profile.manager entity.user.managers.user_display_name מופה מיומן השינויים
profile.organization entity.user.organization מופה מיומן השינויים
profile.state entity.user.state מופה מיומן השינויים
profile.streetAddress entity.user.streetAddress מופה מיומן השינויים
profile.mobile entity.user.mobile מופה מיומן השינויים
profile.managerEmail entity.user.managers.email_addresses מופה מיומן השינויים
profile.managerId entity.user.managers.employee_id מופה מיומן השינויים
profile.spotify_username entity.entity.labels מופה מיומן השינויים

יומן שינויים

הצגת יומן השינויים של המנתח הזה

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.