ZREST – SAP ABAP REST & OpenAPI Altyapısı

Çözdüğü Sorun

SAP tarafında bir REST servisi yazmak zor değil. Zor olan, o servisin kurum içinde anlaşılır ve kullanılabilir kalması.

Tipik senaryo şudur: e-ticaret ekibi bir entegrasyon için SAP'tan servis ister. ABAP tarafında servis yazılır. Sonra karşı tarafa hangi alanların gönderileceği Excel'de veya e-postada anlatılır. Bir alan eklenir, dokümantasyon güncellenmez. Yeni gelen bir geliştirici servisin ne döndürdüğünü öğrenmek için ABAP kodunu okumak zorunda kalır. Test için elle Postman koleksiyonu hazırlanır ve o da bir süre sonra bayatlar.

Sonuç: servis çalışıyordur ama kimse ondan emin değildir. Entegrasyon toplantılarının önemli bir kısmı "bu alan hâlâ geliyor mu?" sorusuna gider.

ZREST bu döngüyü kırmak için yazıldı: servis tanımı ile dokümantasyon aynı kaynaktan üretilir, dolayısıyla dokümantasyonun bayatlaması mümkün olmaz.

Öne Çıkan Özellikler

Dokümantasyon Nasıl Çalışıyor?

Kullanıcı SAP sistemindeki dokümantasyon adresini açar. Sayfanın HTML'i SAP tarafında üretilir; arayüz bileşenleri Önder Yazılım sunucusundan yüklenir. OpenAPI dokümanının kendisi SAP sisteminden hiç çıkmaz.

1. Kullanıcı https://<sap-sunucunuz>/<SICF düğüm yolunuz>/swagger.html adresini açar.
2. SAP, içinde tek bir script satırı bulunan hafif bir HTML sayfası döner.
3. Tarayıcı arayüz dosyalarını Önder Yazılım'dan çeker ve lisans doğrulanır.
4. Arayüz, OpenAPI dokümanını aynı SAP sunucusundan okuyup servisleri listeler.

Bu kurgunun pratik faydası: doküman ile sayfa aynı sunucuda olduğu için tarayıcı açısından aynı köken sayılırlar. Yani Basis ekibinizden CORS ayarı, ek başlık veya güvenlik istisnası istenmez — kurulumu geciktiren en yaygın kalem böylece devre dışı kalır.

Veri Güvenliği

Bir SAP servis dokümantasyonu, kurumun iş süreçlerinin haritasıdır. Bu yüzden ürünün en net taahhüdü şudur:

• SAP sisteminiz dışarıya bağlanmaz. Doğrulama trafiği kullanıcının tarayıcısı üzerinden geçer; SAP sunucusundan internete giden bir çağrı yoktur. Bu, dışa erişimi kapalı üretim sistemlerinde de çalışması demektir — güvenlik duvarı, proxy veya STRUST sertifika işi gerekmez.
• OpenAPI dokümanınız bizde tutulmaz. Doküman SAP sunucunuzdan tarayıcıya gider; Önder Yazılım sunucusuna hiç uğramaz.
• İş verisi geçmez. "Try it out" istekleri doğrudan sizin SAP sunucunuza gider.
• Üçüncü taraf doğrulayıcı kapalı. Swagger UI varsayılan olarak servis adresinizi harici bir doğrulama servisine gönderir; ZREST'te bu özellik kapatılmıştır ve açılamaz. Sunucu adresiniz kurum dışına çıkmaz.
• Kayıt altına alınan: lisans doğrulaması sırasında yalnızca lisans anahtarı, isteğin geldiği sunucu adı ve zaman bilgisi tutulur.

Kurulum

Kurulum üç adımdır ve tamamı SAP tarafında yapılır:

1. Transport'u içe alın. ZREST paketi standart bir transport isteği olarak sisteminize aktarılır.
2. Servis düğümünü aktive edin. SICF üzerinden ilgili düğüm aktive edilir.
3. Lisans anahtarını girin. Size verilen anahtar, sisteme özel bir tabloya (SM30) girilir. DEV, QAS ve PRD kendi anahtarını kullanır; anahtar transport ile taşınmaz.

Lisanslama

ZREST lisanslı bir üründür. Lisans SAP sistemi bazındadır: her sistem (DEV / QAS / PRD) kendi anahtarını kullanır ve anahtar, tanımlandığı sunucu adına bağlıdır. Süre bitimine yaklaşıldığında dokümantasyon ekranında hatırlatma görünür; servisleriniz bundan etkilenmez.