> For the complete documentation index, see [llms.txt](https://docs.kangal.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kangal.dev/tr/entegrasyonlar/troubleshooting.md).

# Sorun giderme

Credential veya network policy değiştirmeden önce entegrasyon durumunu ve en son sync-history kaydını inceleyin.

## Configuration required

Provider kurulmuş ancak zorunlu alanlardan biri veya birkaçı boş. Formu provider rehberiyle karşılaştırın ve credential değerlerini secret alanlarında tutun.

## Authentication veya authorization hatası

1. Credential'ın süresinin dolmadığını veya iptal edilmediğini doğrulayın.
2. Provider scope ve organization erişimini kontrol edin.
3. SSO veya administrator approval gereksinimlerini inceleyin.
4. Credential açığa çıktıysa yenileyin.
5. Yeni secret değerini kaydedip tekrar sync çalıştırın.

## Network, DNS veya TLS hatası

1. Provider hostname'ini Kangal worker ortamından çözümleyin.
2. Outbound TCP 443 erişimini doğrulayın.
3. Güvenilir certificate authority ve TLS interception kurallarını kontrol edin.
4. Proxy, firewall ve Kubernetes NetworkPolicy ayarlarını inceleyin.
5. Custom endpoint'in onaylanmış HTTPS origin kullandığını doğrulayın.

## Rate limiting

Kangal, provider sunduğunda rate-limit ve `Retry-After` metadata'sını kaydeder. Retry süresini bekleyin, sync sıklığını azaltın veya provider limitini artırın. Provider kısıtını aşmak için çok sayıda credential oluşturmayın.

## Sync pending durumunda kalıyor

1. Worker health ve Redis bağlantısını kontrol edin.
2. Retry ve dead-letter durumunu inceleyin.
3. Provider endpoint'inin worker'dan erişilebilir olduğunu doğrulayın.
4. Temel nedeni düzelttikten sonra replay yapın.

## Destek için gerekli kanıt

Kangal sync ID, timestamp, provider slug, standartlaştırılmış hata kategorisi ve provider request ID bilgilerini paylaşın. Destek verisine hiçbir zaman düz metin credential eklemeyin.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kangal.dev/tr/entegrasyonlar/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.