를 사용하여 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 Management Portal해 둡니다.

2. 제품 로드 양식(PLF)에 필요한 가격 정보를 작성한 후 처리를 위해 반송합니다.

3. CheckoutLicense, ExtendLicenseConsumption및 를 호출하는 데 필요한 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. 정의한 모든 요금 차원에 대한 레코드를 사용하여 RegisterUsage API 작업에 대한 테스트 호출을 수행합니다.

AMI기반 제품을 License Manager와 통합하려면

1. License Manager에서 테스트 라이선스 생성의 절차를 완료합니다. License Manager에서 통합을 테스트하는 데 사용할 테스트 라이선스를 생성해야 합니다.

2. 1단계에서 얻은 Amazon 리소스 이름(ARN) 라이선스를 사용하여 GetLicense API 작업을 실행합니다. 나중에 사용할 수 있도록 GetLicense 응답의 KeyFingerprint 속성 값을 기록해 둡니다.

3. 애플리케이션에 최신 퍼블릭 AWS SDK을 다운로드하고 포함합니다.

4. 구매자가 애플리케이션에 대한 라이선스를 사용할 권한이 있는지 확인하려면 CheckoutLicense API 작업을 실행합니다. 1단계에서 얻은 테스트 라이선스의 자격 세부 정보와 key fingerprint를 사용합니다.

   라이선스에 대한 사용자 권한을 찾을 수 없거나 사용자 권한 최대 수를 초과하면 CheckoutLicense API 작업이 를 반환합니다NoEntitlementsAllowedException. 권한이 유효하거나 사용 가능한 경우 CheckoutLicense 작업은 요청된 권한 및 해당 값이 포함된 성공 응답을 반환합니다.

5. (부동 권한에만 필요) CheckoutLicense 응답에서 수신LicenseConsumptionToken된 를 사용하여 CheckinLicense API 작업을 실행합니다. 이 작업은 이전에 체크아웃한 권한을 사용 가능한 권한 풀로 해제합니다.

6. 1단계에서 생성한 테스트 라이선스로 License Manager 통합을 성공적으로 확인한 후에는 코드의 key fingerprint를 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을 값으로 사용합니다.