Skip to main content
Aurora integrates with your team communication and documentation tools to enable seamless collaboration and knowledge sharing.

​
Available Integrations

Slack

OAuth 2.0 workspace integration

Confluence

OAuth 2.0 for Atlassian Cloud

​
Slack

​
Authentication Method

OAuth 2.0

​
Setup Overview

  1. Create Slack App
    • Go to Slack API Apps > Create New App > From scratch
    • App Name: Aurora
    • Select your workspace
  2. Configure OAuth & Permissions
    • Go to OAuth & Permissions
    • Add Redirect URL:
      • Local dev: http://localhost:5080/slack/callback
      • With ngrok: https://your-ngrok-url.ngrok-free.dev/slack/callback
      • Production: https://your-aurora-domain/slack/callback
  3. Add Bot Token Scopes
    • chat:write — Send messages
    • channels:read — View channels
    • channels:history — Read channel messages
    • channels:join — Join channels
    • app_mentions:read — Read mentions
    • users:read — View users
  4. Copy Credentials
    • Go to Basic Information
    • Copy:
      • Client ID
      • Client Secret
      • Signing Secret
  5. Configure Environment Variables 
    NEXT_PUBLIC_ENABLE_SLACK=true
SLACK_CLIENT_ID=your-slack-client-id
SLACK_CLIENT_SECRET=your-slack-client-secret
SLACK_SIGNING_SECRET=your-signing-secret
  6. Restart Aurora 
    make down
make dev
  7. Connect Workspace
    • Go to Aurora UI
    • Click Add to Slack
    • Authorize the app

​
Features

  • Send notifications to channels
  • Receive mentions and respond to user queries
  • Browse channels and join conversations
  • Read message history for context

​
Local Development

When using ngrok for local development, update the Redirect URL in your Slack app settings to match your ngrok URL.

​
Troubleshooting

“bad_redirect_uri” — Redirect URL must match exactly in Slack App. Use ngrok URL when tunneling externally. “Slack connector not enabled” — Ensure NEXT_PUBLIC_ENABLE_SLACK=true and restart Aurora. “Missing bot token scopes” — Verify all required scopes are added in OAuth & Permissions.

​
Confluence

​
Authentication Method

OAuth 2.0 (Atlassian Cloud)

​
Setup Overview

  1. Create OAuth 2.0 App
  2. Configure OAuth Settings
    • Callback URL: {FRONTEND_URL}/confluence/callback
    • Scopes:
      • read:page:confluence — Read pages
      • read:space:confluence — Read spaces
      • read:user:confluence — Read user info
      • search:confluence — Search content
      • offline_access — Refresh tokens
  3. Copy Credentials
    • Client ID
    • Client Secret
  4. Configure Environment Variables 
    CONFLUENCE_CLIENT_ID=your-client-id
CONFLUENCE_CLIENT_SECRET=your-client-secret
FRONTEND_URL=http://localhost:3000
  5. Restart Aurora 
    make down
make dev
  6. Connect via OAuth Flow
    • Go to Aurora UI
    • Click Connect Confluence
    • Select your Confluence site
    • Authorize the app

​
Features

  • Search pages and spaces across your Confluence instance
  • Read documentation and runbooks
  • Parse runbook content for automated workflows
  • Access user information for context

​
Supported Operations

  • Search: CQL (Confluence Query Language) search
  • Read Pages: Retrieve page content and metadata
  • List Spaces: Browse available spaces
  • Parse Runbooks: Extract structured data from runbook pages

​
Troubleshooting

“OAuth configuration missing” — Verify CONFLUENCE_CLIENT_ID and CONFLUENCE_CLIENT_SECRET are set. “Invalid callback URL” — Ensure callback URL in Atlassian app matches {FRONTEND_URL}/confluence/callback. “No accessible resources” — User must have access to at least one Confluence site.
Confluence integration requires Atlassian Cloud. Confluence Server/Data Center is not currently supported.

​
Use Cases

​
Incident Response

  • Slack: Notify team channels when incidents occur
  • Confluence: Fetch runbook documentation during incidents
  • Combined: Post runbook links in Slack threads automatically

​
Documentation Sync

  • Confluence: Source of truth for infrastructure documentation
  • Slack: Share documentation updates in relevant channels
  • Aurora: Bridge between systems for seamless information flow

​
Knowledge Base

  • Confluence: Store detailed technical documentation
  • Slack: Ask questions and get instant answers
  • Aurora: Search Confluence and respond in Slack

​
Next Steps

CI/CD Integrations

Integrate with GitHub, Jenkins, and Bitbucket

Observability

Connect monitoring and alerting tools

Build docs developers (and LLMs) love

Get started for freeTalk to us