Kuruluşları anlama

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

Kuruluş, Apigee Edge'deki ü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 verilecek olsa da aşağıda pratik bilgilere yer verilmiştir:

  • Kuruluş adınız, varsayılan olarak Sanal ana makineler hakkında bölümünde açıklandığı gibi API proxy'lerinizi çağırmak için kullanılan URL'de bulunur. Örneğin: 
    http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
  • Kuruluşunuzun adı, Edge yönetim kullanıcı arayüzünün URL'sinde yer alır. Örneğin, aşağıdaki URL'de docs kuruluşunun API proxy'leri gösterilmektedir:

    Apigee.com/organizations/docs/proxies URL'sinde /docs/ daire içine alınmıştır.

  • Yalnızca bir kuruluş oluşturmuş olabilirsiniz, ancak belirli izinlere sahip kullanıcı ya da yönetici olarak diğer kuruluşlara ait olabilirsiniz. Edge yönetim kullanıcı arayüzünde birden fazla kuruluşa aitseniz 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 Management API ile çağrı yaptığınızda kuruluş, çoğu çağrıda yolun zorunlu bir parçasıdır. Örneğin, aşağıdaki Management API 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ı bir mimariyi nasıl desteklediğini öğrenmek üzere kısa bir video izleyin.

Kuruluş bileşenleri

Edge hesabı oluşturduğunuzda Edge otomatik olarak sizin için bir kuruluş oluşturur. Kuruluş 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, API'lerinizin, API ürünlerinizin, uygulamalarınızın ve uygulama geliştiricilerinizin Edge'de nasıl ilişkili olduğunu tanımlar.

Akış grafiği; ortamın, kullanıcının, API ürününün ve geliştiricinin uygulama, API anahtarı/OAuth jetonu ve API proxy'si ile ilişkisini gösterir.

Bu model, Apigee Edge'in tüm özelliklerini göstermez. Para kazanma özelliğini kullanıyorsanız modelin ek bileşenleri olur. Daha fazla bilgi için Para kazanmaya genel bakış başlıklı makaleyi inceleyin. Para kazanma özelliğini kullanan ş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 temel hazırlık sırasında kullanıcı tanımlıdır

Oluşturulan kuruluşları yeniden adlandıramazsınız.

Kuruluş adı, API proxy'lerinizin URL'sinin ve Edge yönetim API'sine istek gönderirken 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 test veya üretim olan dağıtım ortamıdır.

Örneğin:

http://myorg-test.apigee.net/v1/weather/forecastrss

Kuruluş bileşenleri

Aşağıdaki tabloda kurumsal modelin bileşenleri daha ayrıntılı olarak açıklanmıştır:

Bileşen Açıklama

Kuruluş

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 gibi kişiler bulunabilir.

Farklı kullanıcıların farklı rolleri ve erişim ayrıcalıkları olabilir. Örneğin, bazı kullanıcıları kuruluşu ve bileşenlerini değiştirme ayrıcalıklarına sahip Kuruluş Yöneticileri ve İşlem Yöneticileri olarak tanımlayın. API proxy'leri ve API ürünleri oluşturma iznine sahip ancak diğer kullanıcıları değiştirme ayrıcalığına sahip olmayan diğer 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 şirket içinde tüm API proxy'lerini ve API ürünlerini oluşturan kişiler aynıdır ve bu nedenle 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 şuradan 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, herkese açık bir HTTP uç noktasının arka uç hizmetiyle eşlemesini tanımlar. API proxy'leri, güvenlik (OAuth gibi) içerecek, mesaj dönüşümü (XML'den JSON'a gibi) gerçekleştirecek, arka uç hizmetlerine giden trafiği sınırlayacak ve istek, yanıt ve hizmet açıklamalarıyla diğer değerli işlemleri gerçekleştirecek şekilde de yapılandırılabilir.

Edge, API proxy'leri üzerinde analiz yapmak için veri toplar.

API ürünü

Bir kuruluştaki kullanıcılar bir veya daha fazla API ürünü oluşturur. Burada API ürünü, bir hizmet planıyla birlikte API proxy'lerinden oluşan bir pakettir. Bu hizmet planı, API proxy'lerinde erişim sınırlarını belirleyebilir, güvenlik sağlayabilir, izleme ve analizlere izin verebilir ve ek özellikler sunabilir.

Edge, API ürünlerindeki analizler için veri toplar.

Geliştirici

Bir kuruluşta, kuruluşunuz tarafından tanımlanan API'leri (API ürünlerine yerleştirilmiş) kullanan uygulamalar geliştiren bir veya daha fazla geliştirici bulunur. Geliştiriciler API'leri kullanır ancak API oluşturamaz veya kuruluşta başka işlem yapamaz.

Geliştiriciler şirket içinden olabilir, iş ortağı olabilir veya API'lerinize erişim için ödeme yapan harici geliştiriciler olabilir.

Geliştiricilerin bir uygulamayı kaydedip API'lerinize erişmek üzere API anahtarı alabilmesi için önce kuruluşunuza kayıtlı olmaları gerekir. API sağlayıcı olarak, kuruluşunuza nasıl geliştirici ekleneceğini, güncelleneceğini veya kaldırılacağını belirleme kararı size aittir. Edge Management kullanıcı arayüzü üzerinden manuel olarak ekleyebilir, bir web sitesi üzerinden kaydetmek için geliştirici portalı oluşturabilir veya Edge Management API'yi kullanarak kendi kayıt mekanizmanızı tanımlayabilirsiniz.

Geliştiricinin Edge'de hesabı olması gerekmez ve çoğu geliştiricinin Edge hakkında bilgi sahibi olması gerekmez. Geliştiricinin Edge'de hesabı varsa bu genellikle farklı bir kuruluştaki bir kullanıcı olarak veya Edge API Hizmetleri'ni kullanır.

Uygulama

Geliştiriciler, API'lerinizi kullanan bir veya daha fazla istemci uygulaması oluşturur.

Geliştiricilerin uygulamalarını kuruluşunuza kaydettirmesi gerekir. Edge'deki uygulama, geliştiricinin gerçek uygulamasının bir temsilidir ve geliştiricinin API'lerinize her istekle birlikte ileteceği bir API anahtarı sağlar.

Tüm uygulamalar kuruluşunuza kayıtlı olduğundan, uygulama ve API'lerinizin kullanımıyla ilgili analitik bilgileri izlemek ve toplamak için Edge'i kullanabilirsiniz.

API anahtarı/OAuth jetonu

Uygulama, API'leriniz için tanımladığınız yetkilendirme mekanizmasına bağlı olarak API'lerinize gönderilen her istekle birlikte bir API anahtarı iletir. Bu anahtar geçerliyse isteğe izin verilir. Edge, basit API anahtarı, iki aşamalı OAuth, üç aşamalı OAuth gibi farklı kimlik doğrulama türlerini destekler.

API sağlayıcısı olarak, geliştiricilerin uygulamalarını kaydettirebileceği bir yöntem tanımlamanız gerekir. Uygulamalarını kaydettiğinizde, API'lerinize erişmek için gereken anahtarı geliştiriciye döndürmüş olursunuz.

Geliştirici, uygulama kaydı sırasında tek bir API ürününe veya birden fazla API ürününe erişmeyi seçebilir. Geliştiricinin asıl 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ının API'lerinize erişimi olmaması için anahtarı dilediğiniz zaman iptal edebilirsiniz (geliştiricinin uygulamasının kayıtlı temsili kuruluşunuzda hâlâ mevcut olsa bile). Alternatif olarak, geliştiricinin belirli bir süre sonra anahtarı yenilemesi için anahtar üzerinde zaman sınırı tanımlayabilirsiniz.

Ortamlar hakkında

Ortam, bir kuruluştaki API proxy'leri için çalışma zamanı yürütme bağlamıdır. Bir ortama erişilebilmesi için önce API proxy'sini dağıtmanız 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 ortamı tanımlayabilirsiniz.

Kuruluş, bazı Apigee özellikleri için kapsam sağlıyor. Örneğin, anahtar/değer eşlemesi (KVM) verileri kuruluş düzeyinde kullanılabilir hale getirilebilir. Bu sayede, herhangi bir ortama dağıtılan API Proxy'leri aynı verileri KVM'den alır. Önbelleğe alma gibi bazı özellikler, kuruluşa veya kuruluş içindeki belirli bir ortama göre kapsamlandırılabilir. Apigee analiz verileri, kuruluş ve ortamın kombinasyonuna göre bölümlendirilir.

Aşağıda, kuruluşta genel olarak tanımlanmış olanlar ve bir ortama özel olarak tanımlananlar dahil olmak üzere bir kuruluş içinde yönettiğiniz başlıca varlıklar gösterilmiştir: