Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Kuruluş, Apigee Edge'deki en üst düzey kapsayıcıdır. Tüm API proxy'lerinizi ve ilgili kaynaklarınızı içerir. Bu konunun geri kalanında kuruluşlar hakkında daha ayrıntılı bilgi verilse de işe yarayacak birkaç noktayı aşağıda bulabilirsiniz:
- Varsayılan olarak, API proxy'lerinizi çağırmak için kullanılan URL'de kuruluşunuzun adı bulunur. Bu durum, Sanal ana makineler hakkında bölümünde açıklanmıştır.
Örneğin:
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- Kuruluşunuzun adı, Edge yönetim arayüzünün URL'sinde yer alır. Örneğin, aşağıdaki URL,
docskuruluşu için API proxy'lerini gösterir:
- Yalnızca bir kuruluş oluşturmuş olsanız da belirli izinlere sahip bir kullanıcı veya yönetici olarak başka kuruluşlara ait olabilirsiniz. Edge yönetim kullanıcı arayüzünde birden fazla kuruluşa bağlıysanız Kuruluşlarınız arasında geçiş yapma bölümünde açıklandığı gibi farklı bir kuruluşa geçebilirsiniz.
- Kuruluş yöneticisi rolündeki bir kullanıcı olarak yönetim API'si ile arama yaptığınızda, çoğu aramada kuruluş, yoldaki zorunlu bir bölüm olur. Örneğin, aşağıdaki yönetim API'si cURL isteği, bir kuruluştaki tüm API proxy'lerinin listesini döndürür:
curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address
Video: Kuruluşların API yönetimi için çok kiracılı mimariyi nasıl desteklediğini öğrenmek üzere kısa bir video izleyin.
Kuruluş bileşenleri
Edge hesabı oluşturduğunuzda Edge sizin için otomatik olarak bir kuruluş oluşturur. Oluşturulduktan sonra kuruluşunuza kullanıcı ekleyebilir, API proxy'leri ve API ürünleri oluşturabilir, geliştiricileri ve uygulamaları kaydedebilirsiniz.
Aşağıdaki resimde, Edge kuruluş modelinin ana bileşenleri gösterilmektedir. Bu model, Edge'de API'lerinizin, API ürünlerinizin, uygulamalarınızın ve uygulama geliştiricilerinizin birbiriyle nasıl ilişkili olduğunu tanımlar.
Bu model, Apigee Edge'in tüm özelliklerini göstermez. Para kazanma özelliğini kullanıyorsanız modelde ek bileşenler bulunur. Daha fazla bilgi için Para kazanmaya genel bakış başlıklı makaleyi inceleyin. Para kazanma ile şirketleri ve geliştiricileri yönetme hakkında bilgi edinmek için Şirketleri ve geliştiricileri yönetme başlıklı makaleyi inceleyin.
Kuruluş adları
Kuruluşun adı:
- Değerlendirme kuruluşu:
username-eval - Ücretli kuruluş: İlk sağlama sırasında kullanıcı tarafından tanımlanır.
Oluşturulan kuruluşlar yeniden adlandırılamaz.
Kuruluş adı, API proxy'lerinizin URL'sinin ve Edge yönetim API'sine istekte bulunurken kullanılan URL'nin bir parçası olur. Örneğin, bir API proxy'sine erişmek için kullanılan tipik bir URL şu biçimdedir:
http://org-name-env.apigee.net/v1/weather/forecastrss
Bu örnekte:
- org-name, kuruluşunuzun adıdır.
- env, API proxy'sinin dağıtım ortamıdır (test veya prod).
Örneğin:
http://myorg-test.apigee.net/v1/weather/forecastrss
Kuruluş bileşenleri
Aşağıdaki tabloda, kuruluş modelinin bileşenleri daha ayrıntılı olarak açıklanmaktadır:
| Bileşen | Açıklama |
|---|---|
|
Kurumsal |
Her Apigee hesabı, Apigee Edge'de bir veya daha fazla kuruluşla eşlenir. Kuruluş, API proxy'leri, API ürünleri, API paketleri, uygulamalar ve geliştiriciler dahil olmak üzere tüm bileşenlerin bir temsilini içerir. Hesap sahipleri tek bir kuruluşla sınırlı değildir. Bazı hesap sahipleri, farklı uygulama geliştirici topluluklarını destekleyen birden fazla kuruluş tanımlayabilir veya bu kuruluşların üyesi olabilir. |
| Ortam | Bir kuruluştaki API proxy'leri için çalışma zamanı yürütme bağlamı. Ortamlar hakkında daha fazla bilgi için aşağıdaki bölüme bakın. |
|
Kullanıcı |
Hesabı oluşturan kişinin otomatik olarak yönetici olduğu bir kuruluşta daha fazla kullanıcı oluşturabilirsiniz. Kullanıcılar, kuruluşun API ekibini oluşturur. Bu ekipte yöneticiler, API proxy'si ve API ürünü oluşturucular, analizleri ve diğer istatistikleri izleyen kullanıcılar ve diğer kişiler yer alabilir. Farklı kullanıcılar farklı rollere ve erişim ayrıcalıklarına sahip olabilir. Örneğin, bazı kullanıcıları kuruluş ve bileşenlerini değiştirme ayrıcalıklarına sahip Kuruluş Yöneticileri ve İşlemler Yöneticileri olarak tanımlayın. API proxy'leri ve API ürünleri oluşturma izni olan ancak diğer kullanıcıları değiştirme ayrıcalığı olmayan başka kullanıcılar tanımlayın. Kullanıcılar birden fazla kuruluşun üyesi olabilir. Örneğin, şirketiniz farklı geliştirici topluluklarını desteklemek için Apigee Edge'de birden fazla kuruluş tanımlayabilir. Ancak dahili olarak, tüm API proxy'lerini ve API ürünlerini aynı kişiler oluşturur. Bu nedenle, bu kişiler tüm kuruluşlarınızın üyesidir. Kullanıcı olmak için Apigee hesabı (yani Apigee kuruluşu) oluşturmanız gerekmez. Bir yönetici sizi mevcut bir kuruluşa ekleyebilir. Tüm kullanıcılar Apigee Edge'e şu adresten giriş yapar: https://enterprise.apigee.com. |
|
API proxy'si |
Bir kuruluştaki kullanıcılar bir veya daha fazla API proxy'si oluşturur. API proxy'si, herkese açık bir HTTP uç noktasının arka uç hizmetiyle eşlemesini tanımlar. API proxy'leri, güvenlik (ör. OAuth) içerecek, mesaj dönüşümü (ör. XML'den JSON'a) gerçekleştirecek, arka uç hizmetlerine giden trafiği sınırlayacak ve istek, yanıt ve hizmet çağrılarıyla ilgili diğer değerli işlemleri yapacak şekilde de yapılandırılabilir. Edge, API proxy'leriyle ilgili analizler için veri toplar. |
|
API ürünü |
Bir kuruluştaki kullanıcılar, bir veya daha fazla API ürünü oluşturur. API ürünü, hizmet planıyla birlikte API proxy'lerinin bir paketidir. Bu hizmet planı, API proxy'lerinde erişim sınırları belirleyebilir, güvenlik sağlayabilir, izleme ve analizlere izin verebilir ve ek özellikler sunabilir. Edge, API ürünleriyle ilgili analizler için veri toplar. |
|
Geliştirici |
Bir kuruluş, kuruluşunuz tarafından tanımlanan API'leri (API ürünleri halinde birleştirilmiş) kullanan uygulamaları oluşturan bir veya daha fazla geliştirici içerir. Geliştiriciler API'leri kullanır ancak API oluşturamaz veya kuruluşta başka bir işlem gerçekleştiremez. Geliştiriciler şirketinizde çalışanlar, iş ortaklarınız veya API'lerinize erişim için ödeme yapan harici geliştiriciler olabilir. Geliştiriciler, bir uygulamayı kaydedip API'lerinize erişmek için API anahtarı almadan önce kuruluşunuza kaydedilmelidir. API sağlayıcı olarak, kuruluşunuzdaki geliştiricileri nasıl ekleyeceğinizi, güncelleyeceğinizi veya kaldıracağınızı belirlemek sizin sorumluluğunuzdadır. Bunları Edge yönetim kullanıcı arayüzü üzerinden manuel olarak ekleyebilir, web sitesi aracılığıyla kaydetmek için bir geliştirici portalı oluşturabilir veya Edge Management API'yi kullanarak kendi kayıt mekanizmanızı tanımlayabilirsiniz. Geliştiricilerin Edge'de hesap sahibi olması gerekmez ve çoğu geliştiricinin Edge hakkında bilgi sahibi olması gerekmez. Geliştiricinin Edge'de hesabı varsa bu hesap genellikle farklı bir kuruluştaki kullanıcı olarak veya Edge API Hizmetleri'ni kullanmak için oluşturulmuştur. |
|
Uygulama |
Geliştiriciler, API'lerinizi kullanan bir veya daha fazla istemci uygulaması oluşturur. Geliştiriciler, uygulamalarını kuruluşunuza kaydetmelidir. Edge'deki bir uygulama, geliştiricinin gerçek uygulamasının bir gösterimidir. Geliştiriciye, API'lerinize yapılan her istekle birlikte iletilecek bir API anahtarı sağlar. Tüm uygulamalar kuruluşunuza kaydedildiğinden, Edge'i kullanarak uygulama ve API'lerinizin kullanımıyla ilgili analiz bilgilerini izleyip toplayabilirsiniz. |
|
API anahtarı/OAuth jetonu |
API'leriniz için tanımladığınız yetkilendirme mekanizmasına bağlı olarak uygulama, API'lerinize yapılan her istekle birlikte bir API anahtarı iletir. Bu anahtar geçerliyse istek izin verilir. Edge, basit API anahtarı, iki aşamalı OAuth ve üç aşamalı OAuth gibi farklı kimlik doğrulama türlerini destekler. API sağlayıcı olarak, geliştiricilerin uygulamalarını kaydetmelerine olanak tanıyan bir yöntem tanımlamanız gerekir. Geliştiriciye, API'lerinize erişmek için gereken anahtarı, uygulamasını kaydettirerek geri verirsiniz. Uygulama kaydı sırasında geliştirici, tek bir API ürününe veya birden fazla API ürününe erişmeyi seçebilir. Geliştiricinin gerçek uygulaması, uygulamayla ilişkili tüm API ürünlerine (geliştiricinin Edge'deki uygulamasının kayıtlı temsili) erişmek için aynı anahtarı kullanır. Geliştiricinin uygulaması artık API'lerinize erişemeyecek şekilde anahtarı istediğiniz zaman iptal edebilirsiniz (geliştiricinin uygulamasının kayıtlı temsili kuruluşunuzda bulunmaya devam etse bile). Alternatif olarak, anahtarda bir zaman sınırı tanımlayabilirsiniz. Bu durumda, geliştiricinin belirli bir süre sonra anahtarı yenilemesi gerekir. |
Ortamlar hakkında
Ortam, bir kuruluştaki API proxy'leri için çalışma zamanı yürütme bağlamıdır. API proxy'sine erişilebilmesi için önce bir ortama dağıtılması gerekir. API proxy'sini tek bir ortama veya birden fazla ortama dağıtabilirsiniz.
Bir kuruluş birden fazla ortam içerebilir. Örneğin, bir kuruluşta dev, test ve prod ortamları tanımlayabilirsiniz.
Kuruluş, bazı Apigee özellikleri için kapsam sağlar. Örneğin, anahtar-değer eşlemesi (KVM) verileri kuruluş düzeyinde kullanılabilir. Bu, herhangi bir ortama dağıtılan API proxy'lerinin KVM'den aynı verileri alacağı anlamına gelir. Önbelleğe alma gibi bazı özellikler kuruluş veya kuruluş içindeki belirli bir ortamla sınırlandırılabilir. Apigee analiz verileri, kuruluş ve ortam kombinasyonuyla bölümlere ayrılır.
Aşağıda, kuruluş içinde yönettiğiniz başlıca öğeler gösterilmektedir. Bunlar arasında kuruluşta genel olarak tanımlananlar ve belirli bir ortam için tanımlananlar yer alır:
