Create an Integration (Wizard)
Administrator15 min
What it's for
Connect a new log source to Affinity using the 4-step wizard with exact UI labels.
Before you start
- Create required secrets in SECRETS (Add Secret → Create New Secret modal).
- For S3 integrations: have bucket, prefix, and AWS credentials with read permissions ready.
Steps
- In Integrations, click New Integration.
- Step Connection: choose S3 or API (`How do logs reach Affinity?`) → Next.
- Step Integration: choose the type (e.g. `CloudTrail`, `VPC Flow`, `GuardDuty`, `Admin`, `Drive`, etc.) → Next.
- Step Configure: complete credentials, bucket/prefix (S3), region, historical dates, secrets → Next.
- Step Review: review, validate S3 prefix if applicable, and create the integration.
Expected result
- The integration appears in the Integrations list.
- You can go to the ingestion flow (Start Ingestion).
Common errors
| Symptom | Likely cause | What to do |
|---|---|---|
| Cannot advance on step 3 | Incomplete fields or unvalidated S3 prefix | Complete all fields; for S3, run prefix validation |
| `Draft restored — pick up where you left off.` | Draft saved in browser | Continue or **Discard draft** |
| Missing secret | No credential in Secrets | Create secret first; in Configure you can open inline **Add Secret** |
Tips
- After creating the integration, use Pipeline → Open Logs to confirm data arrived.
- The wizard auto-saves drafts: if interrupted, you can resume where you left off.