安装创收服务

适用于私有云的 Edge v. 4.17.05

Monetization Services 是对 Apigee Edge 的扩展,因此它并非独立运行 过程。它在任何现有的 Apigee Edge 设置中运行。

创收要求

  • 如果您要在使用多个管理服务器的边缘拓扑上安装创收功能,请执行以下操作: 节点(例如 13 节点安装),则必须同时安装两个边缘管理服务器节点 然后再安装创收功能
  • 如需在 Edge 安装有多个 Postgres 节点的 Edge 上安装创收功能,请执行以下操作: Postgres 节点必须在主/待机模式下配置。你无法安装创收功能 如果您有多个 Postgres 主节点,则使用 Edge。有关详情,请参阅为 Postgres

安装概览

以下步骤说明了如何在现有 Apigee Edge 上添加创收服务 安装:

  • 使用 apigee-setup 用于更新 Apigee 管理服务器节点以启用变现服务,从而 例如目录管理、限制和通知配置、结算和 报告。

    如果您有多个 Management Server 节点(例如 13 个节点的安装),则必须 请先安装两个边缘管理服务器节点,然后再安装 Monetization 功能。
  • 使用 apigee-setup 实用程序更新 Apigee 消息处理器,以启用 变现服务,例如交易记录政策和限制违规处置。如果您 如果有多个消息处理器,请为它们都安装创收功能。
  • 为 Edge 组织执行创收新手入门流程。
  • 配置开发者服务门户以支持创收。如需了解详情,请参阅 http://apigee.com/docs/monetization/content/configure-monetization-developer-portal.

创建一个静默配置文件 变现

下面显示了一个变现安装的静默配置文件示例。修改此内容 文件。使用 -f 选项来设置 setup.sh 文件以包含此文件。

注意:通常,您可以将这些属性添加到 如安装 Edge 节点上的各个组件

# 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>"
注意
  • 如果您的 Edge 配置文件未指定 SMTP 信息,请添加此信息。创收要求 SMTP 服务器。
  • 在单个数据中心安装中,所有 ZooKeeper 节点默认配置为 领导人。在多个数据中心安装 Edge 时,一些 ZooKeeper 节点 配置为观察者。确保上面的 ZK_HOSTS 属性在 多数据中心安装
  • 如果您启用了 Cassandra 身份验证,则可将 Cassandra 用户名和密码 使用以下属性:
    CASS_USERNAME
    CASS_PASSWORD

集成变现服务 所有管理服务器

请按照以下过程在管理服务器节点上集成创收功能。

  1. 如果您要在使用多个管理服务器的边缘拓扑上安装创收功能 节点(例如 13 节点安装),则请确保同时安装了管理服务器和 然后才能安装创收功能
  2. 在管理服务器节点上,运行设置脚本:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

    “-p mo”选项指定集成创收功能。

    配置文件必须可供“apigee”访问或读取用户。
  3. 如果您要在多个管理服务器节点上安装创收功能,请在以下位置重复第 2 步: 第二个管理服务器节点。

配置成功后,系统会在 PostgreSQL 数据库。至此,变现服务及其相关联的 组件与 Postgres Server 结合使用。

集成变现服务 所有消息处理器

按照以下步骤将创收功能集成到所有消息处理器中 节点。

  1. 在第一个消息处理器节点上,在命令提示符下运行设置脚本:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

    “-p mo”选项指定集成创收功能。

    配置文件必须可供“apigee”访问或读取用户。
  2. 在所有消息处理器节点上重复此过程。

配置成功后,消息处理器会更新为使用变现服务。这个 完成变现服务及其相关组件与消息的集成 处理器。

创收新手入门

如需创建已启用创收功能的新组织,请先创建以下组织: 和任何新组织做的一样如需了解详情,请参阅对组织进行初始配置

用于为组织启用创收功能的额外新手入门

要完成组织的创收新手入门流程,您必须:

  1. 创建获利组:mxgroup
  2. 将 Qpid 添加到该群组。
  3. 为组织启用创收功能。
  4. 为组织启用通知设置。
  5. 为您要为其启用创收功能的所有组织重复此流程。

使用 enable-monetization 命令来执行所有这些任务。此脚本采用包含 以下属性:

MSIP=IPorDNSofManagementServer
APIGEE_PORT_HTTP_MS=8080    # Default is 8080.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"
# Space-separated list IP/DNS names of all Qpid nodes in the data center being configured.
QPID_HOST="$IP6 $IP7"    
QPID_PORT=8083     # Default is 8083.
REGION=dc-1
ORG_NAME=myorg    # The Edge org where you want to enable monetization. 
MX_GROUP=mxgroup    # Default Monetization group.

注意:

  • 设置 CASS_HOSTSREGION 设置为 安装创收功能时使用的设备
  • 如果您要在多个数据中心配置中启用创收功能,请执行以下操作: <ph type="x-smartling-placeholder">
      </ph>
    • 您必须在管理服务器上对每项数据重复执行初始配置过程。 。
    • 配置文件应仅列出 配置。

如需运行该脚本,请执行以下操作:

  1. 调用脚本:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-provision enable-monetization -f configFile

    配置文件必须可供“apigee”访问或读取用户。

    如果您有多个管理服务器,则只需在其中之一上运行此脚本。

    此脚本从 Cassandra 复制组织、产品、开发者和应用 数据库到获利 PostgreSQL 数据库。成功添加创收功能账号后 数据会自动同步的服务。
  2. 为您要启用创收功能的每个组织重复此流程。
  3. 如果您处于多个数据中心环境,请在管理中心重复此过程。 服务器位于另一个数据中心。确保配置文件仅列出 正在配置一个数据中心。

下次登录 Edge 界面时,您会在以下平台的顶级菜单中看到“创收”条目: 组织:

配置开发者 服务门户

如需配置开发者服务门户以支持创收功能,请参阅 http://apigee.com/docs/monetization/content/configure-monetization-developer-portal

添加管理服务器节点 到安装创收功能

如果您在现有 Edge 安装中添加管理服务器,则必须确保将管理服务器添加到 创收服务到新的管理服务器,并配置所有管理服务器, 进行通信

要添加管理服务器,请执行以下操作:

  1. 安装新的管理服务器。
  2. 管理服务器上安装 Monetization。
  3. 原始管理服务器上,调用以下内容:
    &gt; /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
  4. 重启原始管理服务器:
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-management-server restart
  5. 管理服务器上,调用以下内容:
    &gt; /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
  6. 重启管理服务器:
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-management-server restart

其他配置

以以下身份提供结算凭证: PDF 文件

创收服务以 HTML 格式向最终用户显示结算文档。为了提供结算服务 文档,您可以将创收功能与提供 PDF 文件的结算系统集成 生成或获得许可的第三方 PDF 库。

配置组织 设置

后端设置:下表列出了组织级属性 可用于配置 Mint 组织的资源。您可以使用 PUT 调用来添加/更新这些 属性,如下所示:

> curl -u ${ADMIN_EMAIL}:${ADMINPW} -v http://<management-ip>:8080/v1/organizations/{orgId} -d '{org object with attributes}' -X PUT

例如,上述 C网址 命令的输出将如下所示:

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

属性

说明

MINT_TAX_MODEL

接受的值为 DISCLOSED,

UNDISCLOSED,HYBRID(默认值为 null)

MINT_CURRENCY

ISO 货币代码(默认为 null)

MINT_TAX_NEXUS

税收直接关系(默认为 null)

MINT_DEFAULT_PROD_TAX_CATEGORY

默认商品税种(默认为 null)

MINT_IS_GROUP_ORG

IS 组的组织方式(默认值为 false)

MINT_HAS_BROKER

已损坏(默认值为 false)

MINT_TIMEZONE

时区(默认为 null)

MINT_TAX_ENGINE_EXTERNAL_ID

税费引擎 ID(默认为 null)

MINT_COUNTRY

组织所在的国家/地区(默认值为 null)

MINT_REG_NO

组织的注册号(英国提供的税号与税号不同) (默认值为 null)

MINT_BILLING_CYCLE_TYPE

PRORATED,CALENDAR_MONTH(默认为 CALENDAR_MONTH)

MINT_SUPPORTED_BILLING_TYPE

PREPAID/POSTPAID/BOTH(默认为 PREPAID)

MINT_IS_SEPARATE_INV_FOR_FEES

指明是否应生成单独的费用账单(默认值为 false)

MINT_ISSUE_NETTING_STMT

指示是否应该发出净月结对账单(默认值为 false)

MINT_NETTING_STMT_PER_CURRENCY

指明是否按币种生成净收入对账单(默认值为 false)

MINT_HAS_SELF_BILLING

指明组织是否采用自行结算(默认值为 false)

MINT_SELF_BILLING_FOR_ALL_DEV

指明组织是否对所有开发者都自行结算(默认值为 false)

MINT_HAS_SEPARATE_INV_FOR_PROD

指明组织是否为每个产品设置了单独的账单(默认值为 false)

MINT_HAS_BILLING_ADJUSTMENT

指明组织是否支持结算调整项(默认值为 false)

features.isMonetizationEnabled

供管理界面用来显示创收专用菜单(默认值为 false)

ui.config.isOperator

供管理界面用来将提供商显示为运营商而不是组织

(默认值为 true)

如需了解如何使用管理界面配置企业组织设置,请参阅 http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services

注意:如果您正在使用创收服务限制和通知 请告知您的开发者在提交完上述请求后,在代理流程中附加 访问令牌验证政策。

限制政策是一项明确的政策,用于在已实现特定限制的情况下阻止 API 调用 。此政策会检查业务限制,并在有任何超出限制时引发错误 配置的值。这是引发故障政策的扩展,但条件由 与业务变量相关联。

代理开发者的管理界面中提供了一个界面模板。代理开发者应 在消息流中附加 Mint 政策。执行此政策后,错误将引发 并将根据策略返回故障响应如果 ContinueOnError 设置为 true,则故障 将不会引发,且流变量“mint.limitsViolated”、“mint.isDeveloperSuspend”和“mint.limitsPolicyError”设置变量 可在必要时进一步处理异常。