Jetbrains Proxy Setup

Use this guide when your network requires a proxy for outbound traffic to Aikido in JetBrains IDEs.

Configuration

1. Open Settings (File -> Settings on Windows/Linux, IDE menu -> Settings on macOS).
2. Go to Appearance & Behavior -> System Settings -> HTTP Proxy.
3. Choose Manual proxy configuration.
4. If using manual mode, fill in proxy Host and Port.
5. If required, enable Proxy authentication and add username/password.
6. Click Check connection with https://app.aikido.dev.
7. Save and restart/reload the IDE.
8. Open/save a file to trigger an Aikido scan.

If Your Company Uses TLS Inspection

If your proxy re-signs certificates, import your corporate CA in JetBrains:

1. Open settings and search for Server Certificates.
2. Import your corporate CA certificate (.pem/.crt).
3. Apply and restart the IDE.

How to Verify Connection

• IDE proxy Check connection succeeds.
• Aikido scans run after open/save without connection errors.
• SCA/dependency analysis completes.
• No proxy auth or TLS trust errors in IDE logs.

Common Fixes

• 407 Proxy Authentication Required
  • Re-check proxy credentials in HTTP Proxy.
  • Confirm auth method (basic vs integrated/SSO) with IT.
• TLS errors (self-signed, PKIX, unable to verify)
  • Import/update corporate CA in Server Certificates.
  • Restart IDE.
• Proxy not used
  • Ensure No proxy is not selected.
  • If using auto-detect, confirm your PAC/WPAD setup is reachable on your network/VPN.
  • If auto-detect fails, switch to manual settings from IT (host/port).
  • Re-check host/port and retry Check connection.
  • If centrally managed, verify JVM proxy properties are applied to this IDE instance.