> 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/pluginler/plugins.md). # Plugin genel bakış Eklentiler, Kangal gateway trafiğine yeniden kullanılabilir politikalar uygular. Eklenti paketi kullanılabilir yapılandırmayı ve runtime davranışını tanımlar. Eklenti örneği ise paketi seçilen trafiğe bağlayan, tenant'a ait yapılandırmadır. Paket kurulumu, paketi tenant için kullanılabilir hâle getirir. Politikanın trafiğe uygulanması için ayrıca bir örnek oluşturulmalı ve etkinleştirilmelidir. ## Konsol iş akışı Konsoldaki **Eklentiler** bölümünü şu işlemler için kullanın: * yerleşik paketleri kurma ve yönetme; * tenant veya gateway kapsamında eklenti örnekleri oluşturma; * desteklenen paketleri yönlendirmeli form veya JSON ile yapılandırma; * örnekleri etkinleştirme, devre dışı bırakma, sıralama ve izleme. Workspace, service, route, consumer ve consumer-group kapsamları için Admin API'yi kullanın. Route tanımları inline eklentiler de içerebilir. ## Eklenti örneği oluşturma 1. Kullanılabilir paketleri `GET /plugin-packages` ile listeleyin. 2. Gerekli paketi tenant için kurun. 3. Geçerli bir `config` nesnesiyle örneği oluşturun veya upsert edin. 4. Trigger, kapsam, seçiciler ve önceliği belirleyin. 5. Örneği etkinleştirin. 6. Eşleşen trafik gönderip yürütme sağlığını ve gateway metriklerini inceleyin. `rate_limiter` paketini kurun: ```bash curl -X POST "$KANGAL_ADMIN_URL/plugin-packages/rate_limiter/install" \ -H "Authorization: Bearer $KANGAL_ADMIN_TOKEN" \ -H "Content-Type: application/json" \ -d '{"tenant_id":"tenant-a","version":"1.0.0"}' ``` Service kapsamlı bir örnek oluşturun. Üst düzey `scope` alanları trafiği, `config.limit_by` ise rate-limit kimliğini seçer. ```bash curl -X PUT "$KANGAL_ADMIN_URL/plugins/rate_limiter" \ -H "Authorization: Bearer $KANGAL_ADMIN_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "rate_limiter", "tenant_id": "tenant-a", "enabled": true, "trigger": "before_request", "scope": "service", "gateway_id": "gateway-1", "service_id": "service-orders", "priority": 100, "config": { "limit": 100, "window_seconds": 60, "limit_by": "consumer", "fault_tolerant": false } }' ``` `PUT /plugins/{name}`; tenant, paket adı ve kapsam seçicileriyle tanımlanan örneği upsert eder. Aynı trafikle eşleşebilecek başka bir örneğe özellikle ihtiyaç duyduğunuzda `POST /plugins` kullanın. ## Admin endpoint'leri | İşlem | Endpoint | | ------------------------------------- | -------------------------------------------------------------- | | Paketleri listeleme veya inceleme | `GET /plugin-packages`, `GET /plugin-packages/{name}` | | Kurma, güncelleme veya geri alma | `POST /plugin-packages/{name}/install`, `/update`, `/rollback` | | Örnekleri listeleme veya inceleme | `GET /plugins`, `GET /plugins/{plugin_id}` | | Örnek oluşturma veya upsert etme | `POST /plugins`, `PUT /plugins/{name}` | | Etkinleştirme veya devre dışı bırakma | `PATCH /plugins/{plugin_id}/enable?enabled=true\|false` | | Yapılandırmayı değiştirme | `PATCH /plugins/{plugin_id}/config` | | Örneği silme | `DELETE /plugins/{plugin_id}` | Bu endpoint'ler kimliği doğrulanmış yönetici gerektirir. Paket ve örnek değişiklikleri ayrıca tenant'ın `plugin.manage` yetkisini ister. ## Yapılandırma ve secret değerleri Kangal, `config` alanını kurulu paketin JSON Schema'sıyla doğrular. İsteğe bağlı schema varsayılanları doğrulama sırasında uygulanır. Geçersiz yapılandırma, etkilenen alan yoluyla birlikte `422` döndürür. Credential alanları kalıcı depolamadan önce şifrelenir ve Admin API yanıtlarında maskelenir. Eklenti destekliyorsa `vault://...` referanslarını tercih edin. Kaynak secret değerlerini onaylı bir secret manager'da saklayın ve `GET /plugins` yanıtındaki maskelenmiş değeri güncelleme isteğinde kullanmayın. ## Dokümantasyon * [Yapılandırma, kapsam ve sıra](/tr/pluginler/configuration-scopes.md) * [Kimlik doğrulama ve güvenlik](/tr/pluginler/auth-security.md) * [Trafik ve observability](/tr/pluginler/traffic-observability.md) * [Desteklenen eklenti referansı](/tr/pluginler/reference.md) * [Consumer'lar](/tr/consumerlar/consumers.md) * [Eklenti SDK'sı](/tr/sdklar/plugin-sdk.md) ## Operasyon önerileri * Bir eklenti diğerinin kullandığı state veya header'ı üretiyorsa açık öncelik belirleyin. * Consumer ve consumer-group kapsamları kimlik belirlendikten sonra uygulanır. Korunan trafikte bu kapsamları desteklenen bir kimlik doğrulama politikasıyla birlikte kullanın. * Birden fazla worker veya replica içeren gateway'lerde paylaşılan state kullanan trafik kontrollerini seçin. * Operasyon loglarını onaylı dış collector'a gönderin ve credential header'larını observability payload'larından çıkarın. --- # 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/pluginler/plugins.md?ask=&goal= ``` `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.