Export Import

bilgi

Yenilenen Dışa/İçe Aktarma Sihirbazı, bir nesneyi (API Proxy, Proxy Group, global politika, politika grubu vb.) ve ona bağlı tüm alt kaynakları tek bir pakette dışa aktarmanızı; bu paketi başka bir projeye veya başka bir kurulumdaki Apinizer'a içe aktarırken her bağımlılığı hedef ortamdaki karşılığıyla eşleştirmenizi sağlar. Amaç, bir yapılandırmayı elle yeniden kurmadan, referanslarını kaybetmeden başka bir projeye ya da ortama taşımaktır.

Desteklenen Nesne Tipleri

Sihirbazda dışa/içe aktarılabilecek nesne tipleri dört kategoride toplanır. Bağımlılık sütunu, o tipin dışa aktarımında ek bir bağımlılık adımı olup olmadığını gösterir:

Kategori	Nesne Tipi	Bağımlılık
API Yönetimi	API Proxy	Var
API Yönetimi	Proxy Group	Var
API Yönetimi	API Creator (DB'den API / Script'ten API / Mock API)	Var
API Yönetimi	Politika Grubu	Var
Genel Ayarlar	Global Politika	Var
Genel Ayarlar	Ayar Grubu (Settings Group)	Yok
Genel Ayarlar	Ortam Değişkeni	Yok
Kimlik	Sertifika / Key Store / Crypto Key / JWK	Yok
Kimlik	IP Grubu	Yok
Kimlik	Kimlik Bilgisi (Credential)	Var
AI	LLM Provider	Var
AI	Provider Definition	Yok
AI	Model Definition	Var
AI	Vector DB	Var
AI	Knowledge Base	Var
AI	PII Preset	Yok
AI	Prompt Guard Preset	Yok
AI	DLP Preset	Yok
AI	Prompt Template	Yok
AI	Prompt Decorator	Yok
AI	Topic Category	Yok

bilgi

MCP sunucusu veya A2A ajanı artık ayrı bir dışa/içe aktarılabilir nesne tipi değildir. Onu gömen politikanın (MCP Çağrısı (LLM) / MCP Araç Çağırma ya da A2A Çağrısı (LLM) / A2A Ajan Çağırma) içinde ve Passthrough modundaki bir MCP/A2A Gateway'inin kendi routing yapılandırması içinde, kendisini içeren API Proxy paketinin bir parçası olarak satır içi taşınır. Eski bir sürümden gelen ve hâlâ ayrı bir MCP/A2A bağlantı nesnesi taşıyan bir paket, sessizce atlanmak yerine içe aktarımda açıklayıcı bir hatayla reddedilir.

Kullanım Akışı

Akış, seçtiğiniz nesne tipinin bağımlılık taşıyıp taşımadığına göre otomatik şekillenir:

• Bağımlılığı olan tipler (API Proxy, Proxy Group, API Creator, Global Politika, Politika Grubu, Kimlik Bilgisi, LLM Provider, Model Definition, Vector DB, Knowledge Base) sihirbazın tam adımlarından geçer: nesne(ler) seçilir, bağımlılık ağacı çözümlenir, dışa aktarımda hangi bağımlılıkların pakete dahil edileceği seçilir; içe aktarımda ise her bağımlılık hedef projedeki karşılığıyla eşleştirilir. Seçilen kayıtların hiçbir bağımlılığı çözümlenmediyse (örn. bir Model Definition hiçbir özel sağlayıcı tanımına referans vermiyorsa ya da bir Vector DB bağlantısı hiçbir ortam değişkeni kullanmıyorsa) bu adımda açık bir "bağımlılık bulunamadı" boş-durum mesajı gösterilir.
• Bağımlılığı olmayan tipler (Ayar Grubu, Ortam Değişkeni, Sertifika ailesi, IP Grubu, Provider Definition, PII Preset, Prompt Guard Preset) için ek bir bağımlılık/eşleştirme adımı yoktur — nesne seçildiği anda doğrudan dışa aktarılır; içe aktarımda ise dosya yüklendiği anda doğrudan seçeneklere (Options) geçilir.

Dışa Aktarma

Tip Seç

Dışa aktarılacak nesne tipini (API Proxy, Global Politika, Kimlik Bilgisi vb.) seçin.

Nesne(leri) Seç

Projedeki nesneler listelenir; birden fazla nesne aynı anda işaretlenebilir.

Bağımlılıklar (varsa)

Seçilen nesne(ler)in kullandığı global politika, ayar grubu, sertifika, IP grubu, kimlik bilgisi, ortam/global değişken ve API Creator bağlantıları otomatik taranır. İstenmeyen bağımlılıkların işareti kaldırılabilir. Bir uyarı taraması (sertifika süresi, secret hatırlatmaları, eksik ortam değişkenleri) burada gösterilir.

Özet ve İndirme

Pakete dahil edilecek içerik özetlenir, dosya adı verilir ve paket ZIP olarak indirilir.

Bu adımdaki Paket Şifreleme (opsiyonel) başlığı altında pakete bir parola verebilirsiniz. Parola girdiğinizde bir Parola (tekrar) alanı görünür; iki alan birbirini tutmazsa Parolalar eşleşmiyor. uyarısı çıkar ve indirme düğmesi devre dışı kalır. Parola verilen paketin tamamı — içindeki nesne adları dahil — şifrelenir. Alanı boş bırakırsanız paket eskisi gibi düz üretilir.

Parola hiçbir yerde saklanmaz ve kurtarılamaz; kaybederseniz paket bir daha içe aktarılamaz.

İçe Aktarma

Tip Seç

İçe aktarılacak nesne tipini seçin. Yüklenen paket seçilen tiple uyuşmuyorsa sihirbaz paketin gerçek içeriğini tespit eder ve doğru tipi seçmeniz için uyarır.

Paketi Yükle

Export edilmiş ZIP/JSON dosyası yüklenir; paket içeriği (ana nesne, varsa üye API Proxy'ler, bağımlılıklar) analiz edilip listelenir.

Seçtiğiniz paketin şifreli olduğu otomatik olarak tespit edilir; bu durumda Bu paket şifreli başlığıyla bir parola alanı ve Kilidi aç düğmesi çıkar. Paket ancak kilidi açıldıktan sonra analiz edilir, dolayısıyla doğru parola girilmeden içeriği listelenemez. Yanlış parolada paket açılmaz — parola alanı temizlenir ve satır içi bir uyarı ile tekrar deneyebilirsiniz.

Eşleştirme (varsa)

Paketteki her bağımlılık hedef projedeki aynı türden mevcut bir nesneyle eşleştirilir; hedefte karşılığı yoksa pakette gelen tanımdan yeni bir nesne oluşturulabilir. Çoklu nesne içeren paketlerde istenmeyen nesneler içe aktarımdan çıkarılabilir.

Seçenekler

Import as New (yeni nesne olarak oluştur) ya da Replace Existing (hedefteki mevcut bir nesneyi tamamen güncelle) arasında seçim yapılır. API Proxy/Proxy Group için Client Route (relative path, host, metod, header) burada düzenlenebilir.

Import as New, kullanımda olan bir ismi reddeder ve hatada üç durumdan hangisi olduğu belirtilir: isim hedef projede zaten vardır (Replace Existing seçilir ya da burada yeniden adlandırılır), paketin kendisi aynı türden nesneler için aynı ismi iki kez taşımaktadır (kopyalardan biri yeniden adlandırılır) ya da isim bu kurulumda başka bir yerde kullanılmaktadır. Son durum, adları tüm projeler genelinde benzersiz olmak zorunda olan nesne türleri için geçerlidir — kimlik bilgisi kullanıcı adları, ortam değişkenleri, AI hazır ayar katalogları ve model tanımları — bu yüzden hedef projede nesne görünmese bile içe aktarma reddedilebilir; isim başka bir projeye, paylaşılan (admin) kapsama ya da yerleşik (built-in) bir kayda ait olabilir. Bu durumda Replace Existing seçeneğinin bu projede güncelleyeceği bir kayıt yoktur; nesneyi içe aktarmadan önce yeniden adlandırın ya da ismin sahibi olan projeye aktarın.

Özet ve İçe Aktarma

Hangi nesnenin oluşturulacağı, hangisinin eşleştirileceği özetlenir; onaylandığında içe aktarım uygulanır.

Paket Şifreleme

Şifreleme opsiyoneldir ve varsayılan olarak kapalıdır. Parola vermediğiniz paketler eskisi gibi üretilir ve önceki Apinizer sürümleriyle uyumlu kalır; şifrelemeyi kullanmaya başlamak için mevcut akışınızda hiçbir değişiklik yapmanız gerekmez.

Dışa aktarma sihirbazının son adımında bir parola verdiğinizde paketin tamamı şifrelenir. Bu koruma yalnızca paketin içindeki gizli değerleri değil, paketteki nesne adlarını da kapsar — paketi eline geçiren biri dosyanın dışından içeriği hakkında hiçbir şey anlayamaz; hangi proxy'lerin, sertifikaların ya da politikaların taşındığını dahi göremez.

Şifreleme anahtarı doğrudan sizin parolanızdan türetilir. Parolanın kendisi pakete yazılmaz ve Apinizer tarafında da saklanmaz; paketi açabilecek tek şey, dışa aktarım sırasında girdiğiniz parolanın aynısıdır.

uyarı

Parola kurtarılamaz. Apinizer parolayı saklamadığı için unutulan ya da kaybedilen bir parolayı sıfırlamanın veya paketten geri çıkarmanın yolu yoktur — paket bir daha içe aktarılamaz.

Paketi ve parolayı ayrı kanallardan paylaşın. Paketi e-posta ile gönderip parolayı da aynı e-postaya yazmak, şifrelemenin sağladığı korumayı ortadan kaldırır.

Ne Zaman Kullanmalı

Şifrelemeyi özellikle şu durumlarda tercih edin:

• Paket, sertifika özel anahtarı ya da key store parolası gibi gizli değerler taşıyorsa.
• Paket e-posta, dosya paylaşım servisi ya da ortak bir dizin gibi güvenli olmayan bir kanaldan geçecekse.

Paketin yalnızca güvenli bir ortamda kaldığı ve gizli değer taşımadığı durumlarda parola vermeden devam edebilirsiniz.

APIops Üzerinden Şifreleme

Aynı şifreleme, dışa/içe aktarımı APIops üzerinden otomatikleştirdiğinizde de kullanılabilir; sihirbazda ürettiğiniz şifreli bir paketi APIops ile içe aktarabilir ya da tersini yapabilirsiniz. Parametre ve istek başlığı ayrıntıları için ilgili API Referansı sayfalarına bakın: API Proxy Dışa Aktar, API Proxy İçe Aktar, Anahtar Dışa Aktar ve Key Store Dışa Aktar.

Mapping & Dependencies (Eşleştirme ve Bağımlılıklar)

Bağımlılık tespiti ve eşleştirme, sihirbazın en kritik parçasıdır — bir nesnenin taşınabilir olması, kullandığı her alt kaynağın hedefte doğru şekilde çözülmesine bağlıdır.

Politika Grubu Bağımlılığı Tespiti ve Eşleme

• Bir API Proxy, Proxy Group veya Politika Grubu dışa aktarıldığında içindeki her politika taranır; global olarak işaretli her politika (tekil ya da bir politika grubunun içindeki) ayrı bir bağımlılık olarak listelenir.
• Bir Politika Grubu'nun içindeki global politikalar, grubun kendisinden bağımsız olarak da ayrı birer bağımlılık olarak eklenir — böylece hedefte hem grup hem de içindeki global politikalar doğru şekilde oluşturulur veya eşlenir. Yerel (global olmayan) alt politikalar grupla birlikte gömülü taşınır.
• Her politika kendi içinde kullandığı sertifika, IP grubu ve kimlik bilgisini de ayrıca bağımlılık olarak yüzeye çıkarır (örn. bir JOSE politikasının kullandığı JWK, bir IP kural politikasının IP grubu).
• Bir Proxy Group dışa aktarıldığında üye API Proxy'lerin her biri, tek başına dışa aktarılmış gibi kendi tam bağımlılık ağacıyla çözülür.
• Aynı bağımlılık birden fazla seçili nesne tarafından kullanılıyorsa listede tek kopya olarak gösterilir, paylaşıldığı belirtilir ve pakete de tek kopya olarak yazılır.

Global Politika / Ortam Değişkeni / Kimlik Bilgisi Anahtarı Eşleme

• Bir Global Politika içe aktarımda hedefteki mevcut bir politikayla eşleştirilirse, onu kullanan tüm API Proxy, Proxy Group ve Politika Grubu kayıtlarındaki referans hedef politikaya yeniden yönlendirilir — böylece isim çakışmasından doğan bir kopya oluşmaz, aynı hedef politika kullanılmaya devam eder.
• Ortam değişkeni bağımlılıkları isme göre eşleştirilir: paketteki her ${DEĞİŞKEN_ADI} referansı, seçilen hedef değişkenin adına göre yeniden yazılır. Hedefte aynı isimde bir değişken yoksa pakette gelen tanımdan Global veya Ortam-özel bir değişken oluşturulabilir; ortam-özel oluşturmada kaynak ortam adları hedef ortamlarla eşleştirilir. Değişken değerleri pakete dahil edilmez, hedefte ayrıca girilmesi gerekir.
• Kimlik Bilgisi (Credential) bağımlılıkları kullanıcı adına göre eşleştirilir; parola/anahtar gibi secret bilgiler düz metin olarak taşınmaz — ya mevcut bir kimlik bilgisiyle eşlenir ya da hedefte yeniden girilir. Bir kimlik bilgisinin taşıdığı sertifika, key store veya trust store referansı hedefte çözülemezse bu referans artık sessizce bozuk bırakılmaz: referans temizlenir ve içe aktarma raporunda görünür bir uyarı üretilir — hedefte doğru sertifikayı yeniden seçmeniz gerekir.
• Sertifika / Key Store / Crypto Key / JWK bağımlılıkları eşlendiğinde, onu referans veren tüm dosyalardaki ilgili alanlar (bir kimlik bilgisinin özel anahtarı, bir JOSE politikasının kullandığı JWK, bir proxy'nin güvenli bağlantı sertifikaları vb.) hedefin kimliğine yeniden yazılır.
• Bir paketteki ortam kimliği kaynak kuruluma aittir; bu nedenle hedefte karşılığı bulunmayan bir sertifika ailesi kaydının ortam referansı içe aktarımda saklanmaz, düşürülür. Böyle bir referans yine de bir nesnenin üzerinde kaldığında, Sertifika, Key Store, Crypto Key ve JWK ekranları bunu ham bir kimlik yazmak yerine Bilinmeyen ortam uyarısıyla işaretler — bozuk atama görünür kalır ve aynı satırdan düzeltilebilir. Tek istisna API Manager'ın kendi apimanager ortamıdır: Ortamlar altında hiçbir zaman bir kayıt olarak bulunmayan bu sözde (pseudo) ortam her zaman geçerli sayılır ve kendi adıyla gösterilir.
• Veritabanı bağlantısı bağımlılıkları eşlendiğinde, API Creator'ın gömülü bağlantı referansı hedef bağlantıya yeniden yönlendirilir; bağlantı parolaları pakete dahil edilmez ve eşleştirme adayı olarak yalnızca aynı veritabanı tipindeki bağlantılar sunulur (örn. bir Oracle bağlantısı yalnızca başka bir Oracle bağlantısıyla eşleşebilir).

Dışlanan (Exclude Edilen) Bağımlılık Davranışı

• Birden fazla nesne içeren bir pakette (örn. birden fazla API Proxy ya da bir Proxy Group'un üye proxy'leri), istenmeyen bir nesne içe aktarımdan çıkarılabilir; yalnızca o nesneye özel bağımlılıklar da düşer — başka kalan bir nesne tarafından da kullanılan paylaşılan bağımlılıklar pakette kalmaya devam eder.
• Dışa aktarımda bir bağımlılığın işareti kaldırılırsa o bağımlılık pakete hiç dahil edilmez; bağımlılığı kullanan nesne hedefte söz konusu bağımlılık mevcut değilse kaynaktaki referansı olduğu gibi taşır ve bu referansın hedefte elle tamamlanması gerekir.
• Dışa aktarım öncesinde otomatik bir uyarı taraması yapılır: yakında süresi dolacak sertifikalar, gizli ortam değişkenleri, sertifika/bağlantı/kimlik bilgisi hatırlatmaları ve (içe aktarım tarafında) hedef projede eksik olan ortam değişkenleri bu taramada raporlanır.
• Bu taramadaki hatırlatmalar, parola verilmeden üretilen düz paketler içindir: pakete giren sertifika özel anahtarı gibi değerler düz pakette dosyayı eline geçiren herkes tarafından okunabilir. Pakete bir parola verirseniz bu değerler de paketle birlikte şifrelenir — ayrıntı için Paket Şifreleme bölümüne bakın.

Proje İçe Aktarımında Relative Path Kuralları

• Dışa aktarımda, kaynak projenin relative path öneki API Proxy/Proxy Group'un Client Route bilgisinden çıkarılır; pakette yalnızca proxy'ye özgü yol kısmı kalır — böylece paket kaynak projeye bağımlı olmaz.
• İçe aktarımda, hedef projenin kendi relative path öneki (etkinse) otomatik olarak öne eklenir; Client Route düzenleyicisinde bu önek sabit (değiştirilemez) şekilde gösterilir, yalnızca proxy'ye özgü kısım düzenlenebilir — böylece proxy yeni projede doğru yol altında, önek tekrarlanmadan devreye alınır.

AI Nesnesi Bağımlılığı Tespiti ve Eşleme

• Bir LLM Provider'ın bağımlılık adımı, bağlı olduğu sağlayıcı tanımını (Provider Definition) ve sağlayıcının kullandığı model katalogu kayıtlarını da yüzeye çıkarır — ama yalnızca bunlar projenizin oluşturduğu özel (custom) kayıtlarsa. Özel model katalogu kayıtları pakete dahil edilir ve içe aktarımda hedefte otomatik olarak oluşturulur. Apinizer'ın platformla birlikte gelen hazır (built-in) sağlayıcı tanımları ve hazır katalog modelleri hiçbir zaman pakete dahil edilmez — içe aktarımda sağlayıcının/modelin kendi tanımlayıcı koduna göre otomatik olarak çözülür, dolayısıyla bunlar için eşleştirme yapmanıza gerek kalmaz. LLM Provider'ın kendisi her zaman kendi secret'ını (API anahtarı/sırrı) taşır, bu yüzden her zaman secret bir bağımlılık olarak pakete girer.
• Bir Knowledge Base, üzerine kurulduğu Vector DB bağlantısını ve embedding için kullandığı LLM Provider'ı bağımlılık olarak yüzeye çıkarır. Pakete yalnızca knowledge base'in tanımı girer — içine önceden indekslenmiş dokümanlar pakete dahil edilmez, hedefte yeniden (indeksleyerek) eklenmesi gerekir.
• MCP/A2A Gateway'leri API Proxy (type=MCP / type=A2A) olarak export edilir ve çözülecek ayrı bir bağlantı bağımlılığı taşımaz: bir Passthrough proxy'nin arka uç sunucu(ları) ile bir Araç/Ajan Çağrısı politikasının gömülü sunucusu, proxy'nin kendisinin bir parçası olarak satır içi paketlenir.
• PII Preset ve Prompt Guard Preset başka hiçbir dışa aktarılabilir nesneye referans taşımaz — her ikisi de kendi içinde tamamlanmış bir örüntü (pattern) tanımıdır, bu yüzden ayrı bir bağımlılık adımı olmadan doğrudan dışa aktarılır. Model Definition ve Vector DB ise bağımlılık adımından geçer: özel bir model tanımı kullandığı özel bir sağlayıcı tanımına (Provider Definition) referans verebilir, bir Vector DB bağlantısının ayarları ortam değişkeni referansları içerebilir. Böyle bir referans yoksa adım "bağımlılık bulunamadı" boş-durum mesajını gösterip nesneyi doğrudan dışa aktarır.
• PII Preset ve Prompt Guard Preset — projenize özel olanlar dahil — yalnızca sistem yöneticisi tarafından oluşturulabilir veya düzenlenebilir. Sıradan bir projeden bakıldığında sihirbazın nesne listesinde yalnızca projenize daha önce tanımlanmış preset'ler görünür; platformun hazır (built-in) preset kataloğu burada listelenmez.

Kullanım Senaryoları

Ortamlar Arası Transfer

Erişim kısıtlamasından dolayı fiziksel olarak, production ve test adlı iki farklı ortamda kurulu iki tane Apinizer uygulaması olduğunu varsayalım. Production ortamı istemcilere, test ortamı ise yazılım geliştiricilere hizmet etmektedir. Test ortamındaki API Proxy ve uygulanan politikalar ve konfigürasyonlar, production ortamına da uygulanması istenmektedir. Bu durumda test ortamındaki API Proxy, bağımlılıklarıyla birlikte dışa aktarılır. Sonrasında oluşturulan paket, sihirbaz ile production ortamına içe aktarılır ve bağımlılıklar hedefteki karşılıklarıyla eşleştirilir.

Konfigürasyon İzleme

Konfigürasyon değişiklikleri izlenebilir. Kurum, güvenlik kuralları nedeniyle politika ayarlarındaki farklılıkları izlemek isteyebilir. Bunun için CI sürecine, dışa aktarılan politika, API Proxy ya da projeye ait konfigürasyon dosyası eklenmelidir.

İlgili Sayfalar

• Ortamlar arası otomatik değişken eşleştirme ve onay mekanizmalarıyla API taşıma ihtiyacınız varsa API Promotion sayfasına göz atın — bağımlılık tespiti mantığı burada anlatılan sihirbazla örtüşür, ancak API Promotion aynı kurulum içindeki ortamlar arasında onay akışlı bir taşıma sunar.
• Ortam Değişkenleri
• Proxy Group
• LLM Sağlayıcıları ve Bağlantılar
• Model Kataloğu ve Fiyatlandırma
• Bilgi Tabanları
• Vektör Veritabanı
• MCP Gateway
• A2A Gateway

İlgili İşlemler

• API Proxy Dışa Aktar
• API Proxy İçe Aktar
• Anahtar Dışa Aktar
• Key Store Dışa Aktar
• Global Politikalar