If you are facing issues connecting your Wordpress website, here’s a guide to help you troubleshoot and successfully connect your site to Narrato. 


First things first


  • The first thing to check and ensure is that the user account you are logging in with to connect your Wordpress site to Narrato is either an Admin or Editor account.
  • Second please make sure you are adding the right Wordpress site URL. As a thumb rule, add your website's blog home URL.


Common Errors and Solutions


1. REST API restricted to authenticated users


  • This happens due to some restrictions set to REST API access on your site.


Troubleshooting:


Plugins:

  • Check if there are any plugins installed to disable REST API.
  • The plugins which might disable the REST API are - “Disable REST API, Disable WP REST API, Falcon, Jetpack, Wordfence Security, iThemes Security, WP Rocket, JWT Auth, WP-SpamShield, WP Content Copy Protection & No Right Click, Limit Login Attempts Reloaded, SiteGuard WP Plugin, IP Geo Block, WPS Hide Login, reCaptcha by BestWebSoft, Profile Builder.” These are just a few examples. You can look for similar plugins related to REST API and Wordpress optimization & tweaks.
  •  You will have to try disabling these plugins and try reconnecting the website on Narrato.
  • If the above doesn’t help then please try the next solution.


If this above does not resolve the issue, try updating the configs:

  • Edit the .htaccess file available in /opt/bitnami/apps/wordpress/htdocs (This file is hidden, don't freak out if you can't see it)
  • Add a new line under RewriteEngine On and insert RewriteRule .* - [E=REMOTE_USER:%{HTTP:Authorization}] save and exit
  • Edit /opt/bitnami/apps/wordpress/conf/httpd-app.conf add a new line after RewriteEngine On
  • In the new line insert: RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] save and exit
  • Restart Apache: sudo /opt/bitnami/ctlscript.sh restart apache
  • (OPTIONAL) Install Application Passwords By George Stephanis



2. Issue in authorization flow - connection


Troubleshooting:




  • Right click on your web page > Inspect, if you see ‘403 forbidden’ or similar error on console then the authorization was blocked by some plugin or your service provider (host provider).
  • The plugins which might affect the authorization are - “Jetpack, Wordfence Security, iThemes Security, WP Rocket, JWT Auth, WP-SpamShield, WP Content Copy Protection & No Right Click, Limit Login Attempts Reloaded, SiteGuard WP Plugin, IP Geo Block, WPS Hide Login, reCaptcha by BestWebSoft, Profile Builder.” You will have to try disabling these plugins and try reconnecting the website on Narrato.




  • Here is an example of authorization blocked by Godaddy (website host) firewall. In such cases, whitelist the IP. You can get this info by clicking on the 403 url on the console. You will be taken to the network tab, click on the same url (shown in red) and you will see the detailed information.


3. Error while publishing post


  • While trying to publish posts, you are getting the below error and post publishing is failing.
  • This means that the connected Wordpress site’s status is changed to ‘revoked’.



'API Error: Sorry, you are not allowed to create posts as this user.'


Troubleshooting:


  • On the Wordpress site for the connected user account, check if the application password / token has been revoked or removed for the Narrato app.
  • If it has been removed or if you are not seeing the application password / token for Narrato app then:
  • Delete the Wordpress site from the Narrato dashboard and add it back. The Wordpress site’s status should be set to ‘active’ now.
  • Make sure the application password / token is available now on the user page.







  • If the connection still doesn’t work, then try this:
  • Edit the .htaccess file available in /opt/bitnami/apps/wordpress/htdocs (This file is hidden, don't freak out if you can't see it)
  • Add a new line under RewriteEngine On and insert RewriteRule .* - [E=REMOTE_USER:%{HTTP:Authorization}] save and exit
  • Edit /opt/bitnami/apps/wordpress/conf/httpd-app.conf add a new line after RewriteEngine On
  • In the new line insert: RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] save and exit
  • Restart Apache: sudo /opt/bitnami/ctlscript.sh restart apache
  • (OPTIONAL) Install Application Passwords By George Stephanis. Not required for Wordpress versions 5.6 and above.
  • Delete the Wordpress site from the Narrato dashboard and add it back. The Wordpress site’s status should be set to ‘active’ now.



4. Unable to connect the site or receiving 403 Forbidden response




  • In this case, it is very likely that our website’s IP address has been blocked by your site’s host provider - by firewall or similar security plugin. You will need to unblock or whitelist our IP address to continue connecting your site. Please get in touch with us to get a list of IPs you should whitelist.
  • Also, make sure there are no security plugins installed on your Wordpress site which are blocking our IP address.