[Aior]

WHMCS Login: "Invalid CSRF Protection Token" Sorununun Çözümü

WHMCS yönetici alanından dışlandıysanız ve "Invalid CSRF Protection Token" hatasıyla karşılaşıyorsanız, sorun gidermek ve erişimi yeniden kazanmak için bu adımları izleyin.



Adım 1: WHMCS Sistem URL'ni ve SSL Kurulumunu Doğrulayın

1. WHMCS Sistem URL'nizin (Setup > General Settings veya tblconfiguration tablosunda bulunur) WHMCS'e erişmek için kullandığınız gerçek domain/URL ile eşleştiğinden emin olun, SSL varsa https:// dahil.
2. www ile www olmayanı karıştırmadığınızı veya http ile https arasında geçiş yapmadığınızı onaylayın. Herhangi bir uyuşmazlık token kontrollerini geçersiz kılabilir.

Adım 2: Session Dizini İzinlerini Kontrol Edin veya Database Sessions'a Geçin

1. Session dizininin yazılabilir olduğundan emin olun. cPanel + CloudLinux sunucularda varsayılan yol /var/cpanel/php/sessions/alt-php82 olabilir. Sahipliğin doğru olduğunu (örneğin nobody:nobody veya root:root) ve izinlerin 1733 (drwx-wx-wt) olduğunu doğrulayın.
2. Database Sessions'a geçin (Gerekirse): Dosya tabanlı session'lar sorunlu kalıyorsa, WHMCS configuration.php'nizi düzenleyerek atlayın:
   

   $session_handling = 'database';

   Bu değişiklik WHMCS'e session'ları veritabanında saklamasını söyler ve dosya izni veya yol sorunlarını çözer.

Adım 3: reCAPTCHA'yı Ayarlayın veya Devre Dışı Bırakın

1. reCAPTCHA v3 Eşiğini Düşürün: Çok yüksek eşikli (örneğin 1.0) reCAPTCHA v3 kullanıyorsanız, meşru girişleri bloklayabilir ve CSRF token hatalarına yol açabilir veya onları büyütebilir. Eşiği (örneğin 0.7 veya 0.8'e) Setup > General Settings > Security veya Setup > Captcha Settings'te düşürün.
2. Captcha'yı Geçici Devre Dışı Bırakın: Tamamen dışlandıysanız, giriş yapmak için login formu için Captcha'yı devre dışı bırakın. Yönetici erişimini tekrar kazandığınızda Captcha'yı etkinleştirin ve eşiği uygun seviyeye ayarlayın.

Adım 4: Tarayıcı Cache & Çerezleri Temizleyin

• Mevcut WHMCS login sekmelerinizi kapatın ve tarayıcı cache/çerezlerini temizleyin.
• Alternatif olarak, incognito veya private window'dan giriş deneyin.
• Eski veya çakışan session çerezleri token uyuşmazlıklarına neden olabilir.

Adım 5: Sunucu Saatini ve Diğer Güvenlik Ayarlarını Doğrulayın

1. Sunucu Saatini Senkronize Edin: Sistem saatindeki büyük uyuşmazlıklar CSRF token'larının erken sona ermesine yol açabilir. Sunucunuzun NTP ile senkronize olduğundan veya başka şekilde doğru tutulduğundan emin olun.
2. Güvenlik Modüllerini Yeniden Kontrol Edin: ModSecurity veya bir firewall form alanlarını çıkarıyor veya post'ları bloke ediyorsa, token başarısız olabilir. Gerekirse kuralları geçici devre dışı bırakın veya ayarlayın.

Adım 6: Çözümden Sonra Güvenlik Ayarlarını Geri Getirin

1. Başarıyla giriş yapabildiğinizi onayladıktan sonra, devre dışı bıraktığınız tüm güvenlik önlemlerini yeniden etkinleştirin (örneğin login formları için Captcha).
2. Geçici olarak database session'lara geçtiyseniz, session dizini izinleri düzeltildikten sonra öyle kalmaya karar verin veya dosya tabanlıya geri dönün.

WHMCS'teki "Invalid CSRF Protection Token" hatası genellikle session yönetimi veya captcha yanlış yapılandırmasından kaynaklanır. Sistem URL'nizi, session dizini izinlerini ve reCAPTCHA ayarlarını doğrulayarak başlayın. Her şey başarısız olursa, database session'lara geçin ve erişimi geri kazanana kadar reCAPTCHA eşiklerini ayarlayın. Giriş yapabildiğinizde, her şeyin hem güvenli hem erişilebilir kalması için güvenlik ayarlarınızı geri yükleyin veya ince ayarlayın. Sorun devam ederse, sunucu loglarınızı inceleyin veya daha derin yardım için hosting sağlayıcınıza başvurun.

WHMCS Login: "Invalid CSRF Protection Token" Problem Solution

If you are locked out of the WHMCS admin area and encounter the "Invalid CSRF Protection Token" error, follow these steps to troubleshoot and regain access.



Step 1: Verify Your WHMCS System URL and SSL Setup

1. Make sure your WHMCS System URL (found in Setup > General Settings or the tblconfiguration table) matches the actual domain/URL you use to access WHMCS, including https:// if you have SSL.
2. Confirm you're not mixing www and non-www or switching between http and https. Any mismatch can invalidate token checks.

Step 2: Check Session Directory Permissions or Switch to Database Sessions

1. Ensure the session directory is writable. On cPanel + CloudLinux servers, the default path might be /var/cpanel/php/sessions/alt-php82. Verify ownership is correct (e.g., nobody:nobody or root:root) and permissions are set to 1733 (drwx-wx-wt).
2. Switch to Database Sessions (If Needed): If file-based sessions remain problematic, bypass them by editing your WHMCS configuration.php:
   

   $session_handling = 'database';

   This change tells WHMCS to store sessions in the database, resolving any file permission or path issues.

Step 3: Adjust or Disable reCAPTCHA

1. Lower reCAPTCHA v3 Threshold: If you're using reCAPTCHA v3 with a threshold that's too high (e.g., 1.0), it may block legitimate logins, causing or amplifying CSRF token errors. Decrease the threshold (e.g., to 0.7 or 0.8) in Setup > General Settings > Security or Setup > Captcha Settings.
2. Temporarily Disable Captcha: If you're completely locked out, disable Captcha for the login form to gain entry. Once you have admin access again, enable Captcha and adjust the threshold to a suitable level.

Step 4: Clear Browser Cache & Cookies

• Close your current WHMCS login tabs, and clear your browser cache/cookies.
• Alternatively, try logging in from an incognito or private window.
• Stale or conflicting session cookies can cause token mismatches.

Step 5: Verify Server Time and Other Security Settings

1. Sync Server Time: Large discrepancies in system clock can lead to CSRF tokens expiring prematurely. Ensure your server is synced via NTP or otherwise kept accurate.
2. Re-check Security Modules: If ModSecurity or a firewall is stripping form fields or blocking posts, the token might fail. Temporarily disable or tweak rules if necessary.

Step 6: Reintroduce Security Settings Once Resolved

1. After you've confirmed you can log in successfully, re-enable any security measures you disabled, such as Captcha for login forms.
2. If you switched to database sessions temporarily, decide whether to keep it that way or revert to file-based sessions once the session directory permissions are fixed.

The "Invalid CSRF Protection Token" error in WHMCS often boils down to session management or captcha misconfiguration. Start by verifying your System URL, session directory permissions, and reCAPTCHA settings. If all else fails, switch to database sessions and adjust reCAPTCHA thresholds until you regain access. Once you can log in, restore or fine-tune your security settings so everything remains both secure and accessible. If the problem persists, review your server logs or contact your hosting provider for more in-depth assistance.