JSON Kayıtlarını Güvenli Webhook ile İzin Verilen Alanlara Sınırlayın
Gelen JSON kayıtları, izin verilen alanlar listesine göre güvenli bir webhook üzerinden otomatik olarak yalnızca gerekli alanlara indirgenir. Akış, girdileri doğrular, istenmeyen alanları kaldırır ve temizlenmiş kayıtlarla birlikte kaldırılan alanların istatistiğini sunar. Hatalı girişler net hata mesajlarıyla bildirilir. Geliştiriciler, veri yöneticileri ve entegratörler için, yapılandırılmış verileri ihracat, API veya üçüncü sistemlere otomatik hazırlamada etkili bir çözümdür.
Gelen JSON kayıtlarını bir POST webhook aracılığıyla izin verilen alanlar listesine göre otomatik olarak filtreleyebilirsiniz. Akış, girdilerin geçerli olup olmadığını kontrol eder: records ve allowedFields için boş olmayan diziler gereklidir, yasaklı alan adları bulunmamalı ve tüm kayıtlar nesne olmalıdır. Her kayıttan izin verilmeyen tüm alanlar kaldırılır. Sonuç olarak, temizlenmiş kayıtlar, kaldırılan alanların sayısı ve toplam kayıt sayısı elde edilir. Hatalı girişler, açık bir hata mesajı ve 'error' durumu ile yanıtlanır. Bu çözüm, verileri ihracat, arayüz veya üçüncü sistemler için otomatik olarak hazırlaması gereken geliştiriciler, veri yöneticileri veya entegratörler için uygundur. Webhook kimlik doğrulaması, yetkisiz erişimi önlemek için n8n içinde ayrı olarak yapılandırılmalıdır. Çalıştırma verileri n8n'de saklanır ve uygun şekilde yönetilmelidir. Alan listesi her istek için statiktir ve esnek olarak ayarlanabilir. Akış evrensel olarak kullanılabilir, ancak tam bir API doğrulaması veya dönüşümü sağlamaz; yalnızca izin verilen alanlar alınır, başka kontroller veya dönüşümler yapılmaz.
Yapay Zekâ Tarafından Oluşturulan Görsel
Kurulum
1. Workflow JSON dosyasını n8n'e içe aktarın.
2. Webhook düğümünü kontrol edin ve gerekirse yolunu ayarlayın.
3. İş akışında test dinleyicisini başlatın ve gösterilen test URL'sini kopyalayın.
4. n8n'de Webhook kimlik doğrulamasını (örneğin Basic Auth veya Header) yapılandırarak yetkisiz erişimi engelleyin.
5. curl veya Postman gibi bir araçla Content-Type application/json olan bir POST isteği gönderin (bkz. kullanım örneği).
6. Sonucu kontrol edin. Başarılıysa filtrelenmiş kayıtlar ve istatistikler döner, hata varsa yapılandırılmış bir hata mesajı alırsınız.
7. Başarılı testten sonra iş akışını yayınlayın/etkinleştirin ve Webhook düğümündeki üretim URL'sini kullanın.
8. İsteğe bağlı: n8n'de çalıştırma verilerinin saklanması ve erişim izinlerini yapılandırın.
Kullanım
1. Webhook URL'sine aşağıdaki JSON ile bir POST isteği gönderin:
```json
{
"records": [
{"id": 1, "name": "Max", "email": "max@example.com", "role": "admin"},
{"id": 2, "name": "Anna", "email": "anna@example.com", "role": "user"}
],
"allowedFields": ["id", "name"]
}
```
Beklenen yanıt:
```json
{
"status": "success",
"filteredRecords": [
{"id": 1, "name": "Max"},
{"id": 2, "name": "Anna"}
],
"removedFieldCount": 4,
"recordCount": 2
}
```
HTTP Durumu: 200
2. Geçersiz girişlerde (örneğin eksik alanlar veya yanlış türler):
```json
{
"records": [],
"allowedFields": ["id"]
}
```
Yanıt:
```json
{
"status": "error",
"message": "records und allowedFields müssen nicht-leere Arrays sein."
}
```
HTTP Durumu: 200
3. Webhook kimlik doğrulaması n8n'de ayrı olarak etkinleştirilmelidir. Kimlik doğrulama olmadan endpoint herkese açık olur.
4. allowedFields içindeki alan adları boş string veya '__proto__' gibi ayrılmış isimler içermemelidir.
5. Çalıştırma verileri n8n'de saklanır ve düzenli olarak yönetilmelidir.
Gerekli Bağlantılar ve API'ler
API Bağlantıları
İş akışı JSON'unda kayıtlı API erişim bilgisi bulunmadı. Etkinleştirmeden önce yine de webhookları, hedef sistemleri, erişim bilgilerini ve veri korumayı kontrol edin.
Düğümler
WebhookCodeRespond to Webhook
Yalıtılmış işlev testi başarılı
İsteğe bağlı yalıtılmış işlev testi
Yalıtılmış veri akışı, harici hizmetler veya erişim bilgileri olmadan test edildi.
✓ 5 test başarıyla tamamlandıTest edilen durumları gösterTest edilen durumları gizle
✓ Eksiksiz verilerle standart durumGeçerli örnek verilerle eksiksiz standart akışı denetler.Yalıtılmış işlev testi başarılı✓ Varyasyon veya sınır durumuGeçerli bir varyasyonu veya önemli bir sınır durumunu denetler.Yalıtılmış işlev testi başarılı✓ Ek işleme kuralıBu iş akışının ek işleme kuralını denetler.Yalıtılmış işlev testi başarılı✓ Geçersiz veya eksik girdiGeçersiz veya eksik verilerin kontrollü biçimde reddedildiğini denetler.Yalıtılmış işlev testi başarılı✓ Boş girdiBoş bir isteğin kontrollü bir yanıt aldığını denetler.Yalıtılmış işlev testi başarılı
