Realm9 Logo
Search documentation...

Integrations

Realm9 integrates with popular development and operations tools to fit seamlessly into your existing workflows.

Overview

Integrate with:

  • Communication platforms
  • Project management tools
  • Monitoring and observability
  • CI/CD pipelines
  • Identity providers

Communication

Slack

Get notifications and manage resources from Slack:

Features:

  • Booking approval requests
  • Environment status updates
  • Terraform run notifications
  • Interactive commands
  • Channel-based workflows

Setup:

  1. Navigate to Integrations > Slack
  2. Click Connect to Slack
  3. Authorize Realm9 app
  4. Select channels
  5. Configure notifications

Microsoft Teams

Receive alerts and updates in Teams:

Features:

  • Adaptive card notifications
  • Approval workflows
  • Status updates
  • Bot commands

Setup:

  1. Go to Integrations > Microsoft Teams
  2. Add Realm9 connector
  3. Configure channels
  4. Set notification preferences

Project Management

Jira

Link environments and bookings to Jira issues:

Features:

  • Auto-link environments to tickets
  • Track booking in Jira
  • Sync status updates
  • Create issues from Realm9

Setup:

  1. Navigate to Integrations > Jira
  2. Enter Jira URL
  3. Provide API credentials
  4. Map projects
  5. Configure field mappings

ServiceNow

Integrate with ITSM workflows:

Features:

  • Change management integration
  • Incident tracking
  • CMDB sync
  • Approval workflows

Monitoring and Observability

Datadog

Forward metrics and logs to Datadog:

Features:

  • Environment metrics
  • Terraform run metrics
  • Custom dashboards
  • Alerting

Setup:

  1. Go to Integrations > Datadog
  2. Enter API key
  3. Configure metric forwarding
  4. Set up dashboards

Prometheus

Export metrics for Prometheus:

Features:

  • /metrics endpoint
  • Custom exporters
  • Grafana dashboards
  • Alert manager integration

New Relic

Send telemetry to New Relic:

Features:

  • Application monitoring
  • Infrastructure metrics
  • Distributed tracing
  • Custom events

CI/CD

GitHub Actions

Trigger Realm9 operations from GitHub:

Features:

  • Deploy on merge
  • Auto-create environments
  • Run Terraform plans
  • Environment cleanup

Example Workflow:

name: Deploy to Realm9
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Trigger Terraform Run
        run: |
          curl -X POST https://realm9.app/api/terraform/runs \
            -H "Authorization: Bearer ${{ secrets.REALM9_TOKEN }}"

GitLab CI

Integrate with GitLab pipelines:

Features:

  • Pipeline-triggered deploys
  • Environment management
  • Terraform automation
  • Status reporting

Jenkins

Connect Jenkins pipelines:

Features:

  • Jenkins plugin
  • Build triggers
  • Environment provisioning
  • Deployment automation

Identity and Access

Okta

Single Sign-On with Okta:

Features:

  • SAML 2.0 authentication
  • User provisioning
  • Group mapping
  • MFA support

Setup:

  1. Navigate to Configuration > SSO
  2. Select Okta
  3. Enter Okta domain
  4. Configure SAML
  5. Test connection

Azure Active Directory

SSO with Azure AD:

Features:

  • OAuth/SAML support
  • Automatic user provisioning
  • Conditional access
  • Group-based roles

Google Workspace

Authenticate with Google:

Features:

  • OAuth 2.0 authentication
  • Domain-based access
  • Auto-provisioning
  • Google Groups integration

Cloud Providers

AWS

Direct AWS integration:

Features:

  • IAM role assumption
  • Resource discovery
  • Cost tracking
  • CloudWatch integration

Azure

Azure services integration:

Features:

  • Service Principal auth
  • Resource management
  • Cost analysis
  • Azure Monitor

GCP

Google Cloud integration:

Features:

  • Service Account auth
  • Resource inventory
  • Billing integration
  • Cloud Monitoring

Version Control

GitHub

Connect GitHub repositories:

Features:

  • Repository linking
  • Webhook triggers
  • PR-based workflows
  • Status checks

GitLab

GitLab repository integration:

Features:

  • Project connection
  • Merge request triggers
  • Pipeline integration
  • Status reporting

Bitbucket

Bitbucket integration:

Features:

  • Repository sync
  • PR automation
  • Pipeline triggers
  • Branch policies

Webhooks

Custom Webhooks

Create custom integrations:

Features:

  • Event-based triggers
  • Custom payload formats
  • Retry logic
  • Signature verification

Setup:

  1. Go to Integrations > Webhooks
  2. Click Create Webhook
  3. Enter endpoint URL
  4. Select events
  5. Configure authentication

Events:

  • environment.created
  • booking.approved
  • terraform.run.completed
  • user.invited

Example Payload:

{
  "event": "environment.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "env_123",
    "name": "prod-api",
    "type": "PRODUCTION"
  }
}

API Integration

REST API

Full-featured REST API:

Features:

  • Complete CRUD operations
  • Filtering and pagination
  • Rate limiting
  • API key authentication

Documentation: See API Reference for details.

GraphQL (Coming Soon)

GraphQL API for flexible queries:

Features:

  • Type-safe queries
  • Nested data fetching
  • Real-time subscriptions
  • Schema introspection

Best Practices

Security

  • Use separate credentials per integration
  • Rotate tokens regularly
  • Enable audit logging
  • Limit integration permissions

Reliability

  • Handle webhook failures
  • Implement retry logic
  • Monitor integration health
  • Set up alerting

Maintenance

  • Review integrations quarterly
  • Remove unused integrations
  • Update credentials
  • Test after platform updates

Troubleshooting

Integration Not Working

  • Verify credentials
  • Check network connectivity
  • Review permission scopes
  • Check audit logs for errors

Webhook Failures

  • Verify endpoint is reachable
  • Check signature verification
  • Review retry attempts
  • Test with sample payload

Next Steps