Kuruluşları anlama

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

Kuruluş, Apigee Edge'in üst düzey kapsayıcısı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ı bilgilere değinilse de şu pratik noktaları göz önünde bulundurun:

  • Varsayılan olarak kuruluş adınız, Sanal ana makineler hakkında bölümünde açıklandığı gibi, API proxy'lerinizi çağırmak için kullanılan URL'de yer alır. Ö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, docs kuruluşu için API proxy'lerini gösterir:

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

  • Yalnızca bir kuruluş oluşturmuş olsanız da belirli izinlere sahip bir kullanıcı veya 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.

  • Yönetim API'si ile Kuruluş Yöneticisi rolünde bir kullanıcı olarak ç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 için kısa bir video izleyin.

Kuruluş bileşenleri

Bir 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; API'leriniz, API ürünleriniz, uygulamalarınızın ve uygulama geliştiricilerinizin Edge'de nasıl bir ilişki içinde olduğunu tanımlar.

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

Bu model Apigee Edge'in tüm özelliklerini göstermez. Para kazanma özelliğini kullanıyorsanız modelde ek bileşenler olacaktır. Daha fazla bilgi için Para kazanmaya genel bakış sayfasını inceleyin. Para kazanma amacıyla şirketleri ve geliştiricileri yönetme hakkında bilgi için Şirket ve geliştiricileri yönetme bölümüne bakın.

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ı olan kuruluş

Kuruluş oluşturulduktan sonra yeniden adlandırılamaz.

Kuruluş adı, Edge Management API'ye istekte bulunduğunuzda API proxy'lerinize ait URL'nin bir parçası ve 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, test veya üretim olan API proxy'sinin dağıtım ortamıdır.

Ö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

Kuruluş

Her Apigee hesabı, Apigee Edge'deki bir veya daha fazla kuruluşla eşlenir. Kuruluş; API proxy'leri, API ürünleri, API paketleri, uygulamalar ve geliştiriciler dahil 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şlara üye 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ü geliştiricileri, analizleri ve diğer istatistikleri izleyen kullanıcılar vb. 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şu ve bileşenlerini değiştirme ayrıcalıklarına sahip Kuruluş Yöneticileri ve Operasyon 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 diğer kullanıcıları tanımlayın.

Kullanıcılar birden çok 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 aynı kişiler oluşturur ve dolayısıyla tüm kuruluşlarınızın üyesi olurlar.

Kullanıcı olmak için Apigee hesabı oluşturmanız, 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 buradan 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 (OAuth gibi) sağlayacak, mesaj dönüştürme (XML'den JSON'a gibi) gerçekleştirecek, arka uç hizmetlerine giden trafiği sınırlayacak ve istek, yanıt ve hizmet çağrılarıyla diğer değerli işlemleri gerçekleştirecek şekilde yapılandırılabilir.

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

API ürünü

Kuruluştaki kullanıcılar bir veya daha fazla API ürünü oluşturur. Burada bir API ürünü, bir hizmet planıyla birlikte kullanılan bir API proxy'si paketidir. Söz konusu hizmet planı; API proxy'leri üzerinde erişim sınırları belirleyebilir, güvenlik sağlayabilir, izleme ve analize imkan tanıyabilir ve ek özellikler sunabilir.

Edge, API ürünleriyle ilgili analiz için veri toplar.

Geliştirici

Bir kuruluş, kuruluşunuz tarafından tanımlanan API'leri (API ürünleri olarak 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 şirketiniz içinde yer alabilir, iş ortağı veya API'lerinize erişim için ödeme yapan harici geliştiriciler olabilir.

Geliştiricilerin bir uygulamayı kaydedebilmesi ve API'lerinize erişmek amacıyla bir API anahtarı alabilmeleri için öncelikle kuruluşunuzda kayıtlı olmaları gerekir. API sağlayıcısı olarak kuruluşunuzdaki geliştiricileri nasıl ekleyeceğinizi, güncelleyeceğinizi veya kaldıracağınızı belirlemek size bağlıdır. Bunları Edge yönetim kullanıcı arayüzü üzerinden manuel olarak ekleyebilir, web sitesi üzerinden 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 hesabı olması zorunlu değildir ve çoğu geliştiricinin Edge hakkında bir şey bilmesi gerekmez. Geliştiricinin Edge'de hesabı varsa bu hesap genellikle farklı bir kuruluştaki bir kullanıcı olarak veya Edge API Hizmetleri'ni kullanmaktır.

Uygulama

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

Geliştiricilerin uygulamalarını kuruluşunuza kaydettirmesi gerekir. Edge'de Uygulama, geliştiriciye API'lerinize yapılan her istekte iletebileceği bir API anahtarı sağlayan, geliştiricinin gerçek uygulamasını temsil eder.

Tüm uygulamalar kuruluşunuza kayıtlı olduğundan, Edge'i kullanarak uygulamayla ve API'lerinizin kullanımıyla ilgili analiz bilgilerini izleyip toplayabilirsiniz.

API anahtarı/OAuth jetonu

Uygulama, API'leriniz için tanımladığınız yetkilendirme mekanizmasına bağlı olarak, API'lerinize yapılan 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 vb. farklı kimlik doğrulama türlerini destekler.

API sağlayıcısı olarak, geliştiricilerin uygulamalarını kaydetmek için bir yöntem tanımlamanız gerekir. Bu şekilde API'lerinize erişmek için gereken anahtarı geliştiriciye 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ı, uygulama ile ilişkili tüm API ürünlerine erişmek için aynı anahtarı kullanır (geliştiricinin uygulamasının Edge'deki kayıtlı temsili).

Geliştirici uygulamasının API'lerinize artık erişememesi için istediğiniz zaman anahtarı iptal edebilirsiniz (geliştiricinin uygulamasının kayıtlı temsili kuruluşunuzda hâlâ mevcut olsa bile). Alternatif olarak, geliştiricinin anahtarı belirli bir süre sonra yenilemesi için anahtarda süre 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şilmeden önce API proxy'si 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 özelliklerinin kapsamı sunar. Örneğin, anahtar/değer eşlemesi (KVM) verileri kuruluş düzeyinde kullanılabilir. Diğer bir deyişle, herhangi bir ortama dağıtılan API Proxy'leri KVM'den aynı verileri alır. Önbelleğe alma gibi bazı özellikler, kuruluş veya kuruluş içindeki belirli bir ortama ayarlanabilir. Apigee analiz verileri, kuruluş ve ortam kombinasyonuna göre bölümlere ayrılır.

Aşağıda, bir kuruluş içinde yönettiğiniz ana varlıklar gösterilmektedir. Kuruluş içinde dünya genelinde tanımlanmış olanlar ve özel olarak bir ortam için tanımlanmış olanlar: