Troubleshooting Guide
Common Issues
Authentication Problems
Managed Identity Not Working
Symptoms: - "Authentication failed" errors in logs - Cannot access Azure resources
Solutions: 1. Verify managed identity is properly configured 2. Check role assignments in Azure Portal 3. Ensure proper permissions are granted
Azure DevOps Access Issues
Symptoms: - Cannot push to repositories - Git operation failures
Solutions: 1. Verify managed identity is added to Azure DevOps 2. Check repository permissions 3. Validate PAT token if used
Scanning Issues
Failed Azure Scans
Symptoms: - Missing resources in snapshots - Incomplete configuration data
Solutions: 1. Check Azure role assignments 2. Verify network connectivity 3. Review scan logs for specific errors
Entra ID/Intune Scan Failures
Symptoms: - Missing user/group data - Incomplete policy information
Solutions: 1. Verify Microsoft Graph permissions 2. Check application administrator rights 3. Review API consent status
Error Messages
Common Error Codes
ERR001: Authentication Failed
- Cause: Insufficient permissions or expired credentials
- Solution: Review and update permissions
ERR002: Repository Access Denied
- Cause: Git repository permissions issue
- Solution: Check Azure DevOps access settings
ERR003: Scan Timeout
- Cause: Large environment or network issues
- Solution: Check network connectivity and resource size
Diagnostic Procedures
Checking Service Health
- Access Azure2Git web interface
- Review status indicators
- Check Azure Application Insights
Collecting Logs
- Access Azure Portal
- Navigate to App Service logs
- Download diagnostic logs
Network Diagnostics
- Verify connectivity to Azure services
- Check DNS resolution
- Validate proxy settings if used
Getting Help
Before Contacting Support
- Collect error messages
- Gather service logs
- Document recent changes
Support Contact
- Email: support@just-software.com
- Portal: Azure Marketplace Support
- Include your subscription ID and error details