Integrations Overview

Shoehorn integrates with external tools to enrich your service catalog with data from across your engineering ecosystem.

Available Integrations

Integration	Purpose	Setup
GitHub	Repository discovery, manifests, PRs	GitHub App
Identity Providers	Authentication and group sync	OIDC configuration
Webhooks	Event-driven notifications	URL + secret
CI/CD	Manifest validation in pipelines	CLI in GitHub Actions, GitLab CI, Jenkins

How Integrations Work

Integrations in Shoehorn follow a pull-based model:

1. Configure the integration with credentials and settings
2. Shoehorn pulls data on a schedule (or receives webhooks)
3. Data enriches entities in the service catalog
4. Events trigger workflows and notifications

Managing Integrations

Integrations are managed in Admin > Integrations. Each integration shows:

• Connection status (connected, error, pending)
• Last sync time
• Entity count affected
• Configuration details

Integration Data Flow

External Tool
    │
    ├── Pull (scheduled): Crawler fetches data
    │   └── GitHub: repos, manifests, READMEs, topics
    │
    └── Push (webhooks): Tool sends events
        └── GitHub: push events, PR events
            │
            ▼
    Shoehorn API
            │
            ▼
    Entity Enrichment
            │
            ▼
    Search Index Update