Security Plugin Issues
Security plugins can sometimes interfere with Google OAuth authentication. This guide covers specific issues and solutions for popular security plugins.
General Approach
Troubleshooting Steps
-
Identify the conflict:
- Temporarily disable security plugin
- Test Google sign-in
- If it works, security plugin is the cause
-
Find specific feature:
- Re-enable security plugin
- Disable features one by one
- Test after each change
-
Create exception:
- Add OneTap endpoints to allowlist
- Configure firewall exceptions
- Whitelist specific IPs if needed
Endpoints to Whitelist
/wp-json/onetap/v1/callback
/wp-json/onetap/v1/nonce
/wp-json/onetap/v1/test
Wordfence
Firewall Blocking Callback
Symptom: 403 error after Google consent
Solution:
- Go to Wordfence > Firewall
- Click Manage Firewall
- In Whitelisted URLs, add:
/wp-json/onetap/v1/callback - Save Changes
Rate Limiting Conflicts
Symptom: Blocked after multiple sign-in attempts
Solution:
- Go to Wordfence > All Options
- Find Rate Limiting Rules
- Either:
- Whitelist your IP for testing
- Increase rate limits for REST API
Learning Mode Issues
Symptom: Works then stops after Learning Mode ends
Solution:
- After Learning Mode ends, check blocked requests
- Wordfence > Firewall > Blocking
- Find OneTap-related blocks
- Add to whitelist
Two-Factor Authentication
Wordfence 2FA is supported - see 2FA Plugins.
Solid Security (iThemes Security)
404 Detection Blocking
Symptom: IP blocked after testing
Solution:
- Go to Security > Configure
- Find 404 Detection
- Add to exclusion list:
/wp-json/onetap
Banned Users List
Symptom: Specific IP can't authenticate
Solution:
- Go to Security > Configure > Lockouts
- Check Banned Users list
- Remove your IP if listed
- Add to whitelist if needed
File Change Detection Alerts
Symptom: Alerts about OneTap plugin files
Solution:
- Go to Security > Configure > File Change
- Add to exclusions:
wp-content/plugins/onetap-login-for-woocommerce/
Network Brute Force
Symptom: Blocked by network-level protection
Solution:
- Go to Security > Configure > Network Brute Force
- Note: This uses iThemes network data
- If wrongly blocked, contact iThemes support
Sucuri Security
WAF Blocking
Symptom: 403 or blocked by Sucuri
Solution (Sucuri Firewall/WAF):
- Login to Sucuri dashboard
- Go to Firewall > Settings
- Add to Allowlist:
Path: /wp-json/onetap/* - Or contact Sucuri support for assistance
Scanner False Positives
Symptom: Plugin flagged as suspicious
Solution:
- OneTap is safe - it's from WordPress.org
- In Sucuri, add to known files
- Contact Sucuri if persistent
Hardening Issues
Symptom: REST API blocked by hardening
Solution:
- Go to Sucuri Security > Hardening
- Ensure REST API is not completely disabled
- May need to allow specific REST endpoints
All In One WP Security
Firewall Rules
Symptom: Blocked by 6G/7G firewall
Solution:
- Go to WP Security > Firewall
- Check Basic Firewall Rules
- May need to disable temporarily to test
- Or add custom rule to allow OneTap paths
User Login Settings
Symptom: Locked out during testing
Solution:
- Go to WP Security > User Login
- Check Login Lockdown
- Whitelist your IP:
[Your IP address] - Or increase max login attempts
CAPTCHA Conflicts
Symptom: CAPTCHA appears after Google auth
Solution:
- Go to WP Security > Brute Force
- Find CAPTCHA settings
- Consider disabling for REST API endpoints
- Or for logged-in users
Shield Security
Bot Detection
Symptom: Blocked as bot
Solution:
- Go to Shield > Bot Detection
- Find exception settings
- Add:
Path: /wp-json/onetap/*
Bypass: Yes
Login Guard
Symptom: Extra verification required
Solution:
Shield's Login Guard may trigger:
- Go to Shield > Login Protection
- Review settings
- May need to adjust for OAuth flows
Defender Pro (WPMU DEV)
Firewall Blocking
Symptom: 403 on callback URL
Solution:
- Go to Defender > Firewall > IP Lockout
- Click Allowlist
- Add allowlist entry:
Type: URL
URL: /wp-json/onetap/v1/callback - Save
Login Protection
Symptom: Extra challenges after Google auth
Solution:
- Go to Defender > Login Protection
- Review Login Lockout settings
- Whitelist IP if testing repeatedly
Recommendations Scanner
Symptom: Security recommendations about OneTap
Solution:
- OneTap follows security best practices
- Review recommendations individually
- Most are informational
NinjaFirewall
Strict Policy Blocking
Symptom: Blocked by firewall rules
Solution:
- Go to NinjaFirewall > Firewall Policies
- Find POST/GET restrictions
- Add exception:
// In NinjaFirewall rules
$nfw_rules['whitelist'][] = '/wp-json/onetap/';
File Guard
Symptom: Changes blocked by File Guard
Solution:
- Temporarily disable File Guard during plugin updates
- Re-enable after update completes
BulletProof Security
.htaccess Rules
Symptom: REST API blocked by htaccess
Solution:
- Go to BPS Security > htaccess Security
- Check for REST API blocks
- Add exception for:
/wp-json/onetap/
Custom Code
Symptom: Custom security code blocking
Solution:
Review any custom .htaccess rules for:
- API endpoint restrictions
- POST request blocks
- Referrer checks
WP Cerber
Traffic Inspector
Symptom: OAuth requests blocked
Solution:
- Go to WP Cerber > Traffic Inspector
- Add to whitelist:
/wp-json/onetap/
Anti-spam
Symptom: Registration blocked as spam
Solution:
- Go to WP Cerber > Anti-spam
- Check user registration settings
- May need exception for Google-created users
General Solutions
REST API Whitelist Pattern
For most security plugins, whitelist:
/wp-json/onetap/*
Or specifically:
/wp-json/onetap/v1/callback
/wp-json/onetap/v1/nonce
IP Whitelist (for testing)
If you're locked out:
- Find your IP: https://whatismyip.com
- Add to security plugin whitelist
- Test thoroughly
- Consider removing after testing
User Agent Considerations
OneTap doesn't use a custom user agent, but ensure:
- Google's user agents aren't blocked
- OAuth callback doesn't get flagged
Temporary Disable Procedure
Safe way to test:
- Note current security settings
- Disable security plugin
- Test OneTap quickly
- Re-enable security plugin
- Create specific exceptions based on what worked
Debug Checklist
When troubleshooting:
- Check security plugin logs for blocks
- Note exact error message
- Test with security plugin disabled
- Check REST API is accessible:
/wp-json/ - Verify callback URL:
/wp-json/onetap/v1/callback - Look for rate limiting triggers
- Check for IP-based blocks
- Review firewall rules
Getting Help
Information to Gather
- Security plugin name and version
- Exact error message
- Security plugin logs/events
- Whether it works with plugin disabled
- WordPress debug log entries
Who to Contact
- OneTap Support: For plugin-specific issues
- Security Plugin Support: For their specific configuration
- Hosting Provider: If server-level security
Next Steps
- Cloudflare - CDN/WAF issues
- Debug Mode - Enable logging
- Common Issues - General troubleshooting