使用 將授權與 AMI型產品建立關聯 AWS License Manager

1. 賣方建立具有 AWS License Manager 整合的產品。

2. 賣方會在 上列出產品 AWS Marketplace。

3. 買方在 上找到 AWS Marketplace 並購買產品。

4. 授權會在其 中傳送給買方 AWS 帳戶。

5. 買方透過啟動 Amazon Elastic Compute Cloud （Amazon EC2） 執行個體、Amazon Elastic Container Service （Amazon ECS） 任務或 Amazon Elastic Kubernetes Service （Amazon EKS） Pod 軟體來使用軟體，客戶會使用 IAM角色部署 。

6. 軟體會讀取買方 AWS License Manager 帳戶中的授權、探索購買的權限，並相應地佈建功能。

   注意

   License Manager 不會執行任何追蹤或更新；這由賣方的應用程式完成。

1. 在 中建立新的AMI產品 AWS Marketplace 管理入口網站，並記下其產品代碼。

2. 將必要的價格資訊填入產品載入表單 （PLF），並將其傳回給我們進行處理。

3. 針對執行應用程式的 任務或 Pod 使用 IAM角色，具有呼叫 CheckoutLicense、 ExtendLicenseConsumption和 所需的IAM許可CheckInLicense。

   必要的IAM許可詳述於下列IAM政策。

   {
      "Version":"2012-10-17",
      "Statement":[
         {
            "Sid":"VisualEditorO",
            "Effect":"Allow",
            "Action":[
               "license-manager:CheckoutLicense",
               "license-manager:GetLicense",
               "license-manager:CheckInLicense",
               "license-manager:ExtendLicenseConsumption",
               "license-manager:ListReceivedLicenses"
            ],
            "Resource":"*"
         }
      ]
   }

4. 使用您定義的所有定價維度的記錄，對 RegisterUsageAPI操作進行測試呼叫。

將 AMI型產品與 License Manager 整合

1. 完成在 License Manager 中建立測試授權中的程序。您必須在 License Manager 中建立測試授權，以測試整合。

2. 使用您在步驟 1 中取得的授權 Amazon Resource Name （ARN） 執行GetLicenseAPI操作。請注意GetLicense回應的KeyFingerprint屬性值，以供日後使用。

3. 下載並在應用程式中包含最新的公有 AWS SDK版本。

4. 若要驗證買方是否有權為您的應用程式使用授權，請執行 CheckoutLicenseAPI操作。使用您在步驟 1 中取得之測試授權的權限詳細資訊和金鑰指紋。

   如果找不到授權的權限，或超過權限上限計數，CheckoutLicenseAPI操作會傳回 NoEntitlementsAllowedException。如果權限有效或可供使用，CheckoutLicense操作會傳回成功回應，其中包含請求的權限及其值。

5. （僅適用於浮動權限） 使用CheckoutLicense回應中LicenseConsumptionToken收到的 執行CheckinLicenseAPI操作。此動作會將先前已簽退的權限傳回至可用權限集區。

6. 成功驗證 License Manager 與您在步驟 1 中建立的測試授權整合後，請將程式碼中的金鑰指紋更新為 aws:294406891311:AWS/Marketplace:issuer-fingerprint。現在，您已準備好使用 核發的 授權 AWS Marketplace。

為 AMI型產品建立測試授權

1. 在已安裝 AWS CLI v2 的本機環境中，執行下列指令碼。指令碼會建立測試授權，並設定適當的產品詳細資訊。

   注意

   使用與您部署和測試軟體 AWS 帳戶 的測試 AWS 帳戶 不同的 。無法在相同的 中建立、授予和簽出授權 AWS 帳戶。

   #!/bin/bash
   
   # Replace with intended product ID on AWS Marketplace
   PRODUCT_ID=<REPLACE-WITH-PRODUCT-ID>
   
   # Replace with license recipient's AWS Account ID
   BENEFICIARY_ACCOUNT_ID=<REPLACE-WITH-BENEFICIARY-ACCOUNT-ID>
   
   # Replace with your product's name
   PRODUCT_NAME="Test Product"
   
   # Replace with your seller name on AWS Marketplace
   SELLER_OF_RECORD="Test Seller" 
   
   # Replace with intended license name
   LICENSE_NAME="AWSMP Test License"
   
   # Replace the following with desired contract dimensions
   # More info here: https://docs.aws.amazon.com/license-manager/latest/APIReference/API_Entitlement.html
   # Example "configurable entitlement"
   ENTITLEMENTS='[
     {
       "Name": "ReadOnly",
       "MaxCount": 5,
       "Overage": false,
       "Unit": "Count",
       "AllowCheckIn": true
     }
   ]'
   # Example "tiered entitlement"
   # ENTITLEMENTS='[
   #   {
   #     "Name": "EnterpriseUsage", 
   #     "Value": "Enabled",
   #     "Unit": "None"
   #   }
   # ]'
   
   # Format "yyyy-mm-ddTHH:mm:ss.SSSZ"
   # This creates a validity period of 10 days starting the current day
   # Can be updated to desired dates
   VALIDITY_START=$(date +%Y-%m-%dT%H:%M:%S.%SZ)
   VALIDITY_END=$(date --date="+10 days" +%Y-%m-%dT%H:%M:%S.%SZ)
   
   # Configuration for consumption of the license as set on Marketplace products
   CONSUMPTION_CONFIG='{
    "RenewType": "None",
    "ProvisionalConfiguration": {
      "MaxTimeToLiveInMinutes": 60
    }
   }'
   
   # License's home Region
   HOME_REGION=us-east-1
   
   # License issuer's name
   ISSUER=Self  
   
   # Run AWS CLI command to create a license
   aws license-manager create-license \
     --license-name "${LICENSE_NAME}" \
     --product-name "${PRODUCT_NAME}" \
     --product-sku "${PRODUCT_ID}" \
     --issuer Name="${ISSUER}" \
     --beneficiary "${BENEFICIARY_ACCOUNT_ID}" \
     --validity 'Begin="'"${VALIDITY_START}"'",End="'"${VALIDITY_END}"'"' \
     --entitlements "${ENTITLEMENTS}" \
     --home-region "${HOME_REGION}" \
     --region "${HOME_REGION}" \
     --consumption-configuration "${CONSUMPTION_CONFIG}" \
     --client-token $(uuidgen)

2. 使用 AWS License Manager 主控台授予授權。如需詳細資訊，請參閱 License Manager 使用者指南中的分發權限。

3. 登入作為買方帳戶的 AWS 帳戶 ，您將在其中部署和測試軟體。這必須與建立和授予授權 AWS 帳戶 的 AWS 帳戶 不同。

4. 前往 AWS License Manager 主控台以接受和啟用授予的授權。如需詳細資訊，請參閱 License Manager 使用者指南中的管理授予的授權。

5. 在環境中執行下列命令。

   # The following example uses a key fingerprint that should match the test license you created.
   # When checking out an actual AWS Marketplace created license, use the following fingerprint:
   # aws:294406891311:AWS/Marketplace:issuer-fingerprint
   aws license-manager checkout-license \
     --product-sku <REPLACE-WITH-PRODUCT-ID> \
     --checkout-type PROVISIONAL \
     --key-fingerprint "aws:<ACCOUNT-ID-WHERE-YOU-CREATED-TEST-LICENSE>:Self:issuer-fingerprint" \
     --entitlements "Name=ReadOnly,Value=1,Unit=Count" \
     --client-token $(uuidgen)

   上一個命令使用 PROVISIONAL作為 CheckoutType 參數的值。如果 權限使用撥款授權，請使用 PERPETUAL 作為 值。