Azure DevOps Integration Setup
Connect your Azure DevOps organization to Forese.ai for seamless project synchronization. Import iterations, sync work items to the Knowledge Graph, and visualize dependencies on the canvas.
Prerequisites
Before you begin, ensure you have:
- An Azure DevOps organization- Azure DevOps Services (cloud) is supported
- Project or organization admin access- To the Azure DevOps organization you want to connect
- Organization owner or admin role- In Forese.ai
Setup Steps
Navigate to Integrations
Log in to your Forese.ai dashboard, click on Settings in the sidebar, select Integrations from the settings menu, and find the Azure DevOps card.
Connect Azure DevOps
Click Connect to be redirected to Azure DevOps authorization page. Sign in with your Microsoft account and select the organization you want to connect.
Authorize Forese.ai
Review the permissions being requested (read work items, projects, and iterations) and click Accept to authorize the connection.
Configure Sync Settings
Choose your sync mode: Manual Import (import on-demand), Galaxy Sync (auto-sync to Knowledge Graph), or Both for comprehensive project management.
Verify Connection
After configuration, you'll see a Connected status with your Azure DevOps organization name. The connection is now ready to use.
Sync Modes Explained
Import iterations/sprints to canvas on-demand. Best for occasional canvas visualization and simulation.
Learn moreAutomatically sync to Knowledge Graph for AI search. Best for cross-project insights and semantic search.
Learn moreGet Galaxy sync + canvas import. Best for comprehensive project management and analysis.
Most PopularWork Item Type Mapping
| Azure DevOps Type | Forese.ai Node Type | Duration Source |
|---|---|---|
| Epic | Epic (Container) | Calculated from children |
| Feature | Feature (Container) | Calculated from children |
| User Story | User Story | Story Points or Effort |
| Task | Task | Original/Remaining Work |
| Bug | Task | Original/Remaining Work |
Story Points are converted to days using a configurable ratio (default: 1 SP = 1 day). Beta-PERT estimates are created with Best Case (0.7x), Most Likely (1.0x), and Worst Case (1.3x) multipliers.
Security
Forese.ai takes security seriously:
- OAuth 2.0 - Industry-standard secure authentication via VSTS
- Encrypted Tokens - Access tokens encrypted at rest using AES-256-GCM
- CSRF Protection - OAuth state signed with HMAC-SHA256
- Minimal Scopes - Read-only access to work items and projects
- Organization Isolation - Data isolated via Row Level Security
Troubleshooting
"Connection Failed" error
- Ensure you have access to the Azure DevOps organization
- Check that you have the required permissions
- Try disconnecting and reconnecting
"Token Expired" error
- Forese.ai automatically refreshes tokens
- If this persists, disconnect and reconnect your Azure DevOps account
"No work items found" message
- Verify the selected iteration/sprint contains work items
- Check work item area paths match the team context
- Ensure work items are not in a deleted state
"Insufficient permissions" error
- Verify you have read access to the Azure DevOps project
- Check your organization role in Forese.ai (must be owner/admin to manage connection)