You’re dealing with multiple issues here based on your description. Let me walk through the complete fix for pol-2406 webhook problems:
Step 1: Webhook Signature Validation Setup
Delete all existing CI-CD connectors in Polarion Admin > CI-CD Connectors. The pol-2406 upgrade doesn’t automatically migrate connector security settings. When you recreate each Jenkins connector, Polarion generates a new webhook URL with embedded HMAC-SHA256 signing secret. Copy these URLs exactly - they contain the authentication token Jenkins needs.
Step 2: Connector Migration Process
In Jenkins, update each webhook configuration with the new Polarion URLs. Critical: verify your Jenkins version supports HMAC-SHA256 headers. You need Jenkins 2.400+ or the Polarion Plugin 3.2+. Older versions expect SHA1 signatures and will reject the new format.
Step 3: HMAC-SHA256 Header Validation
Test each webhook with curl before enabling in Jenkins:
curl -X POST https://your-polarion/api/webhook \
-H "X-Polarion-Signature: sha256=your_signature" \
-H "Content-Type: application/json"
If this returns 401, the signature isn’t being calculated correctly. Regenerate the connector in Polarion.
Step 4: Tomcat Service Restart
This is crucial and often overlooked. Polarion caches webhook authentication settings in memory. After recreating all connectors, restart the Tomcat service:
sudo systemctl restart polarion-tomcat
Without this restart, Polarion may continue using old authentication rules even with new connectors configured.
Timeout Issue Resolution
The 30-second timeouts you’re seeing are actually authentication failures, not network issues. Once the HMAC-SHA256 validation works, response times should drop to under 2 seconds. If timeouts persist after following these steps, check your Jenkins webhook timeout settings - increase them to 60 seconds temporarily while testing.
Sprint Boundary Timing
One more thing: if you’re in the middle of an active sprint, wait until sprint closure to migrate connectors. We had issues with in-flight webhook deliveries getting lost during the connector recreation process. Schedule the migration during a sprint boundary to avoid losing CI-CD event notifications.
After following this process our Jenkins integration has been rock solid on pol-2406. The key is the Tomcat restart - that fixed the persistent authentication errors we were seeing even after connector migration.