Apidog Ağustos 2026 Güncellemeleri: GitHub Enterprise Cloud, SSO ve Kurumsal Yönetim API'leri
Apidog 2.8.41–2.8.44 sürümleri, Ağustos ayında kurumsal API operasyonlarının üç temel alanını güçlendirdi: yönetilen Git bağlantıları, kimlik odaklı proje erişimi ve daha kullanışlı, izlenebilir API tabanlı yönetim.
Kurumsal API ekipleri depoları, kimlikleri ve üyelikleri API platformu dışındaki sistemlerle yönetiyor. Bu sürümler, bu bağlantıları geliştirirken proje kurulumu, içe aktarma, dallar, dokümantasyon, CLI iş akışları ve test yürütme süreçlerinde de güvenilirlik iyileştirmeleri sunuyor.
Öne çıkanlar
-
GitHub Enterprise Cloud: Apidog'u özel
*.ghe.comveri yerleşimi alan adlarına bağlayın. - SSO yönetimi ve proje erişimi: SSO oturumlarını kuruluş çalışmalarıyla sınırlandırın ve SAML Grup Eşleştirmesi ile proje erişimi başlatın.
- Kurumsal yönetim API'leri: Daha zengin üye verileri alın, ekip erişimini otomatikleştirin ve desteklenen API işlemlerini denetim izine dahil edin.
1. Veri yerleşimi iş akışları için GitHub Enterprise Cloud
Veri yerleşimi kullanan GitHub Enterprise Cloud müşterileri, depolarını genel github.com alan adı yerine özel *.ghe.com alan adlarında barındırabilir. Apidog artık bu dağıtımlara bağlanabiliyor.
Kuruluşunuzun *.ghe.com ana bilgisayarına bağlanın
Kuruluş yöneticileri, OAuth Uygulaması İstemci Kimliği ve İstemci Gizli Anahtarı ile bir GitHub Enterprise Cloud ana bilgisayarı yapılandırabilir. Yetkilendirme akışı bu kurumsal ana bilgisayarı kullanarak gerekli kuruluş, depo, dal ve dosya erişimini sağlar.
Bu bağlantı üç iş akışını destekler:
- Git Bağlantısı: API tanımlarıyla, kuruluşunuzun kontrol ettiği depo ve dallar üzerinden çalışın.
- Depo içe aktarma: Kurumsal depolardaki OpenAPI veya Swagger dosyalarını Apidog'a aktarın.
- OpenAPI yedeklemesi: API tanımlarını ekibin seçtiği kurumsal depo ve dala yedekleyin.
Böylece ekipler, Apidog'un Git tabanlı içe aktarma, yedekleme ve işbirliği özelliklerini kullanırken depo yönetimi ile veri yerleşimi modellerini koruyabilir.
Kapsam: Bu özellik, özel
*.ghe.comSaaS alan adlarındaki GitHub Enterprise Cloud veri yerleşimi dağıtımlarıyla sınırlıdır. Kendi kendine barındırılan GitHub Enterprise Server alan adları için genel destek sağlamaz.
2. Daha güçlü SSO yönetimi ve proje erişimi
Kurumsal SSO yalnızca kullanıcı doğrulamaz. Oturumu doğru kuruluşa odaklamalı ve kimlik sağlayıcı üyeliğini, kullanıcıların çalıştığı projelerde öngörülebilir izinlere dönüştürmelidir.
SSO oturumlarını kuruluş çalışmalarına odaklayın
SSO oturum izolasyonu etkinleştirildiğinde Apidog:
- Kişisel ekip ve projelere giriş noktalarını azaltır.
- Kuruluş çalışmalarını kişisel alanlara taşıyabilecek, kopyalayabilecek veya çoğaltabilecek seçili eylemleri sınırlar.
- Kullanıcıları SSO oturumuyla ilişkili kuruluş ve ekip çalışmalarına odaklar.
Bu kontroller, SSO oturum izolasyonunu etkinleştirmeyen kuruluşların normal deneyimini değiştirmez.
Ekip üyeliğini proje düzeyinde erişime taşıyın
SAML Grup Eşleştirmesi, artık senkronize edilen ekibin altındaki projelere de başlangıç erişimi sağlayabiliyor.
| Senkronize ekip rolü | Ekip altındaki projelere ilk erişim |
|---|---|
| Ekip Yöneticisi | Düzenleyici |
| Diğer ekip üyeleri | Salt okunur |
Eşlenmiş bir kullanıcı ekipten çıkarıldığında, Apidog ilgili proje üyeliğini de senkronize eder. Böylece kimlik sağlayıcı grupları, ekip rolleri ve proje izinleri arasındaki operasyonel boşluk azalır.
Sonuç olarak yöneticiler işe alım ve işten çıkarma sonrasında proje izinlerini daha az manuel işlemle yönetebilir; kullanıcılar ise ekibe katıldıklarında tutarlı bir başlangıç erişimine sahip olur.
3. Daha eksiksiz ve denetlenebilir kurumsal yönetim API'leri
Kurumsal yöneticiler üyeleri envanterlemek, kimlik sistemlerini bağlamak ve rutin yönetimi otomatikleştirmek için API'lere güvenir. Bu sürümler, bu iş akışlarını daha kullanışlı ve güvenli hale getiriyor.
Daha kullanışlı kuruluş üyesi verileri alın
Kuruluş Üyeleri API'si artık üyelik bilgilerinin yanı sıra e-posta adreslerini ve daha güvenilir üye adlarını döndürür:
GET /v1/organizations/{organizationId}/members
Bir üye takma ad belirlememişse Apidog, mevcut profil bilgilerini kullanarak döndürülen adı oluşturabilir. Geçerli e-posta adresi olmayan üyeler — bekleyen veya sağlanmış kayıtlar dahil — eksik alan yerine açıkça null döndürür.
Bu bilgiler şu iş akışlarını kolaylaştırır:
- Üye envanteri: İnceleme için gereken temel bilgileri tek API yanıtında alın.
- Otomatik senkronizasyon: Harici kimlik ve yönetim sistemlerinde kararlı üye verileri kullanın.
- Erişim incelemesi: Üyelik kayıtlarını manuel CSV dışa aktarmalarına ihtiyaç duymadan karşılaştırın.
Ekip rolleri atayın ve proje erişimini başlatın
Yöneticiler artık kullanıcıları e-posta adresiyle ekibe ekleyebilir ve desteklenen bir ekip rolü atayabilir:
POST /v1/team-access-grants
Her istek şunları açıkça belirtir:
- Ekip rolü: Yönetici, Üye veya Misafir
- Ekibin altında mevcut projelere erişimin nasıl başlatılacağı
mapped seçeneği, seçilen ekip rolüne göre eksik proje erişimini başlatırken mevcut geçerli proje rollerini korur. none seçeneğinde kullanıcı ekibe katılır ancak proje üyeliği almaz; proje erişimleri daha sonra ayrı ayrı atanabilir.
Uç nokta ayrıca:
- Henüz kuruluşa katılmamış kullanıcıları davetlemeyi,
- Daha önce ekipten ayrılmış üyeleri geri yüklemeyi,
- Mevcut etkin veya bekleyen ekip üyelerini ve Ekip Sahiplerini istenmeyen değişikliklerden korumayı destekler.
Kapsam: Proje erişimi başlatma yalnızca kullanıcı ilk katıldığında veya geri yüklendiğinde ekibin altında zaten bulunan projelere uygulanır. İzinleri sürekli olarak senkronize etmez, gelecekte oluşturulan projelere otomatik erişim vermez ve Ekip Sahibi, Faturalama Yöneticisi veya özel ekip rolleri atamaz.
Desteklenen API yönetimini denetim izine ekleyin
Mevcut denetim olaylarına karşılık gelen desteklenen harici idari API işlemleri artık denetim izinde görünür. Bu sayede arayüz üzerinden gerçekleştirilen eylemler ile otomasyon aracılığıyla gerçekleştirilen işlemler arasında daha iyi bir süreklilik sağlanır.
Daha zengin üye verileri, daha güvenli ekip erişimi otomasyonu ve genişletilmiş denetim kapsamı; işe alım, erişim incelemesi ve yönetişim süreçlerini görünürlükten ödün vermeden otomatikleştirmeyi kolaylaştırır.
Kapsam: Denetim kapsamı, mevcut denetim olaylarıyla ilişkili desteklenen harici API işlemlerini kapsar. Bu özellik, her API isteğinin veya yönetim uç noktasının evrensel olarak günlüğe kaydedildiği anlamına gelmez.
Diğer iyileştirmeler
Ağustos sürümleri, ortam yapılandırması, kurumsal politikalar, uluslararasılaştırma, spesifikasyon iş akışları ve proje yönetiminde de güncellemeler içeriyor.
Kurumsal ve ortam yönetimi
- Kuruluş üyeliği ilkesi: Kuruluş üyeliğini belirli e-posta adreslerine sahip kullanıcılarla sınırlandırın.
- Davet Ödül Politikası: Kuruluşlardan, ekiplerden veya projelerden gönderilen davetler için Kredi ödüllerini ve ilgili e-postaları devre dışı bırakın.
- Daha hızlı Modül Temel URL navigasyonu: Beşten fazla modül olduğunda ilk beş modülden sonraki girişler otomatik olarak daraltılır; arama özelliği gerekli hizmet yapılandırmasını bulmayı kolaylaştırır.
- Yerelleştirilmiş sistem e-postaları: Apidog sistem e-postaları alıcının seçtiği dili kullanır. Dil tercihi yoksa İngilizce kullanılır.
- Daha yönetilebilir kuruluşa ait ekipler: Kuruluş Sahipleri ve Yöneticileri Ekip Sahibi bilgilerini görüntüleyebilir, ekipleri sahiplik durumuna göre arayabilir veya filtreleyebilir ve bir ya da daha fazla ekibin sahipliğini devredebilir.
- Daha net proje üyesi yönetimi: Toplu üye düzenleme, üye ayrıntıları ve izin ayarları iyileştirildi. Ekip Sahibi rolleri desteklenmeyen değişikliklerden korunur.
- Geliştirilmiş kurumsal yönetim sayfaları: Kurumsal ayarlar, politikalar, Denetim Günlükleri, Gizli Tarayıcı ve SAML SSO sayfalarında daha tutarlı düzenler, yardım bağlantıları ve yükseltme sunumu sağlandı.
Proje kurulumu, içe aktarmalar ve spesifikasyonlar
- Daha güvenli mod değiştirme: Proje oluştururken Genel Mod ile Spesifikasyon Modu arasında geçiş yapıldığında forma girilen bilgiler korunur.
- Geliştirilmiş Postman içe aktarmaları: Genel değişkenler desteklenir; değişken adlarındaki boşluklar otomatik olarak işlenir.
-
Dosyalar arası
$refdesteği: Spesifikasyon Modundaki uç nokta önizlemeleri, ayrı OpenAPI dosyalarında bulunan desteklenen istek gövdelerini, şemaları ve yanıtları çözümleyebilir.
Dosyalar arası referanslarda Spectral lint, tam uç nokta referansları ve Form Modu referansları bu kapsama dahil değildir.
Önemli hata düzeltmeleri
Dal, içe aktarma, dışa aktarma ve kod oluşturma
- Apidog CLI OpenAPI içe aktarmaları artık yanlışlıkla ana dala değil, kullanıcının seçtiği dala yazılır.
- Alt dallardan yapılan yayın belgesi dışa aktarmaları ilgisiz modüllerden veya boş klasörlerden uç nokta içermez.
- Çoklu dal birleştirmeleri uç noktaları, test senaryolarını ve diğer kaynakları hedef dala daha güvenilir taşır.
- OpenAPI içe aktarımı sırasında Git Depo Bağlantısı Oluştur eylemi doğru yanıt verir.
- OpenAPI ve CLI dışa aktarmaları yalnızca seçilen modüllere, etiketlere ve klasörlere uyar.
- Modüller arası referans verilen şemalar kod oluşturma sırasında daha güvenilir korunur.
- VE ile ilgili Güvenlik Şemaları doğru şekilde dışa aktarılır.
Doğrulama ve paylaşılan dokümantasyon
- Katı mod yanıt doğrulaması,
allOfile oluşturulan şemaları doğru işler. - Ek özellikler üzerinden referans verilen şemalar paylaşılan API dokümantasyonunda doğru görünür.
- Varsayılan örnekler paylaşılan dokümantasyonda doğru görüntülenir.
- Oturumu kapatmış kullanıcılar herkese açık projeleri ziyaret ettiğinde Markdown belge sekmeleri tamamen oluşturulur.
CLI verileri ve test yürütmesi
- Yapay Zeka veya Apidog CLI ile oluşturulan genel değişkenler artık boş istemci tarafı değişken adları üretmez.
- Apidog CLI tarafından oluşturulan geçersiz etiket değerleri ön uç erişim hatalarına yol açmaz.
-
--scenarioolmadan oluşturulan proje düzeyindeki test verileri veri listesinde görünür kalır. - Ön ve son işlemci yürütme ayrıntıları, SSE isteği tamamlandıktan sonra değil, işlem sırasında konsolda görünür.
- Uzun metin veri kümesi değişkenleri kullanan test çalıştırmalarında veri kümesi adları korunur.
Bu düzeltmeler; yanlış dal hedefi, eksik dışa aktarma, eksik dokümantasyon ve yanıltıcı test geri bildirimi gibi sorunların önüne geçer.
Bunun anlamı nedir?
| Odak noktası | Ne gelişiyor? | Neden önemli? |
|---|---|---|
| Yönetilen Git bağlantısı | Apidog, Git Bağlantısı, depo içe aktarma ve OpenAPI yedeklemesi için *.ghe.com üzerindeki GitHub Enterprise Cloud veri yerleşimi ana bilgisayarlarına bağlanabilir. |
Ekipler depolarını GitHub ortamında ve kuruluşlarının kontrol ettiği dal yapısında tutar. |
| Kimlikten projeye erişim | SSO oturumları kişisel alanlara giriş noktalarını azaltır; SAML Grup Eşleştirmesi proje üyeliğini başlatır ve sürdürür. | İşe alım ve işten çıkarma daha öngörülebilir hale gelir, manuel izin onarımı azalır. |
| Denetlenebilir yönetim | Üye API'leri daha kullanışlı kimlik verileri döndürür; Ekip Erişimi Yetkilendirme API'si korumalı ekip katılımını ve açık proje erişimi başlatmayı destekler; desteklenen harici işlemler denetim olaylarına eklenir. | Ekipler işe alım, envanter, erişim incelemesi ve yönetişim süreçlerini kontrol ve görünürlükten ödün vermeden otomatikleştirir. |
Ek ortam, politika, spesifikasyon ve güvenilirlik iyileştirmeleri günlük iş akışlarını daha kararlı hale getiriyor. Daha geniş hedef ise kurumsal API programları büyürken depo yönetimi, kimlik erişimi ve idari otomasyonu uyumlu tutmak.
Sohbete katılın
Diğer API mühendisleri ve Apidog ekibiyle bağlantı kurun:
- Gerçek zamanlı tartışmalar ve destek için Discord topluluğuna katılın.
- Teknik konuşmalar için Slack topluluğuna katılın.
- En son güncellemeler için bizi X'te ve LinkedIn'de takip edin.
Öğe bazında sürüm notları için Apidog Değişiklik Günlüğü'ne göz atın:
— Apidog Ekibi

Top comments (0)