Integrations¶
Integrations are the foundation of InfraKitchen's connectivity to external systems. They securely store credentials and configuration needed to interact with cloud providers, Git repositories, and authentication systems.
🎯 What are Integrations?¶
An Integration in InfraKitchen is a secure record that contains:
- Connection details (URLs, endpoints, account IDs)
- Authentication credentials (API keys, tokens, OAuth credentials)
- Configuration settings (regions, scopes, permissions)
All credentials are encrypted at rest and decrypted only when needed for operations.
🔍 Integration Properties¶
All integrations share common properties:
| Property | Description | Required |
|---|---|---|
| Name | Human-readable identifier | ✅ |
| Type | Cloud/Git/Auth provider | ✅ |
| Provider | Specific provider (AWS, GitHub, etc.) | ✅ |
| Configuration | Provider-specific settings | ✅ |
| Description | Purpose and usage notes | ❌ |
🛠️ Managing Integrations¶
Create¶
Only platform engineers can create integrations:
- Navigate to Integrations page
- Click "Create Integration"
- Select provider type
- Fill in required fields
- Test connection (if applicable)
- Save
Update¶
Credentials can be rotated without affecting resources:
- Edit existing integration
- Update credentials
- Save
- Existing resources continue working
Delete¶
⚠️ Warning: Deleting an integration will prevent resources using it from being provisioned or destroyed.
Before deletion:
- Ensure no resources reference it
- Update or destroy dependent resources
- Document the change
📚 Provider-Specific Guides¶
Cloud Providers¶
- AWS Setup Guide - IAM roles, permissions, and best practices
- Azure Setup Guide - Service principals and RBAC
- GCP Setup Guide - Service accounts and IAM
- MongoDB Atlas Guide - API keys and project setup
- Datadog Guide - API and application keys
Git Providers¶
- GitHub Setup Guide - OAuth apps, PATs, and permissions
- Bitbucket Setup Guide - App passwords and OAuth
- Azure DevOps Guide - PATs and service connections
Auth Providers¶
- GitHub OAuth Setup - App registration and scopes
- Microsoft OAuth Setup - App registration and Azure AD
- Backstage Integration - Plugin configuration
- Service Accounts - API token management
- Guest Access - Development mode