이 페이지는 Cloud Translation API를 통해 번역되었습니다.

수익 창출 서비스 설치

Private Cloud용 Edge v. 4.16.05

수익 창출 서비스는 Apigee Edge의 확장 프로그램이므로 독립형으로 실행되지 않습니다. 프로세스입니다 모든 기존 Apigee Edge 설정 내에서 실행됩니다.

수익 창출 요구사항

여러 관리 서버를 사용하는 에지 토폴로지에 수익 창출을 설치하는 경우 노드(예: 13노드 설치)를 사용하려면 에지 관리 서버 노드를 둘 다 설치해야 합니다. 수익 창출 설치에 대해 자세히 알아보세요.
Edge 설치에 Postgres 노드가 여러 개인 Edge에 수익 창출을 설치하려면 Postgres 노드를 마스터/대기 모드로 구성해야 합니다. Postgres 마스터 노드가 여러 개인 경우 Edge에 수익 창출을 설치할 수 없습니다. 자세한 내용은 Postgres의 마스터-스탠바이 복제 설정을 참고하세요.

설치 개요

다음 단계에서는 기존 Apigee Edge에 수익 창출 서비스를 추가하는 방법을 보여줍니다. 설치:

apigee-setup을 사용합니다. 수익 창출 서비스를 사용 설정하도록 Apigee 관리 서버 노드를 업데이트하는 유틸리티이며 예를 들면 카탈로그 관리, 한도 및 알림 구성, 청구 및 있습니다.

13노드 설치와 같이 관리 서버 노드가 여러 개인 경우 수익 창출을 설치하기 전에 두 개의 Edge 관리 서버 노드를 모두 설치해야 합니다.
apigee-setup을 사용합니다. 이 유틸리티는 이 API의 런타임 구성요소를 사용 설정하도록 Apigee 메시지 프로세서를 수익 창출 서비스(예: 거래 기록 정책 및 한도 시행) 메시지 프로세서가 여러 개인 경우 모두에 수익 창출을 설치합니다.
Edge 조직의 수익 창출 온보딩 프로세스를 실행합니다.
수익 창출을 지원하도록 개발자 서비스 포털 구성 자세한 내용은 http://apigee.com/docs/monetization/content/configure-monetization-developer-portal.

수익 창출을 위한 무음 구성 파일 만들기

다음은 수익 창출 설치의 무음 구성 파일 예시입니다. 수정 변경할 수 있습니다. 이 파일을 포함하려면 setup.sh에 -f 옵션을 사용합니다.

참고: 일반적으로 이러한 속성은 노드에 Edge 구성요소 설치에 표시된 대로 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

참고:

Edge 구성 파일에 SMTP 정보를 지정하지 않은 경우 추가합니다. 수익 창출을 위해서는 SMTP 서버가 필요합니다.
단일 데이터 센터 설치에서 모든 ZooKeeper 노드는 기본적으로 리더로 구성됩니다. 여러 데이터 센터에 Edge를 설치할 때 일부 주키퍼 노드는 다음과 같습니다. 관찰자로 구성되어야 합니다 위의 ZK_HOSTS 속성이 여러 데이터 센터 설치의 리더 노드를 지정하는지 확인합니다.
Cassandra 인증을 사용 설정하면 다음 속성을 사용하여 Cassandra 사용자 이름과 비밀번호를 전달할 수 있습니다.
CASS_USERNAME
CASS_PASSWORD

수익 창출 서비스 통합 모든 관리 서버 포함

관리 서버 노드에 수익 창출을 통합하려면 다음 절차를 따르세요.

여러 관리 서버를 사용하는 에지 토폴로지에 수익 창출을 설치하는 경우 노드(예: 13노드 설치)를 사용하려면 관리 서버를 수익 창출 설치 전에 노드를 검토합니다.
관리 서버 노드에서 설정 스크립트를 실행합니다.
> /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

'-p mo' 옵션은 수익 창출을 통합하도록 지정합니다.

구성 파일은 'Apigee'에서 액세스하거나 읽을 수 있어야 합니다. 있습니다. 예를 들어, /tmp 디렉터리에 있는 파일 kube-APIserver입니다
여러 관리 서버 노드에 수익 창출을 설치하는 경우 두 번째 관리 서버 노드에서 2단계를 반복합니다.

구성이 완료되면 수익 창출 서비스를 위한 RDBMS 스키마가 사용할 수 있습니다 수익 창출 서비스 및 관련 통합이 완료되었습니다. 구성요소를 살펴보겠습니다

수익 창출 서비스 통합 모든 메시지 프로세서 포함

다음 절차에 따라 모든 메시지 프로세서 노드에서 수익 창출을 통합합니다.

첫 번째 메시지 프로세서 노드의 명령 프롬프트에서 설정 스크립트를 실행합니다.
> /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

'-p mo' 옵션은 수익 창출을 통합하도록 지정합니다.

구성 파일은 'Apigee'에서 액세스하거나 읽을 수 있어야 합니다. 있습니다. 예를 들어, /tmp 디렉터리에 있는 파일 kube-APIserver입니다
모든 메시지 프로세서 노드에서 이 절차를 반복합니다.

구성이 완료되면 Message Processor가 수익 창출 서비스로 업데이트됩니다. 이 수익 창출 서비스 및 관련 구성요소의 통합을 메시지에 프로세서.

수익 창출 온보딩

수익 창출이 사용 설정된 새 조직을 만들려면 먼저 조직을 가장 큰 차이점이 있습니다 자세한 내용은 조직 온보딩을 참고하세요.

조직의 수익 창출을 위한 추가 온보딩

조직의 수익 창출 온보딩을 완료하려면 다음을 실행해야 합니다.

수익 창출 그룹 mxgroup을 만듭니다.
그룹에 Qpid를 추가합니다.
조직에 수익 창출을 사용 설정합니다.
조직의 알림 설정을 사용 설정합니다.
수익 창출을 사용 설정하려는 모든 조직에 이 절차를 반복합니다.

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_HOSTS 및 REGION을 확인하시기 바랍니다.
여러 데이터 센터 구성에서 수익 창출을 사용 설정하는 경우 다음 단계를 따르세요.
- 관리 서버에서 각 데이터에 온보딩 프로세스를 반복해야 합니다. 센터를 방문하세요.
- 구성 파일에는 생성 중인 데이터 센터의 Qpid 노드만 나열되어야 합니다. 구성할 수 있습니다

스크립트를 실행하려면 다음 안내를 따르세요.

스크립트를 호출합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision enable-monetization -f configFile

구성 파일은 'Apigee'에서 액세스하거나 읽을 수 있어야 합니다. 있습니다. 예를 들어, /tmp 디렉터리에 있는 파일 kube-APIserver입니다

관리 서버가 여러 개 있는 경우 그 중 하나에서만 이 스크립트를 실행하면 됩니다.

이 스크립트는 Cassandra 데이터베이스에서 수익 창출 PostgreSQL 데이터베이스로 조직, 제품, 개발자, 애플리케이션을 복제합니다. 수익 창출 설치 완료 후 데이터가 자동으로 동기화되는 서비스입니다.
수익 창출을 사용 설정하려는 모든 조직에 대해 이 절차를 반복합니다.
여러 데이터 센터 환경에 있는 경우 다른 데이터 센터의 관리 서버에서 이 프로세스를 반복합니다. 구성 파일에 데이터 센터를 구성할 수 있습니다

다음에 Edge UI에 로그인하면 조직의 최상위 메뉴에 수익 창출 항목이 표시됩니다.

개발자 서비스 포털 구성

수익 창출을 지원하도록 개발자 서비스 포털을 구성하려면 http://apigee.com/docs/monetization/content/configure-monetization-developer-portal을 참고하세요.

관리 서버 노드 추가 수익을 창출하려면

기존 Edge 설치에 관리 서버를 추가하는 경우 새 관리 서버에 수익 창출 서비스를 추가하고 모든 관리 서버가 통신할 수 있도록 구성해야 합니다.

관리 서버를 추가하려면 다음 단계를 따르세요.

새 관리 서버를 설치합니다.
새로운 관리 서버에 수익 창출을 설치합니다.
원본 관리 서버에서 다음을 호출합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
원본 관리 서버를 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
새 관리 서버에서 다음을 호출합니다.
> /opt/apigee/apigee-service/bin/apigee-service Edge-mint-management-server mint-configure-mgmt-cluster
새 관리 서버를 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service Edge-management-server 다시 시작

추가 구성

결제 문서를 다음 형식으로 제공 PDF 파일

수익 창출에서는 최종 사용자에게 청구서를 HTML 형식으로 표시합니다. 결제 정보 제공 문서를 PDF 파일로 제공하면 수익 창출을 PDF를 제공하는 결제 시스템과 통합할 수 있습니다. 또는 라이선스를 부여하는 데 사용될 수 있습니다.

조직 구성 설정

백엔드 설정: 다음 표에는 조직 수준의 속성이 나와 있습니다. 민트 조직을 구성하는 데 사용할 수 있는 다음과 같이 PUT 호출을 사용하여 이러한 속성을 추가/업데이트할 수 있습니다.

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

예를 들어 위의 CURL 명령어의 출력은 다음과 같습니다.

{
...
    "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	영국에서 조직의 등록 번호가 세금 ID와 다른 번호를 제공합니다(기본값은 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	관리 UI에서 수익 창출 관련 메뉴를 표시하는 데 사용됩니다 (기본값은 false임).
ui.config.isOperator	관리 UI에서 제공업체를 조직이 아닌 운영자로 표시하는 데 사용됩니다. (기본값은 true입니다.)

관리 UI를 사용하여 비즈니스 조직 설정을 구성하는 방법은 http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services를 참조하세요.

참고: 수익 창출 서비스 한도 및 알림 기능을 사용하는 경우 개발자에게 액세스 토큰 유효성 검사 정책 뒤의 프록시 흐름에 한도 정책을 연결하도록 안내하세요.

한도 정책은 특정 한도에 도달하면 API 호출을 차단하도록 설계된 명시적 정책입니다. 정책에서 비즈니스 한도를 확인하고 한도를 초과하는 경우 오류가 발생합니다. 설정된 값입니다. 이는 오류 발생 정책의 확장이지만 조건이 파생됩니다. 비즈니스 변수에서 추출하는 데 사용됩니다.

UI 템플릿은 프록시 개발자를 위한 관리 UI에서 사용할 수 있습니다. 프록시 개발자는 메시지 흐름에서 mint 정책을 첨부합니다. 이 정책을 실행하면 오류가 발생합니다. 오류 응답을 전송합니다 ContinueOnError가 true로 설정되면 오류가 발생하지 않으며 흐름 변수 'mint.limitsViolated', 'mint.isDeveloperSuspended', 'mint.limitsPolicyError'가 설정됩니다. 필요한 경우 추가 예외 처리에 사용할 수 있습니다.