Skip to main content

Configure Authentication for Runbook Actions

This guide explains how to configure authentication for various integrations used in Harness IR runbooks.

Overview​

Each integration type requires specific authentication setup to ensure secure communication between Harness IR and the external service.

Communication Tools​

Slack​

  1. Navigate to Settings → Connectors → Collaboration
  2. Click + New Connector
  3. Select Slack
  4. Follow the OAuth flow to authorize Harness
  5. Configure channel permissions

Microsoft Teams​

  1. Navigate to Settings → Connectors → Collaboration
  2. Click + New Connector
  3. Select Microsoft Teams
  4. Enter your Azure AD credentials
  5. Grant necessary permissions

Zoom​

  1. Navigate to Settings → Connectors → Collaboration
  2. Click + New Connector
  3. Select Zoom
  4. Configure OAuth settings
  5. Set meeting defaults

Ticketing Systems​

Jira​

  1. Navigate to Settings → Connectors → Incident Response
  2. Click + New Connector
  3. Select Jira
  4. Enter your API key
  5. Configure project mapping

ServiceNow​

  1. Navigate to Settings → Connectors → Incident Response
  2. Click + New Connector
  3. Select ServiceNow
  4. Enter your instance URL and credentials
  5. Set up incident mapping

Best Practices​

Security​

  • Use service accounts where possible
  • Regularly rotate API keys
  • Follow the principle of least privilege
  • Monitor authentication logs
  • Use OAuth when available

Maintenance​

  • Document all authentication configurations
  • Set up key rotation schedules
  • Monitor connector health
  • Maintain backup access methods
  • Review permissions regularly

Troubleshooting​

Common Issues​

  1. Invalid Credentials

    • Verify API key validity
    • Check token expiration
    • Confirm correct scopes

  2. Connection Failures

    • Verify network connectivity
    • Check firewall rules
    • Validate endpoint URLs

  3. Permission Issues

    • Review required scopes
    • Check service account permissions
    • Verify organization access

Next Steps​

Documentation​

Integration Guides​