Para Kazanma Hizmetlerini Yükleme

Edge for Private Cloud 4.19.01 sürümü

Para Kazanma Hizmetleri, Apigee Edge'in bir uzantısı olduğundan bağımsız olarak çalışmaz bahsedeceğim. Hepsi Bir Arada (AIO) hariç mevcut tüm Apigee Edge kurulumlarında çalışır yapılandırma. AIO yapılandırmasına Para Kazanma Hizmetleri yükleyemezsiniz.

Para kazanma koşulları

  • Para Kazanma'yı çoklu Yönetim Sunucusu kullanan bir Uç topolojisine yüklüyorsanız Düğümleri (ör. 13 düğümlü kurulum) yüklemeniz durumunda yapmanız gerekir.
  • Edge yüklemesinin birden fazla Postgres düğümüne sahip olduğu Edge'de Monetization'ı yüklemek için Postgres düğümleri Ana/Bekleme modunda yapılandırılmalıdır. Para kazanma özelliğini yükleyemezsiniz birden fazla Postgres ana düğümünüz varsa Edge'i kullanabilirsiniz. Daha fazla bilgi için bkz. Şunun için Master-Standby Replication'ı ayarlayın: Postgre'ler.
  • Hepsi Bir Arada (AIO) yapılandırmasıyla para kazanma özelliği kullanılamaz.

Yüklemeye genel bakış

Aşağıdaki adımlar, mevcut bir Apigee Edge'e Para Kazanma Hizmetleri'nin nasıl ekleneceğini göstermektedir kurulum:

  • Apigee Yönetim Sunucusu düğümünü aşağıdaki şekilde güncellemek için apigee-setup yardımcı programını kullanın: Para Kazanma Hizmetleri'ni (ör. katalog yönetimi, sınırlar ve bildirimler) etkinleştirme yapılandırma, faturalandırma ve raporlama.

    13 düğümlü kurulum gibi birden fazla Yönetim Sunucusu düğümünüz varsa Para Kazanma'yı yüklemeden önce her iki Uç Yönetim Sunucusu düğümünü de yükleyin.

  • apigee-setup kullanın yardımcı programını kullanarak Apigee Mesaj İşlemcisini güncellemek için Para Kazanma Hizmetleri (ör. işlem kaydetme politikası ve sınır yaptırımı). Şu durumda: Birden fazla Mesaj İşleyiciniz varsa hepsine Para Kazanma uygulamasını yükleyin.
  • Edge kuruluşlarınız için Para Kazanma'ya ilk katılım sürecini gerçekleştirin.
  • Apigee Developer Services portalını (veya kısaca portalı) para kazanma özelliğini destekleyecek şekilde yapılandırın. Daha fazla bilgi için bkz. Para Kazanma'yı Geliştirici Portalı'nda yapılandırın.

Para kazanma için sessiz yapılandırma dosyası oluşturma

Aşağıda, para kazanma kurulumu için örnek bir sessiz yapılandırma dosyası gösterilmektedir. Bunu düzenle dosyanızı yapılandırmanız için gereken şekilde ayarlayın. Bu dosyayı eklemek için setup.sh dosyasını eklemek üzere -f seçeneğini kullanın.

# Edge configuration properties
# Specify IP address or DNS name of node.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Edge sys admin credentials
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Specify the Management Server port.
APIGEE_PORT_HTTP_MS=8080

#
# Monetization configuration properties.
#
# Postgres credentials from Edge installation.
PG_USER=apigee    # Default from Edge installation
PG_PWD=postgres    # Default from Edge installation

# Specify Postgres server.
MO_PG_HOST="$IP8"    # Only specify one Postgres node.

# Create a Postgres user for Monetization.
# Default username is "postgre".
# If you specify a different user, that user must already exist.
MO_PG_USER=postgre
MO_PG_PASSWD=moUserPWord

# Specify one ZooKeeper host.
# Ensure this is a ZooKeeper leader node in a multi-datacenter environment.
ZK_HOSTS="$IP2"

# Specify Cassandra information.
# Ensure CASS_HOSTS is set to the same value as when you installed Edge.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Default is "Apigee", unless it was changed during Edge install.
CASS_CLUSTERNAME=Apigee

# Cassandra uname/pword required only if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Specify the region.
# Default is dc-1 unless you are in a multi-datacenter environment.
REGION=dc-1

# If your Edge config file did not specify SMTP information, add it.
# Monetization requires an SMTP server.
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPMAILFROM="My Company <myco@company.com>"

Notlar:

  • Edge yapılandırma dosyanızda SMTP bilgileri belirtilmemişse bu bilgileri ekleyin. Para kazanmak için gerekenler: SMTP sunucusu.
  • Tek bir veri merkezi yüklemesinde, tüm ZooKeeper düğümleri varsayılan olarak liderler. Edge'i birden fazla veri merkezine yüklerken bazı ZooKeeper düğümleri yapılandırılmalıdır. Yukarıdaki ZK_HOSTS özelliğinin birden çok veri merkezi kurulumuna değinmelisiniz.
  • Cassandra kimlik doğrulamasını etkinleştirirseniz Cassandra kullanıcı adı ve şifresini iletebilirsiniz. kullanarak aşağıdaki özellikleri kullanabilirsiniz: 
    CASS_USERNAME
CASS_PASSWORD
    .

Para kazanma hizmetlerini tüm yönetim sunucularıyla entegre edin

Yönetim Sunucusu düğümlerine para kazanmayı entegre etmek için aşağıdaki prosedürü kullanın.

  1. Para Kazanma'yı çoklu Yönetim Sunucusu kullanan bir Uç topolojisine yüklüyorsanız düğümlerini kurmalısınız, ardından her iki Yönetim Sunucusu'nu da yüklediğinizden emin olun. düğümleri kontrol edin.
  2. Yönetim Sunucusu düğümünde kurulum komut dosyasını çalıştırın:
    /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

    -p mo seçeneği, para kazanma özelliğinin entegre edileceğini belirtir.

    Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.

  3. Para Kazanma özelliğini birden fazla Yönetim Sunucusu düğümüne yüklüyorsanız şurada 2. adımı tekrarlayın: ikinci Yönetim Sunucusu düğümünü kullandı.

Başarılı yapılandırmanın ardından, PostgreSQL veritabanı. Böylece, Para Kazanma Hizmetleri ve ilişkili raporlamasına da olanak tanır.

Para Kazanma Hizmetleri'ni tüm Mesaj İşleyicilere entegre etme

Para kazanma özelliğini tüm İleti İşleyenlere entegre etmek için aşağıdaki prosedürü kullanın düğüm.

  1. İlk İleti İşleyici düğümünde, komut isteminde kurulum komut dosyasını çalıştırın: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile
    .

    -p mo seçeneği, para kazanma özelliğinin entegre edileceğini belirtir.

    Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.

  2. Bu prosedürü tüm İleti İşleyici düğümlerinde tekrarlayın.

Yapılandırma başarılı olduğunda Mesaj İşleyici, Para Kazanma Hizmetleri ile güncellenir. Bu Para Kazanma Hizmetleri'nin ve ilişkili bileşenlerinin Mesaj ile entegrasyonunu tamamlar İşlemciler.

Para kazanmaya başlama

Yeni bir kuruluş oluşturmak ve para kazanmayı etkinleştirmek için:

  1. Kuruluşu yeni bir kuruluş gibi oluşturun. Daha fazla bilgi için bkz. Bir kuruluşun katılımını gerçekleştirme.
  2. Para kazanma temel hazırlık API'sini şu sayfada açıklandığı şekilde kullanın: Etkinleştir hakkında bilgi edindiniz. Bunu yapabilmek için sistem yöneticiniz olması gerekir ayrıcalıkları.

Edge kullanıcı arayüzünde bir sonraki oturum açışınızda fayda sağlar:

Portalı para kazanmayı destekleyecek şekilde yapılandırmak için Şurada Para Kazanma Özelliğini Yapılandırma: hakkında daha fazla bilgi edinin.

Para kazanma kurulumuna Yönetim Sunucusu düğümü ekleme

Mevcut bir Edge kurulumuna Yönetim Sunucusu eklerseniz yeni Yönetim Sunucusu'na para kazanma hizmetlerini aktarabilir ve tüm Yönetim Sunucularını yapılandırarak iletişim kurabiliyoruz.

Yönetim Sunucusu eklemek için:

  1. Yeni Yönetim Sunucusu'nu yükleyin.
  2. Para Kazanma'yı yeni Yönetim Sunucusu'na yükleyin.
  3. Orijinal Yönetim Sunucusu'nda aşağıdaki komutu çalıştırın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
  4. Orijinal Yönetim Sunucusu'nu yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  5. Yeni Yönetim Sunucusu'nda aşağıdaki komutu çalıştırın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
  6. Yeni Yönetim Sunucusu'nu yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Ek yapılandırma

Faturalandırma dokümanlarını PDF dosyaları olarak gönderin

Para kazanma özelliği, fatura belgelerini son kullanıcılara HTML biçiminde gösterir. Faturalandırma hizmeti sunmak için PDF dosyası olarak PDF haline getirerek, Monetization'ı PDF dosyası sunan bir faturalandırma sistemine entegre edebilirsiniz. desteklenen bir üçüncü taraf PDF kitaplığı oluşturma veya lisanslama.

Kuruluş ayarlarını yapılandırın

Kuruluş özellikleri eklemek/güncellemek için aşağıdaki gibi bir PUT isteği kullanabilirsiniz. örnek gösterilmektedir:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  -v http://ms_IP:8080/v1/organizations/orgId -d 'org object with attributes' -X PUT

Para kazanma özelliği, kuruluş ayarlarıyla yanıt verir. Örneğin:

{
  ...
  "displayName": "Orgnization name",
  "name": "org4",
  "properties": {
    "property": [
      ...
      {
        "name": "MINT_CURRENCY",
        "value": "USD"
      },
      {
        "name": "MINT_COUNTRY",
        "value": "US"
      },
      {
        "name": "MINT_TIMEZONE",
        "value": "GMT"
      }
    ]
  }
}

Aşağıdaki tabloda, bir alan adını yapılandırmak için kullanabileceğiniz kuruluş düzeyindeki özellikler mintör organizasyonu.

Özellikler Açıklama
MINT_TAX_MODEL

Kabul edilen değerler: "DISCLOSED", "UNDISCLOSED", "HYBRID" (varsayılan değer null'dur)
MINT_CURRENCY

ISO para birimi kodu (varsayılan değer boştur)
MINT_TAX_NEXUS

Vergi bağlantı noktası (varsayılan değer boştur)
MINT_DEFAULT_PROD_TAX_CATEGORY

Varsayılan ürün vergi kategorisi (varsayılan ürün, boştur)
MINT_IS_GROUP_ORG

GP grup kuruluşu (varsayılan değer "false"tur)
MINT_HAS_BROKER

Bozuk (varsayılan değer: false)
MINT_TIMEZONE

Saat dilimi (varsayılan değer null'dur)
MINT_TAX_ENGINE_EXTERNAL_ID

Vergi motoru kimliği (varsayılan değer boştur)
MINT_COUNTRY

Kuruluşun ülkesi (varsayılan değer null'dur)
MINT_REG_NO

Kuruluşun tescil numarası (Birleşik Krallık) vergi numarasından farklı bir numara verir (varsayılan değer null'dur)
MINT_BILLING_CYCLE_TYPE

"PRORATED", "CALENDAR_MONTH" (varsayılan değer "CALENDAR_MONTH")
MINT_SUPPORTED_BILLING_TYPE

&quot;PREPAID&quot;/&quot;POSTPAID&quot;/&quot;BOTH&quot; (varsayılan değer "PREPAID"tir)
MINT_IS_SEPARATE_INV_FOR_FEES

Ayrı bir ücret faturası oluşturulup oluşturulmayacağını belirtir (varsayılan değer "false"tur)
MINT_ISSUE_NETTING_STMT

Netting deyiminin yayınlanıp yayınlanmayacağını belirtir (varsayılan değer "false"tur)
MINT_NETTING_STMT_PER_CURRENCY

Netting deyiminin para birimine göre oluşturulup oluşturulmayacağını belirtir (varsayılan değer: "false")
MINT_HAS_SELF_BILLING

Kuruluşun kendi kendine faturalandırma özelliği olup olmadığını belirtir (varsayılan değer "false"tur)
MINT_SELF_BILLING_FOR_ALL_DEV

Kuruluşun tüm geliştiriciler için faturalandırma yapıp yapmadığını belirtir (varsayılan değer: "false")
MINT_HAS_SEPARATE_INV_FOR_PROD

Kuruluşun ürün başına ayrı faturası olup olmadığını belirtir (varsayılan "false")
MINT_HAS_BILLING_ADJUSTMENT

Kuruluşun fatura ayarlamalarını destekleyip desteklemediğini belirtir (varsayılan değer: "false")
features.isMonetizationEnabled

Yönetim kullanıcı arayüzü tarafından para kazanmaya özel menüyü görüntülemek için kullanılır (varsayılan değer: "false")
ui.config.isOperator

Yönetim kullanıcı arayüzü tarafından sağlayıcıyı Kuruluşun tersine Kuruluş olarak görüntülemek için kullanılır (varsayılan değer: "true")

Yönetim kullanıcı arayüzünü kullanarak işletme kuruluş ayarlarını yapılandırmak için bkz. Para kazanma özelliğini kullanmaya başlayın.

Para kazanmayla ilgili sınırlar

Para kazanma sınırları uygulamak için API proxy'lerine Para Kazanma Sınırları Kontrolü politikasını ekleyin. Özellikle, politika aşağıdaki koşullarda tetiklenir:

  • Para kazanılan API'ye erişen geliştirici kayıtlı değil veya ilgili ücrete abone değil daha fazla bilgi edineceksiniz.
  • Geliştirici, abone olunan ücret planı için işlem hacmini aştı.
  • Geliştiricinin ön ödemeli hesap bakiyesi veya sonradan ödemeli kredi sınırına ulaşıldı.

Para Kazanma Sınırlarını Kontrol Etme politikası, hataları ortaya çıkarır ve aşağıdaki gibi durumlarda API çağrılarını engeller: izin verilenler listesine eklenir. Bu politika, Hata Yükseltme politikasının kapsamını genişletir ve siz de mesajı özelleştirebilirsiniz. geri döndü. Geçerli koşullar iş değişkenlerinden türetilir.

Daha fazla bilgi için Uygulama API proxy'lerinde para kazanma sınırları