Operasyon
Sorun giderme
Önce denetim kaydına bakın: her engelin reason ve ruleId alanı nedenini söyler (Denetim kaydı).
| Belirti | Olası neden | Çözüm |
|---|---|---|
Ağ geçidi açılmıyor: could not reach AvertGate … to resolve policy | Panel adresine ulaşılamıyor (ağ, proxy, yanlış taban adres). | Adresi ve ağ erişimini kontrol edin. Politika çözülemezse ağ geçidi bilerek başlamaz. |
Ağ geçidi açılmıyor: rejected the API key or agent (HTTP …) | API anahtarı ya da ajan anahtarı geçersiz, iptal edilmiş ya da ajan silinmiş. | Panelde ajanı ve anahtarları doğrulayın; gerekirse yeni anahtar üretin. |
Araç hep BLOCK alıyor | unlisted_tools: deny: politikada olmayan araç reddedilir. | Aracı sunucunuzun listelediği adla politikaya ekleyin. Önce --shadow ile gözlemleyin. |
Beklenmeyen BLOCK | Kısıt, egress taraması, loop breaker ya da yanıt taraması. | Kaydın ruleId değerine bakın (dlp_exfiltration, loop-breaker, ingress_prompt_injection gibi). |
| Araç çalıştı ama ajan sonucu görmedi | Yanıt taraması sonucu şüpheli buldu; sonuç ajandan saklandı. | Kayıttaki "ingress scan detected …" nedenine bakın. Bkz. Çalışma döngüsü. |
Onay gelmiyor ya da hemen BLOCK | SLACK_WEBHOOK_URL var ama APPROVAL_BASE_URL yok; ya da 2 dakikalık süre doldu. | İki değişkeni de ayarlayın; süreyi APPROVAL_TIMEOUT_MS ile değiştirin. |
Politikayı değiştirdim, etkisi yok: policy reload failed … keeping active policy intact | Yeni dosya geçersiz; önceki politika kullanılmaya devam ediyor. | Hatayı düzeltin. Doğrulama için bkz. Politika dosyası. |
Panelde olay görünmüyor: telemetry failed to reach cloud veya telemetry ingest returned HTTP … | Panele bağlantı yok ya da anahtar reddediliyor. | Bağlantıyı ve API anahtarını kontrol edin. Araç çağrıları etkilenmez; yerel denetim kaydı yazılır. |
| Denetim zinciri doğrulanmıyor | Kayıt dosyası değiştirilmiş ya da bozulmuş. | avertgate verify çalıştırın; zincir geçersizse sonucu raporlar ve çıkış kodu 1 olur. |
Hata raporu hazırlarkenOlay kaydındaki
reason, ruleId ve zaman damgasını paylaşın. Politika dosyasını paylaşmadan önce içindeki sırları çıkarın.