Troubleshooting connection issues

 

Enable HTTPS

 If your site use HTTPS, you must enable HTTPS in Product Manager.

Click "Options" in the connection window:

 

Check "Use secure connection (HTTPS)"

 

The URL has changed and starts with https. Click "Connect" to connect to the website.

 

Fix file permission with FTP client

Incorrect file permissions can cause connection errors. If the file permissions of index.php and the bridge file are different, you need to fix the file permission of the bridge file.

In this screenshot, the bridge file permission is 777 while index.php file permission is 644:

Right-click on the bridge file and select "File permissions":

 

Change the file permission and click "Ok":

Check again that the file permissions are identical:

 

Move the PHP file to the pub folder (Magento 2)

If you use Magento 2, you may have to upload the PHP file to the pub folder instead of the root folder if the Magento instance is configured to serve files from the pub folder (see Modify docroot to improve security).

If you don't know how the server is configured, you can copy the PHP file to the root folder and the pub folder.

 

Modify NGinx configuration file to fix 404 error (Magento 2)

If the server uses NGinx, you must modify the Nginx configuration file (nginx.conf.sample in the Magento installation directory). You must add benabeebridge.+ to location.

 In Magento 2.0.x or Magento 2.1.x, you must modify line 157

Replace:
location ~ (index|get|static|report|404|503)\.php$ {
by:
location ~ (index|get|static|report|404|503|benabeebridge.+)\.php$ {

 

In Magento 2.2.x, you must modify line 165

Replace:
location ~ (index|get|static|report|404|503|health_check)\.php$ {
by:
location ~ (index|get|static|report|404|503|health_check|benabeebridge.+)\.php$ {

 

In Magento 2.3.x, you must modify line 181

Replace:
location ~ ^/(index|get|static|errors/report|errors/404|errors/503|health_check)\.php$ {
by:
location ~ ^/(index|get|static|errors/report|errors/404|errors/503|health_check|benabeebridge.+)\.php$ {

 

In Magento 2.4.x, you must modify line 207

 Replace:
location ~ ^/(index|get|static|errors/report|errors/404|errors/503|health_check)\.php$ {
by:
location ~ ^/(index|get|static|errors/report|errors/404|errors/503|health_check|benabeebridge.+)\.php$ {

 

After editing the config file, verify that the syntax is correct:
nginx -t

And restart nginx:
systemctl restart nginx