Recopila registros de Oracle NetSuite - NetSuite Applications Suite
En este documento, se explica cómo transferir registros de Oracle NetSuite - NetSuite Applications Suite a Google Security Operations con Google Cloud Storage V2.
Oracle NetSuite es una plataforma de planificación de recursos empresariales (ERP) basada en la nube que proporciona capacidades integrales de administración empresarial, incluidas la administración financiera, la administración de relaciones con clientes (CRM), el comercio electrónico y la administración de inventario. NetSuite genera registros de auditoría extensos, incluidos los registros de acceso de los usuarios, las notas del sistema que hacen un seguimiento de los cambios en los registros y los registros de acceso a la API que se pueden recuperar a través de la API de REST de SuiteQL para fines de supervisión de seguridad y cumplimiento.
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos previos:
- Una instancia de Google SecOps
- Un proyecto de GCP con las APIs de Cloud Storage, Cloud Run, Pub/Sub y Cloud Scheduler habilitadas
- Permisos para crear y administrar buckets de GCS
- Permisos para administrar políticas de IAM en buckets de GCS
- Permisos para crear servicios de Cloud Run, temas de Pub/Sub y trabajos de Cloud Scheduler
- Una cuenta de NetSuite con acceso de administrador
- Servicios web de REST de NetSuite habilitados
- Permisos para crear registros de integración y tokens de acceso en NetSuite
Configura el acceso a la API de NetSuite
Para habilitar la recopilación de registros a través de la API de REST de SuiteQL, debes habilitar los servicios web de REST, crear un registro de integración y generar credenciales de autenticación basada en tokens (TBA) en NetSuite.
Habilita las funciones de NetSuite requeridas
- Accede a tu cuenta de NetSuite como administrador.
- Ve a Setup > Company > Enable Features.
- Haz clic en la pestaña SuiteCloud.
- En la sección SuiteScript, marca las siguientes casillas:
- SuiteScript del cliente
- Server SuiteScript
- En la sección SuiteTalk (Web Services), marca la siguiente casilla:
- Servicios web de REST
- En la sección Administrar autenticación, marca la casilla Autenticación basada en tokens.
- Haz clic en Acepto en la página de Condiciones del Servicio de SuiteCloud.
- Haz clic en Guardar.
Crea un registro de integración
- En NetSuite, ve a Configuración > Integración > Administrar integraciones > Nueva.
- En el campo Nombre, ingresa
Google SecOps Integration. - En el campo Descripción, ingresa
Integration for Google Security Operations log collection. - En el campo Estado, deja seleccionada la opción predeterminada Habilitado.
- Haz clic en la pestaña Autenticación.
- En la sección Autenticación basada en tokens, marca la casilla Autenticación basada en tokens.
- Deja desmarcada la casilla TBA: Authorization Flow.
- Marca la casilla TBA: ISSUETOKEN ENDPOINT.
- Haz clic en Guardar.
En la página de confirmación, copia y guarda la clave de consumidor/ID de cliente y el secreto de consumidor/secreto del cliente.
Crea un rol personalizado para el acceso a la API
- Ve a Configuración > Usuarios/Roles > Administrar roles > Nuevo.
- En el campo Nombre, ingresa
Google SecOps API Role. - En el campo ID, ingresa
google_secops_api_role. - Haz clic en la pestaña secundaria Permisos.
- Haz clic en la pestaña secundaria Configuración.
- Agrega los siguientes permisos con el nivel de acceso Completo:
- Accede con tokens de acceso
- Tokens de acceso de usuario
- Servicios web de REST
- Haz clic en la pestaña secundaria Informes.
- Agrega los siguientes permisos con el nivel de acceso Ver:
- SuiteAnalytics Workbook
- Haz clic en la pestaña secundaria Listas.
- Agrega los siguientes permisos con el nivel de acceso Ver:
- Registro de auditoría de acceso
- Haz clic en Guardar.
Asigna el rol a un usuario
- Ve a Lists > Employees > Employees.
- Selecciona la cuenta de usuario que se usará para la integración (o crea un nuevo usuario de integración dedicado).
- Haz clic en Editar.
- Haz clic en la pestaña Acceso.
- En la sección Roles, haz clic en Agregar.
- Selecciona Rol de la API de Google SecOps en la lista desplegable.
- Haz clic en Guardar.
Crea un token de acceso
- Accede a NetSuite como el usuario al que se le asignó el rol de la API de Google SecOps.
- Ve a Setup > Users/Roles > Access Tokens > New.
- En la página Token de acceso, haz lo siguiente:
- En la lista desplegable Nombre de la aplicación, selecciona Integración de Google SecOps.
- En la lista desplegable Usuario, selecciona la cuenta de usuario a la que se le asignó el rol de la API de Google SecOps.
- En la lista desplegable Rol, selecciona Rol de la API de Google SecOps.
- El campo Nombre del token se completa automáticamente. Puedes modificarlo si lo prefieres.
- Haz clic en Guardar.
En la página de confirmación, copia y guarda el ID de token y el Secreto de token.
Cómo encontrar tu ID de cuenta de NetSuite
- En NetSuite, ve a Configuración > Empresa > Información de la empresa.
- Busca el campo ID de cuenta (se muestra debajo del parámetro de configuración Zona horaria).
- Copia y guarda tu ID de cuenta (por ejemplo,
1234567o1234567_SB1para cuentas de zona de pruebas).
Verifica los permisos
Para verificar que la cuenta tenga los permisos necesarios, sigue estos pasos:
- Accede a NetSuite con el usuario al que se le asignó el rol de la API de Google SecOps.
- Ve a Setup > Users/Roles > View Login Audit Trail.
- Si puedes ver la página Registro de auditoría de acceso, la cuenta tiene los permisos necesarios.
- Si no ves esta opción, comunícate con tu administrador de NetSuite para que te otorgue el permiso Registro de auditoría de acceso en la pestaña secundaria Listas.
Prueba el acceso a la API
Prueba tus credenciales antes de continuar con la integración:
# Replace with your actual values ACCOUNT_ID="your-account-id" # Replace underscores with hyphens in the account ID for the URL # For example: 1234567_SB1 becomes 1234567-sb1 URL_ACCOUNT_ID=$(echo "$ACCOUNT_ID" | tr '_' '-' | tr '[:upper:]' '[:lower:]') CONSUMER_KEY="your-consumer-key" CONSUMER_SECRET="your-consumer-secret" TOKEN_ID="your-token-id" TOKEN_SECRET="your-token-secret" # Test SuiteQL API access using OAuth 1.0 TBA # Note: This example requires the oauth1 CLI tool or Postman. # Use the following endpoint and headers to verify connectivity: # POST https://${URL_ACCOUNT_ID}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql?limit=5 # Headers: # Authorization: OAuth (with consumer key, token, HMAC-SHA256 signature) # Content-Type: application/json # Prefer: transient # Body: {"q": "SELECT id, date, status, user, emailaddress FROM LoginAudit ORDER BY date DESC"}
Una respuesta correcta devuelve un objeto JSON que contiene registros de LoginAudit.
Crea un bucket de Google Cloud Storage
- Ve a la consola de Google Cloud.
- Selecciona tu proyecto o crea uno nuevo.
- En el menú de navegación, ve a Cloud Storage > Buckets.
- Haz clic en Crear bucket.
Proporciona los siguientes detalles de configuración:
Parámetro de configuración Valor Asigna un nombre a tu bucket Ingresa un nombre único a nivel global (por ejemplo, netsuite-audit-logs).Tipo de ubicación Elige una en función de tus necesidades (región, birregional o multirregional). Ubicación Selecciona la ubicación (por ejemplo, us-central1).Clase de almacenamiento Estándar (recomendado para los registros a los que se accede con frecuencia) Control de acceso Uniforme (recomendado) Herramientas de protección Opcional: Habilita el control de versiones de objetos o la política de retención Haz clic en Crear.
Crea una cuenta de servicio para la función de Cloud Run
La función de Cloud Run necesita una cuenta de servicio con permisos para escribir en el bucket de GCS y que Pub/Sub la invoque.
Crear cuenta de servicio
- En Google Cloud Console, ve a IAM y administración > Cuentas de servicio.
- Haz clic en Crear cuenta de servicio.
- Proporciona los siguientes detalles de configuración:
- Nombre de la cuenta de servicio: Ingresa
netsuite-audit-collector-sa - Descripción de la cuenta de servicio: Ingresa
Service account for Cloud Run function to collect NetSuite audit logs
- Nombre de la cuenta de servicio: Ingresa
- Haz clic en Crear y continuar.
- En la sección Otorga acceso al proyecto a esta cuenta de servicio, agrega los siguientes roles:
- Haz clic en Selecciona un rol.
- Busca y selecciona Administrador de objetos de Storage.
- Haz clic en + Agregar otro rol.
- Busca y selecciona Invocador de Cloud Run.
- Haz clic en + Agregar otro rol.
- Busca y selecciona Invocador de Cloud Functions.
- Haz clic en Continuar.
- Haz clic en Listo.
Estos roles son necesarios para lo siguiente:
- Administrador de objetos de Storage: Escribe registros en el bucket de GCS y administra archivos de estado
- Invocador de Cloud Run: Permite que Pub/Sub invoque la función
- Invocador de Cloud Functions: Permite la invocación de funciones
Otorga permisos de IAM en el bucket de GCS
- Ve a Cloud Storage > Buckets.
- Haz clic en el nombre del bucket (
netsuite-audit-logs). - Ve a la pestaña Permisos.
- Haz clic en Otorgar acceso.
- Proporciona los siguientes detalles de configuración:
- Agregar principales: Ingresa el correo electrónico de la cuenta de servicio (
netsuite-audit-collector-sa@PROJECT_ID.iam.gserviceaccount.com). - Asignar roles: Selecciona Administrador de objetos de Storage
- Agregar principales: Ingresa el correo electrónico de la cuenta de servicio (
- Haz clic en Guardar.
Crear tema de Pub/Sub
- En Google Cloud Console, ve a Pub/Sub > Temas.
- Haz clic en Crear tema.
- Proporciona los siguientes detalles de configuración:
- ID del tema: Ingresa
netsuite-audit-trigger - Deja el resto de la configuración con sus valores predeterminados.
- ID del tema: Ingresa
- Haz clic en Crear.
Crea una función de Cloud Run para recopilar registros
La función de Cloud Run se activará con mensajes de Pub/Sub de Cloud Scheduler para recuperar registros de la API de REST de NetSuite SuiteQL y escribirlos en GCS.
- En Google Cloud Console, ve a Cloud Run.
- Haz clic en Crear servicio.
- Selecciona Función (usa un editor directo para crear una función).
En la sección Configurar, proporciona los siguientes detalles de configuración:
Parámetro de configuración Valor Nombre del servicio netsuite-audit-collectorRegión Selecciona la región que coincida con tu bucket de GCS (por ejemplo, us-central1).Tiempo de ejecución Selecciona Python 3.12 o una versión posterior. En la sección Activador (opcional), haz lo siguiente:
- Haz clic en + Agregar activador.
- Selecciona Cloud Pub/Sub.
- En Selecciona un tema de Cloud Pub/Sub, elige
netsuite-audit-trigger. - Haz clic en Guardar.
En la sección Autenticación, haz lo siguiente:
- Selecciona Necesita autenticación.
- Verifica la Administración de identidades y accesos (IAM).
Desplázate hacia abajo y expande Contenedores, redes y seguridad.
Ve a la pestaña Seguridad:
- Cuenta de servicio: Selecciona
netsuite-audit-collector-sa
- Cuenta de servicio: Selecciona
Ve a la pestaña Contenedores:
- Haz clic en Variables y secretos.
- Haz clic en + Agregar variable para cada variable de entorno:
Nombre de la variable Valor de ejemplo Descripción GCS_BUCKETnetsuite-audit-logsNombre del bucket de GCS GCS_PREFIXnetsuite-auditPrefijo para los archivos de registro STATE_KEYnetsuite-audit/state.jsonRuta de acceso al archivo de estado NS_ACCOUNT_ID1234567ID de cuenta de NetSuite NS_CONSUMER_KEYyour-consumer-keyClave de consumidor del registro de integración NS_CONSUMER_SECRETyour-consumer-secretSecreto del consumidor del registro de integración NS_TOKEN_IDyour-token-idID de token del token de acceso NS_TOKEN_SECRETyour-token-secretSecreto del token de acceso MAX_RECORDS10000Cantidad máxima de registros por ejecución PAGE_SIZE1000Registros por página de SuiteQL LOOKBACK_HOURS24Período de visualización inicial En la sección Variables y Secrets, desplázate hacia abajo hasta Solicitudes:
- Tiempo de espera de la solicitud: Ingresa
600segundos (10 minutos).
- Tiempo de espera de la solicitud: Ingresa
Ve a la pestaña Configuración:
- En la sección Recursos, haz lo siguiente:
- Memoria: Selecciona 512 MiB o más.
- CPU: Selecciona 1.
- En la sección Recursos, haz lo siguiente:
En la sección Escalamiento de revisión, haz lo siguiente:
- Cantidad mínima de instancias: Ingresa
0. - Cantidad máxima de instancias: Ingresa
100.
- Cantidad mínima de instancias: Ingresa
Haz clic en Crear.
Espera a que se cree el servicio (de 1 a 2 minutos).
Después de crear el servicio, se abrirá automáticamente el editor de código intercalado.
Agregar el código de función
- Ingresa main en el campo Punto de entrada.
En el editor de código intercalado, crea dos archivos:
- main.py:
import functions_framework from google.cloud import storage import json import os import urllib3 import hashlib import hmac import base64 import time import secrets import urllib.parse from datetime import datetime, timezone, timedelta # Initialize HTTP client with timeouts http = urllib3.PoolManager( timeout=urllib3.Timeout(connect=10.0, read=60.0), retries=False, ) # Initialize Storage client storage_client = storage.Client() # Environment variables GCS_BUCKET = os.environ.get('GCS_BUCKET') GCS_PREFIX = os.environ.get('GCS_PREFIX', 'netsuite-audit') STATE_KEY = os.environ.get('STATE_KEY', 'netsuite-audit/state.json') NS_ACCOUNT_ID = os.environ.get('NS_ACCOUNT_ID') NS_CONSUMER_KEY = os.environ.get('NS_CONSUMER_KEY') NS_CONSUMER_SECRET = os.environ.get('NS_CONSUMER_SECRET') NS_TOKEN_ID = os.environ.get('NS_TOKEN_ID') NS_TOKEN_SECRET = os.environ.get('NS_TOKEN_SECRET') MAX_RECORDS = int(os.environ.get('MAX_RECORDS', '10000')) PAGE_SIZE = int(os.environ.get('PAGE_SIZE', '1000')) LOOKBACK_HOURS = int(os.environ.get('LOOKBACK_HOURS', '24')) def get_netsuite_base_url(account_id): """Build the NetSuite REST API base URL from the account ID.""" url_account = account_id.replace('_', '-').lower() return f"https://{url_account}.suitetalk.api.netsuite.com" def generate_oauth_header(method, url, account_id, consumer_key, consumer_secret, token_id, token_secret): """Generate OAuth 1.0 Authorization header using HMAC-SHA256.""" timestamp = str(int(time.time())) nonce = secrets.token_hex(16) # Parse URL to separate base URL and query parameters parsed = urllib.parse.urlparse(url) base_url = f"{parsed.scheme}://{parsed.netloc}{parsed.path}" query_params = urllib.parse.parse_qs(parsed.query, keep_blank_values=True) # Build parameter string (OAuth params + query params) params = { 'oauth_consumer_key': consumer_key, 'oauth_token': token_id, 'oauth_nonce': nonce, 'oauth_timestamp': timestamp, 'oauth_signature_method': 'HMAC-SHA256', 'oauth_version': '1.0', } for key, values in query_params.items(): params[key] = values[0] # Sort parameters and create parameter string sorted_params = sorted(params.items()) param_string = '&'.join( f"{urllib.parse.quote(k, safe='')}={urllib.parse.quote(v, safe='')}" for k, v in sorted_params ) # Create signature base string signature_base = ( f"{method.upper()}&" f"{urllib.parse.quote(base_url, safe='')}&" f"{urllib.parse.quote(param_string, safe='')}" ) # Create signing key signing_key = ( f"{urllib.parse.quote(consumer_secret, safe='')}&" f"{urllib.parse.quote(token_secret, safe='')}" ) # Generate HMAC-SHA256 signature signature = base64.b64encode( hmac.new( signing_key.encode('utf-8'), signature_base.encode('utf-8'), hashlib.sha256 ).digest() ).decode('utf-8') # Build realm from account ID realm = account_id.replace('-', '_').upper() # Build Authorization header auth_header = ( f'OAuth realm="{realm}",' f'oauth_consumer_key="{consumer_key}",' f'oauth_token="{token_id}",' f'oauth_nonce="{nonce}",' f'oauth_timestamp="{timestamp}",' f'oauth_signature_method="HMAC-SHA256",' f'oauth_version="1.0",' f'oauth_signature="{urllib.parse.quote(signature, safe="")}"' ) return auth_header @functions_framework.cloud_event def main(cloud_event): """ Cloud Run function triggered by Pub/Sub to fetch NetSuite LoginAudit logs via SuiteQL and write to GCS. """ if not all([GCS_BUCKET, NS_ACCOUNT_ID, NS_CONSUMER_KEY, NS_CONSUMER_SECRET, NS_TOKEN_ID, NS_TOKEN_SECRET]): print('Error: Missing required environment variables') return try: bucket = storage_client.bucket(GCS_BUCKET) state = load_state(bucket) now = datetime.now(timezone.utc) if isinstance(state, dict) and state.get('last_event_time'): try: last_val = state['last_event_time'] if last_val.endswith('Z'): last_val = last_val[:-1] + '+00:00' last_time = datetime.fromisoformat(last_val) last_time = last_time - timedelta(minutes=2) except Exception as e: print(f"Warning: Could not parse last_event_time: {e}") last_time = now - timedelta(hours=LOOKBACK_HOURS) else: last_time = now - timedelta(hours=LOOKBACK_HOURS) print(f"Fetching logs from {last_time.isoformat()} to {now.isoformat()}") records, newest_time = fetch_login_audit(last_time, now) if not records: print("No new log records found.") save_state(bucket, now.isoformat()) return timestamp = now.strftime('%Y%m%d_%H%M%S') object_key = f"{GCS_PREFIX}/netsuite_audit_{timestamp}.ndjson" blob = bucket.blob(object_key) ndjson = '\n'.join( [json.dumps(r, ensure_ascii=False, default=str) for r in records] ) + '\n' blob.upload_from_string(ndjson, content_type='application/x-ndjson') print(f"Wrote {len(records)} records to gs://{GCS_BUCKET}/{object_key}") if newest_time: save_state(bucket, newest_time) else: save_state(bucket, now.isoformat()) print(f"Successfully processed {len(records)} records") except Exception as e: print(f'Error processing logs: {str(e)}') raise def fetch_login_audit(start_time, end_time): """ Fetch LoginAudit records from NetSuite SuiteQL API with pagination. Returns: Tuple of (records list, newest_event_time ISO string) """ base_url = get_netsuite_base_url(NS_ACCOUNT_ID) suiteql_endpoint = f"{base_url}/services/rest/query/v1/suiteql" start_str = start_time.strftime('%Y-%m-%d %H:%M:%S') end_str = end_time.strftime('%Y-%m-%d %H:%M:%S') query = ( "SELECT id, date, status, user, role, emailaddress, " "ipaddress, useragent, detail, requesturi, " "oauthaccesstokenname, oauthappname " "FROM LoginAudit " f"WHERE date BETWEEN TO_DATE('{start_str}', 'YYYY-MM-DD HH24:MI:SS') " f"AND TO_DATE('{end_str}', 'YYYY-MM-DD HH24:MI:SS') " "ORDER BY date ASC" ) records = [] newest_time = None offset = 0 backoff = 1.0 while True: if len(records) >= MAX_RECORDS: print(f"Reached max_records limit ({MAX_RECORDS})") break remaining = min(PAGE_SIZE, MAX_RECORDS - len(records)) url = f"{suiteql_endpoint}?limit={remaining}&offset={offset}" auth_header = generate_oauth_header( 'POST', url, NS_ACCOUNT_ID, NS_CONSUMER_KEY, NS_CONSUMER_SECRET, NS_TOKEN_ID, NS_TOKEN_SECRET ) headers = { 'Authorization': auth_header, 'Content-Type': 'application/json', 'Prefer': 'transient', 'User-Agent': 'GoogleSecOps-NetSuiteCollector/1.0', } body = json.dumps({'q': query}).encode('utf-8') try: response = http.request('POST', url, headers=headers, body=body) if response.status == 429: retry_after = int( response.headers.get('Retry-After', str(int(backoff))) ) print(f"Rate limited (429). Retrying after {retry_after}s...") time.sleep(retry_after) backoff = min(backoff * 2, 60.0) continue backoff = 1.0 if response.status != 200: print(f"HTTP Error: {response.status}") response_text = response.data.decode('utf-8') print(f"Response body: {response_text}") return records, newest_time data = json.loads(response.data.decode('utf-8')) page_results = data.get('items', []) if not page_results: print("No more results (empty page)") break page_num = (offset // PAGE_SIZE) + 1 print(f"Page {page_num}: Retrieved {len(page_results)} records") records.extend(page_results) for event in page_results: try: event_time = event.get('date') if event_time: if newest_time is None or event_time > newest_time: newest_time = event_time except Exception as e: print(f"Warning: Could not parse event time: {e}") has_more = data.get('hasMore', False) if not has_more: print("Reached last page (hasMore=false)") break offset += len(page_results) except Exception as e: print(f"Error fetching logs: {e}") return records, newest_time print(f"Retrieved {len(records)} total records") return records, newest_time def load_state(bucket): """Load state from GCS.""" try: blob = bucket.blob(STATE_KEY) if blob.exists(): return json.loads(blob.download_as_text()) except Exception as e: print(f"Warning: Could not load state: {e}") return {} def save_state(bucket, last_event_time_iso): """Save the last event timestamp to GCS state file.""" try: state = { 'last_event_time': last_event_time_iso, 'last_run': datetime.now(timezone.utc).isoformat() } blob = bucket.blob(STATE_KEY) blob.upload_from_string( json.dumps(state, indent=2), content_type='application/json' ) print(f"Saved state: last_event_time={last_event_time_iso}") except Exception as e: print(f"Warning: Could not save state: {e}")- requirements.txt:
functions-framework==3.* google-cloud-storage==2.* urllib3>=2.0.0Haz clic en Implementar para guardar y, luego, implementar la función.
Espera a que se complete la implementación (de 2 a 3 minutos).
Crea un trabajo de Cloud Scheduler
Cloud Scheduler publicará mensajes en el tema de Pub/Sub a intervalos regulares, lo que activará la función de Cloud Run.
- En Google Cloud Console, ve a Cloud Scheduler.
- Haz clic en Crear trabajo.
Proporciona los siguientes detalles de configuración:
Parámetro de configuración Valor Nombre netsuite-audit-collector-hourlyRegión Selecciona la misma región que la función de Cloud Run Frecuencia 0 * * * *(cada hora, en punto)Zona horaria Selecciona la zona horaria (se recomienda UTC) Tipo de objetivo Pub/Sub Tema Seleccionar netsuite-audit-triggerCuerpo del mensaje {}(objeto JSON vacío)Haz clic en Crear.
Opciones de frecuencia de programación
Elige la frecuencia según el volumen de registros y los requisitos de latencia:
| Frecuencia | Expresión cron | Caso de uso |
|---|---|---|
| Cada 5 minutos | */5 * * * * |
Alto volumen y baja latencia |
| Cada 15 minutos | */15 * * * * |
Volumen medio |
| Cada 1 hora | 0 * * * * |
Estándar (recomendado) |
| Cada 6 horas | 0 */6 * * * |
Procesamiento por lotes de bajo volumen |
| Diario | 0 0 * * * |
Recopilación de datos históricos |
Prueba la integración
- En la consola de Cloud Scheduler, busca tu trabajo (
netsuite-audit-collector-hourly). - Haz clic en Forzar ejecución para activar el trabajo de forma manual.
- Espera unos segundos.
- Ve a Cloud Run > Servicios.
- Haz clic en
netsuite-audit-collector: - Haz clic en la pestaña Registros.
Verifica que la función se haya ejecutado correctamente. Busca lo siguiente:
Fetching logs from YYYY-MM-DDTHH:MM:SS+00:00 to YYYY-MM-DDTHH:MM:SS+00:00 Page 1: Retrieved X records Wrote X records to gs://netsuite-audit-logs/netsuite-audit/netsuite_audit_YYYYMMDD_HHMMSS.ndjson Successfully processed X recordsVe a Cloud Storage > Buckets.
Haz clic en
netsuite-audit-logs:Navega a la carpeta
netsuite-audit/:Verifica que se haya creado un archivo
.ndjsonnuevo con la marca de tiempo actual.
Si ves errores en los registros, haz lo siguiente:
- HTTP 401: Verifica que las credenciales de OAuth (
NS_CONSUMER_KEY,NS_CONSUMER_SECRET,NS_TOKEN_ID,NS_TOKEN_SECRET) y las variables de entornoNS_ACCOUNT_IDsean correctas. - HTTP 403: Verifica que el rol de NetSuite tenga los permisos necesarios (servicios web de REST, registro de auditoría de acceso y SuiteAnalytics Workbook).
- HTTP 429: Límite de frecuencia: La función volverá a intentarlo automáticamente con retirada exponencial.
- Faltan variables de entorno: Verifica que todas las variables requeridas estén configuradas en la configuración de la función de Cloud Run.
Recupera la cuenta de servicio de Google SecOps
- Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
- Haz clic en Agregar feed nuevo.
- Haz clic en Configura un feed único.
- En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo,
NetSuite Audit Logs). - Selecciona Google Cloud Storage V2 como el Tipo de fuente.
- Selecciona Oracle NetSuite - NetSuite Applications Suite como el Tipo de registro.
Haz clic en Obtener cuenta de servicio. Se mostrará un correo electrónico único de la cuenta de servicio. Por ejemplo:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comCopia esta dirección de correo electrónico para usarla en el siguiente paso.
Haz clic en Siguiente.
Especifica valores para los siguientes parámetros de entrada:
URL del bucket de almacenamiento: Ingresa el URI del bucket de GCS con la ruta de acceso del prefijo:
gs://netsuite-audit-logs/netsuite-audit/
- Opción de eliminación del código fuente: Selecciona la opción de eliminación según tu preferencia:
- Nunca: Nunca borra ningún archivo después de las transferencias (se recomienda para las pruebas).
- Borrar archivos transferidos: Borra los archivos después de que se transfirieron correctamente.
- Borrar los archivos transferidos y los directorios vacíos: Borra los archivos y los directorios vacíos después de que se transfirieron correctamente.
- Antigüedad máxima del archivo: Incluye los archivos modificados en la última cantidad de días (el valor predeterminado es 180 días).
- 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.
Haz clic en Siguiente.
Revisa la configuración de tu feed de noticias nuevo en la pantalla Finalizar y, luego, haz clic en Enviar.
Otorga permisos de IAM a la cuenta de servicio de Google SecOps
La cuenta de servicio de Google SecOps necesita el rol de visualizador de objetos de Storage en tu bucket de GCS.
- Ve a Cloud Storage > Buckets.
- Haz clic en
netsuite-audit-logs: - Ve a la pestaña Permisos.
- Haz clic en Otorgar acceso.
- Proporciona los siguientes detalles de configuración:
- Agregar principales: Pega el correo electrónico de la cuenta de servicio de Google SecOps.
- Asigna roles: Selecciona Visualizador de objetos de Storage.
Haz clic en Guardar.
Límites de frecuencia de la API de NetSuite
La API de NetSuite tiene los siguientes límites de simultaneidad y frecuencia:
| Tipo de límite | Valor predeterminado | Notas |
|---|---|---|
| Solicitudes simultáneas | 15 solicitudes | Se aplica a las solicitudes combinadas de la API de SOAP y REST por cuenta |
| Resultados de la consulta de SuiteQL | 100,000 filas como máximo | Cantidad máxima de filas que se devuelven por consulta de SuiteQL |
| Objetos por solicitud | 1,000 objetos como máximo | Cantidad máxima de objetos que se devuelven por solicitud a la API |
La función de Cloud Run controla automáticamente la límite de frecuencia con retirada exponencial. Si encuentras errores persistentes de límite de frecuencia (HTTP 429), comunícate con el equipo de asistencia de NetSuite para aumentar tus límites de API o ajustar la frecuencia de Cloud Scheduler.
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica |
|---|---|---|
| usuario | extensions.auth.type | Tipo de mecanismo de autenticación utilizado |
| fecha | metadata.event_timestamp | Marca de tiempo del momento en que ocurrió el evento |
| event_type | metadata.event_type | Tipo de evento (p.ej., USER_LOGIN, NETWORK_CONNECTION) |
| security_result | security_result | Detalles sobre el resultado de seguridad del evento |
| oauthaccesstokenname | security_result.about.resource.attribute.labels | Son etiquetas de pares clave-valor que describen los atributos del recurso involucrado en el resultado de seguridad. |
| secchallenge | security_result.about.resource.attribute.labels | |
| estado | security_result.summary | Descripción resumida del resultado de seguridad |
| oauthappname | target.application | Nombre de la aplicación de destino |
| usuario-agente | target.application | |
| ipaddress | target.ip | Dirección IP del destino |
| requesturi | target.url | URL del recurso objetivo |
| emailaddress | target.user.email_addresses | Direcciones de correo electrónico asociadas con el usuario objetivo |
| rol | target.user.role_name | Nombre del rol asignado al usuario objetivo |
| usuario | target.user.userid | Es el identificador único del usuario objetivo. |
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.