Kuruluşları anlama

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Kuruluş, Apigee Edge'deki üst düzey kapsayıcıdır. Tüm API proxy'lerinizi içerir ve ilgili kaynaklar. Bu konunun geri kalanında kuruluşlar hakkında daha çok ayrıntıya girsek de şu noktaları inceleyebilirsiniz:

  • Varsayılan olarak kuruluşunuzun adı, API proxy'lerinizi çağırmak için kullanılan URL'de bulunur. Sanal ana makineler hakkında başlıklı makaleyi inceleyin. Ö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 bulunur. Örneğin, aşağıdaki URL'de docs kuruluşunun API proxy'leri görüntülenmektedir:

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

  • Yalnızca bir kuruluş oluşturmuş olabilirsiniz, ancak kullanıcı olarak diğer kuruluşlara ait olabilirsiniz bir kullanıcı veya yönetici olabilir. Edge yönetim arayüzünde birden fazla kuruluş kullanıyorsanız Kuruluşlarınız arasında geçiş yapma başlıklı makalede açıklandığı şekilde farklı bir kuruluşa geçiş yapabilirsiniz.

  • Kuruluş Yöneticisi'nde bir kullanıcı olarak Management API ile çağrı yaptığınızda rolünün kullanıldığı durumlarda, kuruluş çoğu çağrıda yolun gerekli bir parçasıdır. Örneğin, 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 bir projeyi nasıl desteklediğini öğrenmek için kısa bir video API yönetimi için çok kiracılı mimari.

Kuruluş bileşenleri

Bir Edge hesabı oluşturduğunuzda Edge sizin için otomatik olarak bir kuruluş oluşturur. Bir kez kuruluşunuza kullanıcı ekleyebilir, API proxy'leri ve API ürünleri oluşturabilir ve 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 Kenar.

Akış grafiği ortamın, kullanıcının, API ürünü ve geliştiricinin nasıl ilişkili olduğunu gösterir. API anahtarı/OAuth jetonu ve API proxy'si yer alır.

Bu model, Apigee Edge'in tüm özelliklerini göstermez. Para kazanma özelliğini kullanıyorsanız modelin ek bileşenleri olacaktır. Daha fazla bilgi için bkz. Para kazanmaya genel bakış Görüntüleyin Şirketleri ve geliştiricileri yönetme inceleyebilirsiniz.

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

Kuruluşu oluşturduktan sonra yeniden adlandıramazsınız.

Kuruluş adı, aşağıdaki durumlarda API proxy'lerinizin URL'sinin ve Edge Management API'ye istek gönderme. Örneğin, bir API'ye erişmek için kullanılan tipik bir URL proxy aşağıdaki 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 dağıtım ortamıdır. üretim

Ö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. İlgili içeriği oluşturmak için kullanılan organizasyon; API proxy'leri, API dahil olmak üzere tüm bileşenlerin bir temsilini uygulamaları ve geliştiricileri içerir.

Hesap sahipleri tek bir kuruluşla sınırlı değildir. Bazı hesap sahipleri Farklı uygulama geliştiricilerini destekleyen birden fazla kuruluşu tanımlamak veya bunların üyesi olmak toplulukları.
Ortam Bir kuruluştaki API proxy'leri için çalışma zamanı yürütme bağlamı. İlgili bölümü inceleyin aşağıdaki bölümde bulabilirsiniz.

Kullanıcı

Bir kuruluşta, hesabı oluşturan kişinin otomatik olarak daha fazla kullanıcı oluşturabilirsiniz. Kullanıcılar kuruluşun API ekibini oluşturur. Bunlar arasında yöneticiler, API proxy'si ve API ürünü oluşturucuları, Analytics'i, diğer istatistikleri ve diğer istatistikleri izleyen kullanıcılar.

Farklı kullanıcılar, farklı rollere ve erişim ayrıcalıklarına sahip olabilir. Örneğin, Ayrıcalıklı Kuruluş Yöneticisi ve İşlem Yöneticisi olarak bazı kullanıcılar kurumun ve bileşenlerinin değiştirilmesine neden olur. Şu izinlere sahip diğer kullanıcıları tanımlayın: API proxy'leri ve API ürünleri oluşturmanıza, ancak diğerlerini yardımcı olur.

Kullanıcılar, birden fazla kuruluşun üyesi olabilir. Örneğin şirketiniz, birden fazla kuruluşla ortak çalışma yürütüyoruz. Dahili olarak, tüm API proxy'lerini ve API ürünlerini aynı kişiler derler ve üyesi olmanız gerekir.

Bir Apigee hesabı, yani bir Apigee hesabı oluşturmanız gerekmez bir kurumdaki bir kullanıcı olmaktır. Bir yönetici sizi mevcut bir kurum içinde tutmaktır.

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şleştirilmesi. API proxy'leri ayrıca içerecek şekilde yapılandırılmalıdır (ör. OAuth), ileti dönüştürme (ör. XML'den JSON'ye gibi), trafiği arka uç hizmetleriyle sınırlandırın ve diğer değerli işlemleri gerçekleştirin istek, yanıt ve hizmet açıklama metinleriyle birlikte görünür.

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 bir API ürünü API proxy'leri paketi, hizmet planıyla birleştirilir. Bu hizmet planı erişimi ayarlayabilir API proxy'lerinde sınırlar, güvenlik sağlama, izleme ve analize izin verme ve sunuyor.

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

Geliştirici

Bir kuruluşta, Kuruluşunuz tarafından tanımlanan API'ler (API ürünlerinde bir araya getirilmiş). Geliştiriciler API'leri kullanır. ancak API oluşturamaz veya kuruluşta başka bir işlem gerçekleştiremez.

Geliştiriciler şirketinizin içinde olabilir, iş ortağı olabilirler veya ödeme yapan harici geliştiriciler olabilir.

Geliştiricilerin bir uygulamayı kaydedebilmeleri ve API'lerinize erişmek için bir API anahtarı alması gerekir. Bir API sağlayıcı olarak, Google Ads'in Geliştiricileri ekleme, güncelleme veya kaldırma. Bunları manuel olarak ekleyebilirsiniz Edge yönetim kullanıcı arayüzünü kullanarak onları bir veya Edge yönetimini kullanarak kendi kayıt mekanizmanızı tanımlayın API'ye gidin.

Geliştiricinin Edge'de hesabı olması gerekmez ve çoğu geliştirici herhangi bir şey öğrenmeniz gerekmiyor. Geliştiricinin Edge'de hesabı varsa veya Edge API Hizmetleri'ni kullanmak isteyebilir.

Uygulama

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

Geliştiricilerin, uygulamalarını kuruluşunuza kaydettirmesi gerekir. Edge'deki bir uygulama, geliştiriciye kendisi için bir API anahtarı sağlayan gerçek uygulamasının bir temsili iletmenize yardımcı olur.

Tüm uygulamalar kuruluşunuzda kayıtlı olduğundan, uygulamaları izlemek ve uygulama ve API'lerinizi kullanımıyla ilgili analiz bilgileri toplamak.

API anahtarı/OAuth jetonu

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

API sağlayıcı olarak, geliştiricilerin uygulamalarını kaydetmeleri için bir yöntem tanımlamanız gerekir. Evet erişmek için gereken anahtarı, geliştiriciye iade etmeniz gerekir. API'ler.

Uygulama kaydı sırasında geliştirici tek bir API'ye erişmeyi seçebilir ürün veya birden çok API ürünü için geçerlidir. Geliştiricinin gerçek uygulaması, uygulamayla ilişkili tüm API ürünleri ( geliştiricisine ait uygulama için geçerlidir).

Geliştiricinin uygulamasının artık erişememesi için anahtarı istediğiniz zaman iptal edebilirsiniz API'lerinize ekleme (geliştiricinin uygulamasının kayıtlı temsili olsa da) kuruluşunuzda olması gerekir). Ya da bir anahtarda süre sınırı belirleyebilir, böylece 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. Bir ortama erişilebilmesi için önce API proxy'sini dağıtmanız gerekir. API dağıtabilirsiniz tek bir ortama veya birden çok ortama proxy uygulayabilirsiniz.

Bir kuruluşta birden fazla ortam olabilir. Örneğin, bir dev, Bir kuruluşta test ve prod ortamı.

Kuruluş, bazı Apigee özellikleri için kapsam sağlıyor. Örneğin, anahtar/değer eşlemesi (KVM) veriler kuruluş düzeyinde kullanılabilir hale getirilebilir, yani tüm aynı verileri KVM'den alır. Önbelleğe alma gibi bazı özelliklerin kapsamı belirlenebilir ya da kurumun içindeki belirli bir ortama bağlı olarak paylaşabilirsiniz. Apigee analiz verileri, kuruluş ve ortamın kombinasyonuna göre bölümlendirilir.

Aşağıda, bir kuruluşta tanımlanmış olanlar dahil olmak üzere yönettiğiniz başlıca tüzel kişiler gösterilmiştir genel olarak, bir ortama özel olarak tanımlananlar ise: