Crear una integración (wizard)

RolAdministradorLectura15 min

Para qué sirve

Conectá una nueva fuente de logs a Affinity usando el asistente de 4 pasos con textos exactos de la interfaz.

Antes de empezar

Creá los secretos necesarios en SECRETS (Add Secret → modal Create New Secret).
Para integraciones S3: tené listos bucket, prefix y credenciales AWS con permisos de lectura.

Pasos

1
En Integrations, hacé clic en New Integration.
2
Paso Connection: elegí S3 o API (How do logs reach Affinity?) → Next.
3
Paso Integration: elegí el tipo (ej. CloudTrail, VPC Flow, GuardDuty, Admin, Drive, etc.) → Next.
4
Paso Configure: completá credenciales, bucket/prefix (S3), región, fechas históricas, secretos → Next.
5
Paso Review: revisá, validá prefijo S3 si aplica, y creá la integración.

Resultado esperado

La integración aparece en la lista de Integrations.
Podés ir al flujo de ingesta (Iniciar ingesta).

Errores comunes

Síntoma	Causa probable	Qué hacer
No podés avanzar en paso 3	Campos incompletos o prefijo S3 no validado	Completá todos los campos; en S3, ejecutá la validación de prefijo
`Draft restored — pick up where you left off.`	Borrador guardado en el navegador	Continuá o Discard draft
Falta secreto	No hay credencial en Secrets	Creá secreto primero; en Configure podés abrir Add Secret inline

Consejos

Tras crear la integración, usá Pipeline → Open Logs para confirmar que los datos llegaron.
El asistente guarda borradores automáticamente: si interrumpís el proceso, podés retomarlo donde lo dejaste.
Tipos S3: CloudTrail, VPC Flow, WAF, ALB, MongoDB audit, GuardDuty (S3 export), Workspace Alert Center, Custom S3 source.
Tipos API: AWS GuardDuty, RDS audit (CloudWatch API); GitHub Organization audit logs, Enterprise audit logs; Google Admin, Drive, Token, Alerts, Login; Azure Log Analytics query.

Ver también

Iniciar ingesta →Catálogo de integraciones →

Pasos

1
En Integrations, hacé clic en New Integration.
2
Paso Connection: elegí S3 o API (How do logs reach Affinity?) → Next.
3
Paso Integration: elegí el tipo (ej. CloudTrail, VPC Flow, GuardDuty, Admin, Drive, etc.) → Next.
4
Paso Configure: completá credenciales, bucket/prefix (S3), región, fechas históricas, secretos → Next.
5
Paso Review: revisá, validá prefijo S3 si aplica, y creá la integración.

Errores comunes

Síntoma	Causa probable	Qué hacer
No podés avanzar en paso 3	Campos incompletos o prefijo S3 no validado	Completá todos los campos; en S3, ejecutá la validación de prefijo
`Draft restored — pick up where you left off.`	Borrador guardado en el navegador	Continuá o Discard draft
Falta secreto	No hay credencial en Secrets	Creá secreto primero; en Configure podés abrir Add Secret inline

Consejos

Tras crear la integración, usá Pipeline → Open Logs para confirmar que los datos llegaron.

El asistente guarda borradores automáticamente: si interrumpís el proceso, podés retomarlo donde lo dejaste.

Tipos S3: CloudTrail, VPC Flow, WAF, ALB, MongoDB audit, GuardDuty (S3 export), Workspace Alert Center, Custom S3 source.

Tipos API: AWS GuardDuty, RDS audit (CloudWatch API); GitHub Organization audit logs, Enterprise audit logs; Google Admin, Drive, Token, Alerts, Login; Azure Log Analytics query.