Alation
Enterprise data catalog.
Access mode: Read-only
Required information
| Field | Details |
|---|---|
| Instance URL | Alation server URL. |
| Authentication | API token (generated in Alation admin) or OAuth. |
| Scope | Data source IDs, catalog sets, or all catalog content. |
Network considerations
Cloud (Alation Cloud Service): HTTPS. No VPN needed.
On-premises: VPN or reverse proxy. API at /integration/v2/ and /api/v1/.
Credential and auth management
Preferred: API Access Token. Generated by Alation admin. Long-lived. Scoped to user’s permissions.
Alternative: OAuth. If Alation is configured with external IdP.
Alation service account: Create a dedicated Alation user with read-only access to target data sources.
Validation checks
| Check | Method | Expected result |
|---|---|---|
| Authentication | GET /integration/v2/datasource/ | Returns data source list |
| Catalog access | GET /integration/v2/schema/?ds_id=<id> | Returns schemas |
| Lineage | GET /api/v1/lineage/<oid>/ | Returns lineage graph |
| Article access | GET /integration/v2/article/ | Returns catalog articles |
Every connection starts from the pre-engagement checklist and goes through the universal validation protocol before production sign-off.