As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Fazer download do IDT para AWS IoT Greengrass V2
Este tópico descreve as opções para baixar o AWS IoT Device Tester para AWS IoT Greengrass V2. Você pode usar um dos links de download de software a seguir ou seguir as instruções para baixar o IDT de forma programática.
**Topics**
+ [Baixar IDT manualmente](#idt-download-options)
+ [Baixar IDT de maneira programada](#idt-programmatic-download-process)
Ao fazer download do software, você concorda com o [Contrato de licença do AWS IoT Device Tester](https://docs.aws.amazon.com/greengrass/v2/developerguide/idt-license.html).
**nota**
O IDT não oferece suporte a execução por vários usuários em um local compartilhado, como um diretório NFS ou uma pasta compartilhada de rede do Windows. Recomendamos extrair o pacote do IDT para uma unidade local e executar o binário do IDT na estação de trabalho local.
## Baixar IDT manualmente
Este tópico lista as versões compatíveis do IDT para o AWS IoT Greengrass V2. Como prática recomendada, use a versão mais recente do IDT para o AWS IoT Greengrass V2 que seja compatível com a sua versão de destino do AWS IoT Greengrass V2. Novas versões do AWS IoT Greengrass podem exigir que você faça o download de uma nova versão do IDT para o AWS IoT Greengrass V2. Você receberá uma notificação ao iniciar uma execução de teste se o IDT para o AWS IoT Greengrass V2 não for compatível com a versão do AWS IoT Greengrass que você está usando.
**IDT v4.9.4 para AWS IoT Greengrass**
Versões do AWS IoT Greengrass com suporte
+ [Núcleo do Greengrass](greengrass-nucleus-component.md) v2.12.0, v2.11.0, v2.10.0 e v2.9.5
Downloads de software IDT:
+ IDT v4.9.4 com conjunto de testes GGV2Q\$12.5.4 para [Linux](https://docs.aws.amazon.com/greengrass/v2/developerguide/devicetester_greengrass_v2_4.9.4_testsuite_2.5.4_linux.zip)
+ IDT v4.9.4 com conjunto de testes GGV2Q\$12.5.4 para [macOS](https://docs.aws.amazon.com/greengrass/v2/developerguide/devicetester_greengrass_v2_4.9.4_testsuite_2.5.4_mac.zip)
+ IDT v4.9.4 com conjunto de testes GGV2Q\$12.5.4 para [Windows](https://docs.aws.amazon.com/greengrass/v2/developerguide/devicetester_greengrass_v2_4.9.4_testsuite_2.5.4_win.zip)
Notas de release:
+ Permite a validação e qualificação de dispositivos que executam as versões 2.12.0, 2.11.0, 2.10.0 e 2.9.5 do software AWS IoT Greengrass Core.
+ Remove o gerenciador de fluxos e os grupos de teste de machine learning.
Notas adicionais:
+ Se seu dispositivo usa um HSM e você está usando o núcleo 2.10.x, migre para o núcleo do Greengrass versão 2.11.0 ou posterior.
Versão do conjunto de testes:
`GGV2Q_2.5.4`
+ Lançada em 05/03/2024
## Baixar IDT de maneira programada
O IDT fornece uma operação de API que você pode usar para recuperar um URL na qual é possível baixar o IDT de maneira programada. Você também pode usar essa operação de API para verificar se você tem a versão mais recente do IDT. Essa operação da API tem o seguinte endpoint.
```
https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt
```
Para chamar essa operação de API, você deve ter a permissão para executar a ação **iot-device-tester:LatestIdt**. Inclua sua assinatura da AWS, e use `iot-device-tester` como o nome do serviço
### Solicitações de API
HostOS: o sistema operacional da máquina host. Escolha uma das seguintes opções:
+ `mac`
+ `linux`
+ `windows`
TestSuiteType: o tipo do pacote de testes. Escolha a seguinte opção:
`GGV2`: IDT para AWS IoT Greengrass V2
ProductVersion
(Opcional) A versão do núcleo Greengrass. O serviço retorna a versão mais recente compatível do IDT para essa versão do núcleo do Greengrass. Se você não especificar essa opção, o serviço retornará a versão mais recente do IDT.
### Resposta da API
O resposta da API tem o seguinte formato. O arquivo `DownloadURL` inclui o arquivo zip.
```
{
"Success": True or False,
"Message": Message,
"LatestBk": {
"Version": The version of the IDT binary,
"TestSuiteVersion": The version of the test suite,
"DownloadURL": The URL to download the IDT Bundle, valid for one hour
}
}
```
### Exemplos
Você pode consultar os exemplos a seguir para baixar o IDT de maneira programada. Esses exemplos usam credenciais que você armazena nas variáveis de ambiente `AWS_ACCESS_KEY_ID` e `AWS_SECRET_ACCESS_KEY`. Para seguir as práticas recomendadas de segurança, não armazene suas credenciais em seu código.
**Example Exemplo: faça download usando cURL versão 7.75.0 ou posterior (Mac e Linux)**
Se você tiver a versão 7.75.0 ou posterior do cURL, poderá usar a sinalização `aws-sigv4` para assinar a solicitação da API. Este exemplo usa [jq](https://stedolan.github.io/jq/) para analisar o URL de download da resposta.
A sinalização `aws-sigv4` exige que os parâmetros de consulta da solicitação GET curl estejam na ordem **HostOs/ProductVersion/TestSuiteType** ou **HostOs/TestSuiteType**. Pedidos que não estiverem em conformidade resultarão em um erro ao obter assinaturas incompatíveis para a string canônica do API Gateway.
Se o parâmetro opcional **ProductVersion** estiver incluído, você deverá usar uma versão de produto compatível conforme documentado em [Versões compatíveis do AWS IoT Greengrass para AWS IoT Device Tester V2](dev-test-versions.md).
+ Substitua *us-west-2* pela sua Região da AWS. Para obter uma lista de códigos de região, consulte [Endpoints regionais](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ Substitua *linux* pelo sistema operacional da sua máquina host.
+ Substitua *2.5.3* pela sua versão do AWS IoT Greengrass nucleus.
```
url=$(curl --request GET "https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt?HostOs=linux&ProductVersion=2.5.3&TestSuiteType=GGV2" \
--user $AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY \
--aws-sigv4 "aws:amz:us-west-2:iot-device-tester" \
| jq -r '.LatestBk["DownloadURL"]')
curl $url --output devicetester.zip
```
**Example Exemplo: faça download usando uma versão anterior do cURL (Mac e Linux)**
Você pode usar o seguinte comando cURL com uma assinatura da AWS que você assina e calcula. Para obter mais informações sobre como assinar e calcular uma assinatura da AWS, consulte [Assinatura de solicitações de API da AWS](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html).
+ Substitua *linux* pelo sistema operacional da sua máquina host.
+ Substitua *Timestamp* pela data e hora, como **20220210T004606Z**.
+ Substitua a *date* pela data, como **20220210**.
+ Substitua a *AWSRegion* pela sua Região da AWS. Para obter uma lista de códigos de região, consulte [Endpoints regionais](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ Substitua *AWSSignature* pela [Assinatura da AWS](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) gerada.
```
curl --location --request GET 'https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt?HostOs=linux&TestSuiteType=GGV2' \
--header 'X-Amz-Date: Timestamp \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=$AWS_ACCESS_KEY_ID/Date/AWSRegion/iot-device-tester/aws4_request, SignedHeaders=host;x-amz-date, Signature=AWSSignature'
```
**Example Exemplo: faça o download usando um script Python**
Este exemplo usa a biblioteca de [solicitações](https://pypi.org/project/requests/) do Python. Esse exemplo foi adaptado do exemplo do Python para [Assinar uma solicitação de API da AWS](https://docs.aws.amazon.com/general/latest/gr/sigv4-signed-request-examples.html) na *Referência geral da AWS*.
+ Substitua *us-west-2* pela sua região. Para obter uma lista de códigos de região, consulte [Endpoints regionais](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ Substitua *linux* pelo sistema operacional da sua máquina host.
```
# Copyright 2010-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# This file is licensed under the Apache License, Version 2.0 (the "License").
# You may not use this file except in compliance with the License. A copy of the
#License is located at
#
# http://aws.amazon.com/apache2.0/
#
# This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
# OF ANY KIND, either express or implied. See the License for the specific
# language governing permissions and limitations under the License.
# See: http://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html
# This version makes a GET request and passes the signature
# in the Authorization header.
import sys, os, base64, datetime, hashlib, hmac
import requests # pip install requests
# ************* REQUEST VALUES *************
method = 'GET'
service = 'iot-device-tester'
host = 'download.devicetester.iotdevicesecosystem.amazonaws.com'
region = 'us-west-2'
endpoint = 'https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt'
request_parameters = 'HostOs=linux&TestSuiteType=GGV2'
# Key derivation functions. See:
# http://docs.aws.amazon.com/general/latest/gr/signature-v4-examples.html#signature-v4-examples-python
def sign(key, msg):
return hmac.new(key, msg.encode('utf-8'), hashlib.sha256).digest()
def getSignatureKey(key, dateStamp, regionName, serviceName):
kDate = sign(('AWS4' + key).encode('utf-8'), dateStamp)
kRegion = sign(kDate, regionName)
kService = sign(kRegion, serviceName)
kSigning = sign(kService, 'aws4_request')
return kSigning
# Read AWS access key from env. variables or configuration file. Best practice is NOT
# to embed credentials in code.
access_key = os.environ.get('AWS_ACCESS_KEY_ID')
secret_key = os.environ.get('AWS_SECRET_ACCESS_KEY')
if access_key is None or secret_key is None:
print('No access key is available.')
sys.exit()
# Create a date for headers and the credential string
t = datetime.datetime.utcnow()
amzdate = t.strftime('%Y%m%dT%H%M%SZ')
datestamp = t.strftime('%Y%m%d') # Date w/o time, used in credential scope
# ************* TASK 1: CREATE A CANONICAL REQUEST *************
# http://docs.aws.amazon.com/general/latest/gr/sigv4-create-canonical-request.html
# Step 1 is to define the verb (GET, POST, etc.)--already done.
# Step 2: Create canonical URI--the part of the URI from domain to query
# string (use '/' if no path)
canonical_uri = '/latestidt'
# Step 3: Create the canonical query string. In this example (a GET request),
# request parameters are in the query string. Query string values must
# be URL-encoded (space=%20). The parameters must be sorted by name.
# For this example, the query string is pre-formatted in the request_parameters variable.
canonical_querystring = request_parameters
# Step 4: Create the canonical headers and signed headers. Header names
# must be trimmed and lowercase, and sorted in code point order from
# low to high. Note that there is a trailing \n.
canonical_headers = 'host:' + host + '\n' + 'x-amz-date:' + amzdate + '\n'
# Step 5: Create the list of signed headers. This lists the headers
# in the canonical_headers list, delimited with ";" and in alpha order.
# Note: The request can include any headers; canonical_headers and
# signed_headers lists those that you want to be included in the
# hash of the request. "Host" and "x-amz-date" are always required.
signed_headers = 'host;x-amz-date'
# Step 6: Create payload hash (hash of the request body content). For GET
# requests, the payload is an empty string ("").
payload_hash = hashlib.sha256(('').encode('utf-8')).hexdigest()
# Step 7: Combine elements to create canonical request
canonical_request = method + '\n' + canonical_uri + '\n' + canonical_querystring + '\n' + canonical_headers + '\n' + signed_headers + '\n' + payload_hash
# ************* TASK 2: CREATE THE STRING TO SIGN*************
# Match the algorithm to the hashing algorithm you use, either SHA-1 or
# SHA-256 (recommended)
algorithm = 'AWS4-HMAC-SHA256'
credential_scope = datestamp + '/' + region + '/' + service + '/' + 'aws4_request'
string_to_sign = algorithm + '\n' + amzdate + '\n' + credential_scope + '\n' + hashlib.sha256(canonical_request.encode('utf-8')).hexdigest()
# ************* TASK 3: CALCULATE THE SIGNATURE *************
# Create the signing key using the function defined above.
signing_key = getSignatureKey(secret_key, datestamp, region, service)
# Sign the string_to_sign using the signing_key
signature = hmac.new(signing_key, (string_to_sign).encode('utf-8'), hashlib.sha256).hexdigest()
# ************* TASK 4: ADD SIGNING INFORMATION TO THE REQUEST *************
# The signing information can be either in a query string value or in
# a header named Authorization. This code shows how to use a header.
# Create authorization header and add to request headers
authorization_header = algorithm + ' ' + 'Credential=' + access_key + '/' + credential_scope + ', ' + 'SignedHeaders=' + signed_headers + ', ' + 'Signature=' + signature
# The request can include any headers, but MUST include "host", "x-amz-date",
# and (for this scenario) "Authorization". "host" and "x-amz-date" must
# be included in the canonical_headers and signed_headers, as noted
# earlier. Order here is not significant.
# Python note: The 'host' header is added automatically by the Python 'requests' library.
headers = {'x-amz-date':amzdate, 'Authorization':authorization_header}
# ************* SEND THE REQUEST *************
request_url = endpoint + '?' + canonical_querystring
print('\nBEGIN REQUEST++++++++++++++++++++++++++++++++++++')
print('Request URL = ' + request_url)
response = requests.get(request_url, headers=headers)
print('\nRESPONSE++++++++++++++++++++++++++++++++++++')
print('Response code: %d\n' % response.status_code)
print(response.text)
download_url = response.json()["LatestBk"]["DownloadURL"]
r = requests.get(download_url)
open('devicetester.zip', 'wb').write(r.content)
```