を使用した 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) ポッドソフトウェアを起動してソフトウェアを使用します。お客様は IAMロールを使用してデプロイします。

6. ソフトウェアは購入者の AWS License Manager アカウントでライセンスを読み取り、購入したエンタイトルメントを検出し、それに応じて機能をプロビジョニングします。

   注記

   License Manager は追跡や更新を行いません。これは販売者のアプリケーションによって行われます。

1. で新しいAMI製品を作成し AWS Marketplace 管理ポータル、その製品コードを書き留めます。

2. Product Load Form (PLF) に必要な料金情報を記入し、処理のために返送してください。

3. CheckoutLicense、、および を呼び出すために必要なIAMアクセス許可を持つ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 リソースネーム (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 コンソールに移動して、付与されたライセンスを受け入れてアクティブ化します。詳細については、「AWS 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 を使用します。