Overview
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
Open the Integrations page.
Create Integration
Click Create Integration, select the provider type, and fill in the required fields.
Save
Optionally test the connection, then save.
Update
Credentials can be rotated without affecting resources:
Edit existing integration
Update the credentials or configuration and save.
Existing resources continue working.
Delete
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 - PATs, permissions, and SSH
- GitLab Setup Guide - Personal and group access tokens
- Bitbucket Setup Guide - API tokens and scopes
- Azure DevOps Guide - PATs and organization setup
Auth Providers
- GitHub OAuth Setup - App registration and scopes
- Google OAuth Setup - OAuth client registration and redirect URI
- Microsoft OAuth Setup - App registration and Azure AD
- Backstage Integration - Plugin configuration
- Service Accounts - API token management
- Guest Access - Development mode
Notification Providers
- Slack Setup Guide - Bot token, scopes, and channel setup