Okta-Nutzerkontextprotokolle erfassen
In diesem Dokument wird beschrieben, wie Sie Okta-Nutzerkontextlogs erfassen, indem Sie einen Google Security Operations-Feed mit der Drittanbieter-API einrichten.
Hinweis
Prüfen Sie, ob die folgenden Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Privilegierter Zugriff auf den Okta-Mandanten oder die Admin-Konsole
- Berechtigungen zum Erstellen von API-Tokens in Okta
Zulassungsliste für IP-Adressen konfigurieren
Wenn Ihre Organisation Okta API-Tokens nach IP-Adresse einschränkt, können Sie in Okta eine dedizierte IP-Zone erstellen, die an das Google SecOps API-Token gebunden wird. Wenn Ihre Organisation keine IP-Einschränkungen für API-Tokens benötigt, können Sie diesen Abschnitt überspringen und beim Erstellen des API-Tokens Beliebige IP-Adresse auswählen.
IP-Bereiche zu einer Okta-IP-Zone hinzufügen (optional)
- Melden Sie sich in der Okta Admin-Konsole an.
- Rufen Sie Sicherheit > Netzwerke auf.
- Klicken Sie auf Zone hinzufügen > IP-Zone.
- Geben Sie einen aussagekräftigen Namen für die Zone ein (z. B.
Google SecOps API Token Zone). - Fügen Sie im Feld Gateway-IPs die IP-Bereiche in CIDR-Notation hinzu, die Sie aus der Zulassungsliste für IP-Adressen erhalten haben.
- Lassen Sie das Feld Trusted Proxy IPs (Vertrauenswürdige Proxy-IPs) leer. Fügen Sie hier keine Google-IP-Bereiche hinzu, da Okta vertrauenswürdige Proxys als von ThreatInsight vertrauenswürdig einstuft.
- Achten Sie darauf, dass Zugriff von IP-Adressen blockieren, die den in dieser Zone aufgeführten Bedingungen entsprechen nicht aktiviert ist.
- Klicken Sie auf Speichern.
Nachdem Sie die IP-Zone gespeichert haben:
- ThreatInsight-Ausnahmen prüfen: Gehen Sie zu Sicherheit > Allgemein > Okta ThreatInsight-Einstellungen und prüfen Sie, ob die neu erstellte Zone nicht unter Ausgenommene Zonen aufgeführt ist.
- Richtlinien prüfen: Prüfen Sie, ob bestehende Richtlinien für die Nutzeranmeldung, globale Sitzungsrichtlinien oder andere API-Tokens mit allgemeinen Bedingungen wie In Zone: Alle Zonen oder In einer in Okta definierten Netzwerkzone übereinstimmen, da diese Bedingungen für jede in Ihrer Organisation definierte Zone gelten.
Zugriff auf die Okta User Context API konfigurieren
Damit Google SecOps Nutzerkontextdaten abrufen kann, müssen Sie ein API-Token mit Leseberechtigungen erstellen.
API-Token erstellen
- Melden Sie sich in der Okta Admin-Konsole an.
- Gehen Sie zu Sicherheit > API.
- Wählen Sie den Tab Tokens aus.
- Klicken Sie auf Token erstellen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
Google SecOps Integration). - API-Aufrufe, die mit diesem Token erfolgen, müssen von folgender Quelle stammen:
- Wählen Sie Any IP (Beliebige IP-Adresse) aus (empfohlen, wenn Sie keine IP-Zone erstellt haben) oder
- Wählen Sie In einer der folgenden Zonen und dann die dedizierte IP-Zone aus, die Sie für dieses API-Token erstellt haben. Wählen Sie nicht In any network zone defined in Okta (In einer in Okta definierten Netzwerkzone) aus.
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Klicken Sie auf Token erstellen.
API-Anmeldedaten aufzeichnen
Nachdem Sie das API-Token erstellt haben, erhalten Sie die folgenden Anmeldedaten:
- API-Token: Ihr API-Tokenwert (z. B.
00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1)
Erforderliche API-Berechtigungen
Das API-Token erfordert die folgenden Berechtigungen in Okta:
| Berechtigung/Rolle | Zugriffsebene | Zweck |
|---|---|---|
| Administrator mit Lesezugriff | Lesen | Auf Nutzerprofildaten zugreifen |
| Super Admin | Lesen | Vollständiger Zugriff auf alle Nutzerdaten |
Feeds einrichten
So konfigurieren Sie einen Feed:
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf Neuen Feed hinzufügen.
- Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
Okta User Context. - Wählen Sie Drittanbieter-API als Quelltyp aus.
- Wählen Sie Okta-Nutzerkontext als Protokolltyp aus.
- Klicken Sie auf Weiter.
Geben Sie Werte für die folgenden Eingabeparameter an:
HTTP-Header für die Authentifizierung: Geben Sie die Authentifizierungsdaten im folgenden Format ein:
Authorization:SSWS your-api-token- Beispiel:
Authorization:SSWS 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1
- Beispiel:
API-Hostname: Der voll qualifizierte Domainname Ihrer Okta-Instanz (z.B. beispiel.okta.com, nicht eine benutzerdefinierte Domain, die möglicherweise konfiguriert ist).
- Beispiel:
company.okta.com
- Beispiel:
Referenzfeld für Manager-ID: ID, die erforderlich ist, wenn Sie eine Nicht-Okta-ID verwenden, um auf Manager zu verweisen (optional).
Asset-Namespace: Der Asset-Namespace.
Aufnahmelabels: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
Klicken Sie auf Weiter.
Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.
Nach der Einrichtung ruft der Feed Logs aus der Okta User Context-Instanz in chronologischer Reihenfolge ab.
Regionale Endpunkte
Okta verwendet je nach Region Ihrer Organisation unterschiedliche API-Endpunkte:
| Region | Basis-URL/Hostname |
|---|---|
| US (Standard) | {org-name}.okta.com |
| EU (EMEA) | {org-name}.okta-emea.com |
| Asien/Pazifik (APAC) | {org-name}.okta.com.au |
| Vorabversion (Test) | {org-name}.oktapreview.com |
Verwenden Sie den Hostnamen, der der Region Ihrer Okta-Instanz entspricht.
API-Ratenbegrenzungen
Für die Okta API gelten die folgenden Ratenbegrenzungen:
- Standard-Ratenbegrenzung: 600 Anfragen pro Minute für die meisten Endpunkte
- System Log API: 60 Anfragen pro Minute
- Nutzerendpunkte: 600 Anfragen pro Minute
Google SecOps verarbeitet die Ratenbegrenzung automatisch mit exponentiellem Backoff. Wenn Probleme auftreten, wenden Sie sich an den Okta-Support, um Ihre API-Limits zu erhöhen.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
activated |
event.idm.entity.entity.labels |
Wenn activated vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „activated“ hinzugefügt. |
created |
event.idm.entity.entity.labels |
Wenn created vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „created“ hinzugefügt. |
profile.costCenter |
event.idm.entity.entity.labels |
Wenn profile.costCenter vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „costCenter“ hinzugefügt. |
profile.Function |
event.idm.entity.entity.labels |
Wenn profile.Function vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Function“ hinzugefügt. |
statusChanged |
event.idm.entity.entity.labels |
Wenn statusChanged vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „statusChanged“ hinzugefügt. |
type.id |
event.idm.entity.entity.labels |
Wenn type.id vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „type_id“ hinzugefügt. |
profile.location |
event.idm.entity.entity.location.name |
Wert aus profile.location. |
profile.AD_ObjectGUID |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.AD_ObjectGUID vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „AD_ObjectGUID“ hinzugefügt. |
profile.ADpwdLastSet |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.ADpwdLastSet vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „ADpwdLastSet“ hinzugefügt. |
profile.AFF_Code |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.AFF_Code vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „AFF_Code“ hinzugefügt. |
profile.Desk_Location_WD |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Desk_Location_WD vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Desk_Location_WD“ hinzugefügt. |
profile.Mailing_Address_WD |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Mailing_Address_WD vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Mailing_Address_WD“ hinzugefügt. |
profile.Manager_UPN |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Manager_UPN vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Manager_UPN“ hinzugefügt. |
profile.PRIVATE_CONF_Profile |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.PRIVATE_CONF_Profile vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „PRIVATE_CONF_Profile“ hinzugefügt. |
profile.Region_WD |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Region_WD vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Region_WD“ hinzugefügt. |
profile.Subsidiary_Company |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Subsidiary_Company vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Subsidiary_Company“ hinzugefügt. |
profile.Telephone_Work |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Telephone_Work vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Telephone_Work“ hinzugefügt. |
profile.Temp_WD_Primary_Email |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Temp_WD_Primary_Email vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Temp_WD_Primary_Email“ hinzugefügt. |
profile.VMware_WS1_Username |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.VMware_WS1_Username vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „VMware_WS1_Username“ hinzugefügt. |
profile.Work_Street_Address_WD |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Work_Street_Address_WD vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Work_Street_Address_WD“ hinzugefügt. |
profile.Workato_WD_Primary_Email |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Workato_WD_Primary_Email vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Workato_WD_Primary_Email“ hinzugefügt. |
profile.Workday_ID |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Workday_ID vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Workday_ID“ hinzugefügt. |
profile.Worker_Type_WD |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.Worker_Type_WD vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „Worker_Type_WD“ hinzugefügt. |
profile.businessUnit |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.businessUnit vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „businessUnit“ hinzugefügt. |
profile.companyName |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.companyName vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „companyName“ hinzugefügt. |
profile.contingentSupplierName |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.contingentSupplierName vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „contingentSupplierName“ hinzugefügt. |
profile.conversationId |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.conversationId vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „conversationId“ hinzugefügt. |
profile.distinguishedName |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.distinguishedName vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „distinguishedName“ hinzugefügt. |
profile.division |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.division vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „division“ hinzugefügt. |
profile.emailPrefix |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.emailPrefix vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „emailPrefix“ hinzugefügt. |
profile.employeeType |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.employeeType vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „employeeType“ hinzugefügt. |
profile.homePostalAddress |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.homePostalAddress vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „homePostalAddress“ hinzugefügt. |
profile.isManager |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.isManager vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „isManager“ hinzugefügt. |
lastLogin |
event.idm.entity.entity.user.attribute.labels |
Wenn lastLogin vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „lastLogin“ hinzugefügt. |
profile.leaveOfAbsence |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.leaveOfAbsence vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „leaveOfAbsence“ hinzugefügt. |
profile.managerDn |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.managerDn vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „managerDn“ hinzugefügt. |
profile.payGroup |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.payGroup vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „payGroup“ hinzugefügt. |
profile.wdemployeeID |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.wdemployeeID vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „wdemployeeID“ hinzugefügt. |
profile.zipCode |
event.idm.entity.entity.user.attribute.labels |
Wenn profile.zipCode vorhanden ist, wird der Wert als Schlüssel/Wert-Paar mit dem Schlüssel „zipCode“ hinzugefügt. |
profile.userType |
event.idm.entity.entity.user.attribute.roles |
Wenn profile.userType vorhanden ist, wird der Wert einem Array von Rollen hinzugefügt. |
profile.organization, profile.company |
event.idm.entity.entity.user.company_name |
Wert aus profile.organization oder profile.company, wenn Ersterer nicht vorhanden ist. |
profile.department |
event.idm.entity.entity.user.department |
Wert aus profile.department. |
profile.email, profile.secondEmail, profile.login |
event.idm.entity.entity.user.email_addresses |
Werte aus profile.email, profile.secondEmail und profile.login (wenn es sich um eine E-Mail-Adresse und kein Duplikat handelt) werden in diesem Feld zusammengeführt. |
profile.employeeNumber |
event.idm.entity.entity.user.employee_id |
Wert aus profile.employeeNumber. |
profile.firstName, profile.Preferred_First_Name |
event.idm.entity.entity.user.first_name |
Wert aus profile.firstName oder profile.Preferred_First_Name, wenn Ersterer nicht vorhanden ist. |
profile.EmployeeWorkGroup |
event.idm.entity.entity.user.group_identifiers |
Wert aus profile.EmployeeWorkGroup. |
profile.HireDate, profile.hiredate |
event.idm.entity.entity.user.hire_date |
Der Wert wird aus profile.HireDate oder profile.hiredate geparst, wenn Ersteres nicht vorhanden ist. |
profile.lastName, profile.preferred_Last_Name |
event.idm.entity.entity.user.last_name |
Wert aus profile.lastName, wenn entweder profile.lastName oder profile.preferred_Last_Name vorhanden ist. |
lastLogin |
event.idm.entity.entity.user.last_login_time |
Der Wert wird aus lastLogin geparst. |
passwordChanged |
event.idm.entity.entity.user.last_password_change_time |
Der Wert wird aus passwordChanged geparst. |
profile.manager, profile.managerEmail, profile.managerId |
event.idm.entity.entity.user.managers |
Wird mit einem Objekt gefüllt, das user_display_name aus profile.manager, email_addresses aus profile.managerEmail und employee_id aus profile.managerId enthält. |
profile.city, profile.firstBaseCity |
event.idm.entity.entity.user.office_address.city |
Wert aus profile.city oder profile.firstBaseCity, wenn Ersterer nicht vorhanden ist. |
profile.countryCode, profile.country |
event.idm.entity.entity.user.office_address.country_or_region |
Wert aus profile.countryCode oder profile.country, wenn Ersterer nicht vorhanden ist. |
profile.streetAddress |
event.idm.entity.entity.user.personal_address.name |
Wert aus profile.streetAddress. |
profile.state |
event.idm.entity.entity.user.personal_address.state |
Wert aus profile.state. |
profile.primaryPhone, profile.mobilePhone, profile.mobile |
event.idm.entity.entity.user.phone_numbers |
Werte aus profile.primaryPhone, profile.mobilePhone und profile.mobile werden in diesem Feld zusammengeführt. |
profile.terminationDate, profile.terminationdate |
event.idm.entity.entity.user.termination_date |
Der Wert wird aus profile.terminationDate oder profile.terminationdate geparst, wenn Ersteres nicht vorhanden ist. |
profile.title |
event.idm.entity.entity.user.title |
Wert aus profile.title. |
status |
event.idm.entity.entity.user.user_authentication_status |
Zugeordnet von status: ACTIVE/RECOVERY/LOCKED_OUT/PASSWORD_EXPIRED -> ACTIVE; SUSPENDED -> SUSPENDED; DEPROVISIONED -> DELETED; andernfalls UNKNOWN_AUTHENTICATION_STATUS. |
profile.displayName |
event.idm.entity.entity.user.user_display_name |
Wert aus profile.displayName. |
profile.samAccountName, profile.samaccountname, profile.login, profile.ldapUid |
event.idm.entity.entity.user.userid |
Wird in folgender Reihenfolge ausgefüllt: profile.samAccountName, profile.samaccountname, profile.login (wenn es sich nicht um eine E-Mail-Adresse handelt), profile.ldapUid (wenn profile.login keine E-Mail-Adresse ist). |
event.idm.entity.metadata.entity_type |
Legen Sie USER fest. |
|
id |
event.idm.entity.metadata.product_entity_id |
Wert aus id. |
event.idm.entity.metadata.product_name |
Legen Sie Identity Cloud fest. |
|
event.idm.entity.metadata.vendor_name |
Legen Sie Okta fest. |
|
activated", "created", "statusChanged", and "type.id |
entity.entity.labels |
Aus Änderungsprotokoll zugeordnet |
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 |
Aus Änderungsprotokoll zugeordnet |
profile.country |
entity.user.country |
Aus Änderungsprotokoll zugeordnet |
profile.firstBaseCity |
entity.user.firstBaseCity |
Aus Änderungsprotokoll zugeordnet |
profile.preferred_Last_Name |
entity.user.preferred_Last_Name |
Aus Änderungsprotokoll zugeordnet |
profile.EmployeeWorkGroup |
entity.user.EmployeeWorkGroup |
Aus Änderungsprotokoll zugeordnet |
profile.manager |
entity.user.managers.user_display_name |
Aus Änderungsprotokoll zugeordnet |
profile.organization |
entity.user.organization |
Aus Änderungsprotokoll zugeordnet |
profile.state |
entity.user.state |
Aus Änderungsprotokoll zugeordnet |
profile.streetAddress |
entity.user.streetAddress |
Aus Änderungsprotokoll zugeordnet |
profile.mobile |
entity.user.mobile |
Aus Änderungsprotokoll zugeordnet |
profile.managerEmail |
entity.user.managers.email_addresses |
Aus Änderungsprotokoll zugeordnet |
profile.managerId |
entity.user.managers.employee_id |
Aus Änderungsprotokoll zugeordnet |
profile.spotify_username |
entity.entity.labels |
Aus Änderungsprotokoll zugeordnet |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten