使用将许可证与AMI基于产品的相关联 AWS License Manager

1. 卖家创建具有 AWS License Manager 集成功能的产品。

2. 卖家在上架商品 AWS Marketplace。

3. 买家在上面找到产品 AWS Marketplace 并购买。

4. 许可证通过买家的 AWS 账户发送给他们。

5. 买家通过启动亚马逊弹性计算云 (亚马逊EC2) 实例、亚马逊弹性容器服务 (亚马逊ECS) 任务或亚马逊 Elastic Kubernetes Service (Ama EKS zon) pod 软件来使用该软件，客户使用角色进行部署。IAM

6. 软件读取买方 AWS License Manager 账户中的许可证，发现购买的权利并相应地配置功能。

   注意

   License Manager 不进行任何跟踪或更新；这些是通过卖家的应用程序完成的。

1. 在中创建新AMI产品 AWS Marketplace 管理门户，并记下其产品代码。

2. 在产品装货表 (PLF) 中填写必要的价格信息，然后将其退还给我们进行处理。

3. 为运行应用程序的任务或 Pod 使用具有调用CheckoutLicenseExtendLicenseConsumption、和所需IAM权限的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 资源名称 (ARN) 运行GetLicenseAPI操作。记下 GetLicense 响应的 KeyFingerprint 属性的值以备后用。

3. 下载并在您的应用程序 AWS SDK中包含最新的公开内容。

4. 要验证买家是否有权为您的应用程序使用许可证，请运行该CheckoutLicenseAPI操作。使用您在步骤 1 中获得的测试许可证的权利详细信息和密钥指纹。

   如果找不到许可证的授权，或者超过了授权上限，则CheckoutLicenseAPI操作将返回NoEntitlementsAllowedException。如果权利有效或可供使用，则 CheckoutLicense 操作将返回包含请求的权利及其值的成功响应。

5. （仅适用于浮动授权）使用CheckoutLicense响应中收到LicenseConsumptionToken的CheckinLicenseAPI操作运行操作。此操作会将先前已签出的权利释放回可用权利池中。

6. 成功使用您在步骤 1 中创建的测试许可证验证 License Manager 集成后，将代码中的密钥指纹更新为 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。