Recopila registros de contexto de usuario de Okta

Compatible con:

En este documento, se explica cómo recopilar registros de contexto de usuario de Okta configurando un feed de Google Security Operations con la API de terceros.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Acceso con privilegios al inquilino o a la consola de administrador de Okta
  • Privilegios de creación de tokens de API en Okta

Configura la lista de IPs permitidas

Antes de crear el feed, debes agregar los rangos de IP de Google SecOps a la lista de entidades permitidas en la configuración de red o firewall de Okta.

Obtén los rangos de IP de Google SecOps

Agrega rangos de IP al contexto de usuario de Okta

  1. Accede a la Consola del administrador de Okta.
  2. Ve a Seguridad > Redes.
  3. En Restricciones de direcciones IP, haz clic en Editar.
  4. Agrega cada rango de IP de Google SecOps en notación CIDR a las direcciones IP de confianza.
  5. Haz clic en Guardar.

Configura el acceso a la API de User Context de Okta

Para permitir que Google SecOps extraiga datos de contexto del usuario, debes crear un token de API con permisos de lectura.

Crea un token de API

  1. Accede a la Consola del administrador de Okta.
  2. Ve a Seguridad > API.
  3. Selecciona la pestaña Tokens.
  4. Haz clic en Crear token.
  5. Proporciona los siguientes detalles de configuración:
    • Nombre: Ingresa un nombre descriptivo (por ejemplo, Google SecOps Integration).
    • Descripción (opcional): Ingresa una descripción.
  6. Haz clic en Crear token.

Registra las credenciales de la API

Después de crear el token de API, recibirás la siguiente credencial:

  • Token de API: Es el valor de tu token de API (por ejemplo, 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1).

Permisos de API necesarios

El token de la API requiere los siguientes permisos en Okta:

Permiso/rol Nivel de acceso Objetivo
Administrador con acceso de solo lectura Leer Accede a los datos del perfil de usuario
Administrador avanzado Leer Acceso completo a todos los datos del usuario

Cómo configurar feeds

Para configurar un feed, sigue estos pasos:

  1. Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
  2. Haz clic en Agregar feed nuevo.
  3. En la página siguiente, haz clic en Configurar un solo feed.
  4. En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo, Okta User Context).
  5. Selecciona API de terceros como Tipo de fuente.
  6. Selecciona Contexto del usuario de Okta como el Tipo de registro.
  7. Haz clic en Siguiente.
  8. Especifica valores para los siguientes parámetros de entrada:

    • Encabezado HTTP de autenticación: Ingresa las credenciales de autenticación en el siguiente formato:

      Authorization:SSWS your-api-token
      
      • Por ejemplo: Authorization:SSWS 00QCGr-1d1d1d1d1d1d1d1d1d1d1d1d1d1d1d1
    • Nombre de host de la API: Es el nombre de dominio completamente calificado de tu instancia de Okta (p.ej., example.okta.com, no un dominio personalizado que se pueda configurar).

      • Por ejemplo: company.okta.com
    • Campo de referencia del ID del administrador: Es el ID que se requiere cuando usas un ID que no es de Okta para hacer referencia a los administradores (opcional).

    • Espacio de nombres del recurso: Es el espacio de nombres del recurso.

    • Etiquetas de transferencia: Es la etiqueta que se aplicará a los eventos de este feed.

  9. Haz clic en Siguiente.

  10. Revisa la configuración de tu feed de noticias nuevo en la pantalla Finalizar y, luego, haz clic en Enviar.

Después de la configuración, el feed comienza a recuperar registros de la instancia de contexto de usuario de Okta en orden cronológico.

Extremos regionales

Okta usa diferentes endpoints de API según la región de tu organización:

Región URL base o nombre de host
EE.UU. (predeterminado) {org-name}.okta.com
UE (EMEA) {org-name}.okta-emea.com
APAC {org-name}.okta.com.au
Versión preliminar (pruebas) {org-name}.oktapreview.com

Usa el nombre de host que corresponda a la región de tu instancia de Okta.

Límites de frecuencia de la API

La API de Okta tiene los siguientes límites de frecuencia:

  • Límite de frecuencia predeterminado: 600 solicitudes por minuto para la mayoría de los extremos
  • API de registro del sistema: 60 solicitudes por minuto
  • Extremos de usuario: 600 solicitudes por minuto

Google SecOps controla automáticamente la límite de frecuencia con retirada exponencial. Si tienes problemas, comunícate con el equipo de asistencia de Okta para aumentar tus límites de API.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
activated event.idm.entity.entity.labels Si activated existe, su valor se agrega como un par clave-valor con la clave "activated".
created event.idm.entity.entity.labels Si existe created, su valor se agrega como un par clave-valor con la clave "created".
profile.costCenter event.idm.entity.entity.labels Si existe profile.costCenter, su valor se agrega como un par clave-valor con la clave "costCenter".
profile.Function event.idm.entity.entity.labels Si existe profile.Function, su valor se agrega como un par clave-valor con la clave "Function".
statusChanged event.idm.entity.entity.labels Si existe statusChanged, su valor se agrega como un par clave-valor con la clave "statusChanged".
type.id event.idm.entity.entity.labels Si existe type.id, su valor se agrega como un par clave-valor con la clave "type_id".
profile.location event.idm.entity.entity.location.name El valor se toma de profile.location.
profile.AD_ObjectGUID event.idm.entity.entity.user.attribute.labels Si existe profile.AD_ObjectGUID, su valor se agrega como un par clave-valor con la clave "AD_ObjectGUID".
profile.ADpwdLastSet event.idm.entity.entity.user.attribute.labels Si existe profile.ADpwdLastSet, su valor se agrega como un par clave-valor con la clave "ADpwdLastSet".
profile.AFF_Code event.idm.entity.entity.user.attribute.labels Si existe profile.AFF_Code, su valor se agrega como un par clave-valor con la clave "AFF_Code".
profile.Desk_Location_WD event.idm.entity.entity.user.attribute.labels Si existe profile.Desk_Location_WD, su valor se agrega como un par clave-valor con la clave "Desk_Location_WD".
profile.Mailing_Address_WD event.idm.entity.entity.user.attribute.labels Si existe profile.Mailing_Address_WD, su valor se agrega como un par clave-valor con la clave "Mailing_Address_WD".
profile.Manager_UPN event.idm.entity.entity.user.attribute.labels Si profile.Manager_UPN existe, su valor se agrega como un par clave-valor con la clave "Manager_UPN".
profile.PRIVATE_CONF_Profile event.idm.entity.entity.user.attribute.labels Si existe profile.PRIVATE_CONF_Profile, su valor se agrega como un par clave-valor con la clave "PRIVATE_CONF_Profile".
profile.Region_WD event.idm.entity.entity.user.attribute.labels Si existe profile.Region_WD, su valor se agrega como un par clave-valor con la clave "Region_WD".
profile.Subsidiary_Company event.idm.entity.entity.user.attribute.labels Si existe profile.Subsidiary_Company, su valor se agrega como un par clave-valor con la clave "Subsidiary_Company".
profile.Telephone_Work event.idm.entity.entity.user.attribute.labels Si existe profile.Telephone_Work, su valor se agrega como un par clave-valor con la clave "Telephone_Work".
profile.Temp_WD_Primary_Email event.idm.entity.entity.user.attribute.labels Si existe profile.Temp_WD_Primary_Email, su valor se agrega como un par clave-valor con la clave "Temp_WD_Primary_Email".
profile.VMware_WS1_Username event.idm.entity.entity.user.attribute.labels Si existe profile.VMware_WS1_Username, su valor se agrega como un par clave-valor con la clave "VMware_WS1_Username".
profile.Work_Street_Address_WD event.idm.entity.entity.user.attribute.labels Si existe profile.Work_Street_Address_WD, su valor se agrega como un par clave-valor con la clave "Work_Street_Address_WD".
profile.Workato_WD_Primary_Email event.idm.entity.entity.user.attribute.labels Si profile.Workato_WD_Primary_Email existe, su valor se agrega como un par clave-valor con la clave "Workato_WD_Primary_Email".
profile.Workday_ID event.idm.entity.entity.user.attribute.labels Si profile.Workday_ID existe, su valor se agrega como un par clave-valor con la clave "Workday_ID".
profile.Worker_Type_WD event.idm.entity.entity.user.attribute.labels Si existe profile.Worker_Type_WD, su valor se agrega como un par clave-valor con la clave "Worker_Type_WD".
profile.businessUnit event.idm.entity.entity.user.attribute.labels Si existe profile.businessUnit, su valor se agrega como un par clave-valor con la clave "businessUnit".
profile.companyName event.idm.entity.entity.user.attribute.labels Si profile.companyName existe, su valor se agrega como un par clave-valor con la clave "companyName".
profile.contingentSupplierName event.idm.entity.entity.user.attribute.labels Si existe profile.contingentSupplierName, su valor se agrega como un par clave-valor con la clave "contingentSupplierName".
profile.conversationId event.idm.entity.entity.user.attribute.labels Si existe profile.conversationId, su valor se agrega como un par clave-valor con la clave "conversationId".
profile.distinguishedName event.idm.entity.entity.user.attribute.labels Si existe profile.distinguishedName, su valor se agrega como un par clave-valor con la clave "distinguishedName".
profile.division event.idm.entity.entity.user.attribute.labels Si existe profile.division, su valor se agrega como un par clave-valor con la clave "division".
profile.emailPrefix event.idm.entity.entity.user.attribute.labels Si existe profile.emailPrefix, su valor se agrega como un par clave-valor con la clave "emailPrefix".
profile.employeeType event.idm.entity.entity.user.attribute.labels Si existe profile.employeeType, su valor se agrega como un par clave-valor con la clave "employeeType".
profile.homePostalAddress event.idm.entity.entity.user.attribute.labels Si existe profile.homePostalAddress, su valor se agrega como un par clave-valor con la clave "homePostalAddress".
profile.isManager event.idm.entity.entity.user.attribute.labels Si existe profile.isManager, su valor se agrega como un par clave-valor con la clave "isManager".
lastLogin event.idm.entity.entity.user.attribute.labels Si existe lastLogin, su valor se agrega como un par clave-valor con la clave "lastLogin".
profile.leaveOfAbsence event.idm.entity.entity.user.attribute.labels Si existe profile.leaveOfAbsence, su valor se agrega como un par clave-valor con la clave "leaveOfAbsence".
profile.managerDn event.idm.entity.entity.user.attribute.labels Si profile.managerDn existe, su valor se agrega como un par clave-valor con la clave "managerDn".
profile.payGroup event.idm.entity.entity.user.attribute.labels Si existe profile.payGroup, su valor se agrega como un par clave-valor con la clave "payGroup".
profile.wdemployeeID event.idm.entity.entity.user.attribute.labels Si profile.wdemployeeID existe, su valor se agrega como un par clave-valor con la clave "wdemployeeID".
profile.zipCode event.idm.entity.entity.user.attribute.labels Si existe profile.zipCode, su valor se agrega como un par clave-valor con la clave "zipCode".
profile.userType event.idm.entity.entity.user.attribute.roles Si profile.userType existe, su valor se agrega a un array de roles.
profile.organization, profile.company event.idm.entity.entity.user.company_name Es el valor tomado de profile.organization o profile.company si el primero no está presente.
profile.department event.idm.entity.entity.user.department El valor se toma de profile.department.
profile.email, profile.secondEmail, profile.login event.idm.entity.entity.user.email_addresses Los valores de profile.email, profile.secondEmail y profile.login (si es un correo electrónico y no un duplicado) se combinan en este campo.
profile.employeeNumber event.idm.entity.entity.user.employee_id El valor se toma de profile.employeeNumber.
profile.firstName, profile.Preferred_First_Name event.idm.entity.entity.user.first_name Es el valor tomado de profile.firstName o profile.Preferred_First_Name si el primero no está presente.
profile.EmployeeWorkGroup event.idm.entity.entity.user.group_identifiers El valor se toma de profile.EmployeeWorkGroup.
profile.HireDate, profile.hiredate event.idm.entity.entity.user.hire_date El valor se analiza desde profile.HireDate o profile.hiredate si el primero no está presente.
profile.lastName, profile.preferred_Last_Name event.idm.entity.entity.user.last_name El valor se toma de profile.lastName si existe profile.lastName o profile.preferred_Last_Name.
lastLogin event.idm.entity.entity.user.last_login_time El valor se analiza desde lastLogin.
passwordChanged event.idm.entity.entity.user.last_password_change_time El valor se analiza desde passwordChanged.
profile.manager, profile.managerEmail, profile.managerId event.idm.entity.entity.user.managers Se propaga con un objeto que contiene user_display_name de profile.manager, email_addresses de profile.managerEmail y employee_id de profile.managerId.
profile.city, profile.firstBaseCity event.idm.entity.entity.user.office_address.city Es el valor tomado de profile.city o profile.firstBaseCity si el primero no está presente.
profile.countryCode, profile.country event.idm.entity.entity.user.office_address.country_or_region Es el valor tomado de profile.countryCode o profile.country si el primero no está presente.
profile.streetAddress event.idm.entity.entity.user.personal_address.name El valor se toma de profile.streetAddress.
profile.state event.idm.entity.entity.user.personal_address.state El valor se toma de profile.state.
profile.primaryPhone, profile.mobilePhone, profile.mobile event.idm.entity.entity.user.phone_numbers Los valores de profile.primaryPhone, profile.mobilePhone y profile.mobile se combinan en este campo.
profile.terminationDate, profile.terminationdate event.idm.entity.entity.user.termination_date El valor se analiza desde profile.terminationDate o profile.terminationdate si el primero no está presente.
profile.title event.idm.entity.entity.user.title El valor se toma de profile.title.
status event.idm.entity.entity.user.user_authentication_status Asignado desde status: ACTIVE/RECOVERY/LOCKED_OUT/PASSWORD_EXPIRED -> ACTIVE; SUSPENDED -> SUSPENDED; DEPROVISIONED -> DELETED; de lo contrario, UNKNOWN_AUTHENTICATION_STATUS.
profile.displayName event.idm.entity.entity.user.user_display_name El valor se toma de profile.displayName.
profile.samAccountName, profile.samaccountname, profile.login, profile.ldapUid event.idm.entity.entity.user.userid Se completa con prioridad: profile.samAccountName, profile.samaccountname, profile.login (si no es un correo electrónico), profile.ldapUid (si profile.login no es un correo electrónico).
event.idm.entity.metadata.entity_type Se define en USER.
id event.idm.entity.metadata.product_entity_id El valor se toma de id.
event.idm.entity.metadata.product_name Se define en Identity Cloud.
event.idm.entity.metadata.vendor_name Se define en Okta.
activated", "created", "statusChanged", and "type.id entity.entity.labels Asignado desde el registro de cambios
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 Asignado desde el registro de cambios
profile.country entity.user.country Asignado desde el registro de cambios
profile.firstBaseCity entity.user.firstBaseCity Asignado desde el registro de cambios
profile.preferred_Last_Name entity.user.preferred_Last_Name Asignado desde el registro de cambios
profile.EmployeeWorkGroup entity.user.EmployeeWorkGroup Asignado desde el registro de cambios
profile.manager entity.user.managers.user_display_name Asignado desde el registro de cambios
profile.organization entity.user.organization Asignado desde el registro de cambios
profile.state entity.user.state Asignado desde el registro de cambios
profile.streetAddress entity.user.streetAddress Asignado desde el registro de cambios
profile.mobile entity.user.mobile Asignado desde el registro de cambios
profile.managerEmail entity.user.managers.email_addresses Asignado desde el registro de cambios
profile.managerId entity.user.managers.employee_id Asignado desde el registro de cambios
profile.spotify_username entity.entity.labels Asignado desde el registro de cambios

Registro de cambios

Consulta el registro de cambios de este analizador

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.