Scarica IDT per V2 AWS IoT Greengrass - AWS IoT Greengrass

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Scarica IDT per V2 AWS IoT Greengrass

Questo argomento descrive le opzioni di download AWS IoT Device Tester per la AWS IoT Greengrass V2. È possibile utilizzare uno dei seguenti collegamenti per il download del software oppure seguire le istruzioni per scaricare IDT a livello di programmazione.

Scaricando il software, l'utente accetta il Contratto di licenza.AWS IoT Device Tester

Nota

IDT non supporta l'esecuzione da parte di più utenti da un percorso condiviso, ad esempio una directory NFS o una cartella condivisa di rete Windows. Si consiglia di estrarre il pacchetto IDT in un'unità locale ed eseguire il file binario IDT sulla workstation locale.

Scarica IDT manualmente

Questo argomento elenca le versioni supportate di IDT per AWS IoT Greengrass V2. Come best practice, ti consigliamo di utilizzare la versione più recente di IDT per AWS IoT Greengrass V2 che supporti la versione di destinazione di V2. AWS IoT Greengrass Le nuove versioni di AWS IoT Greengrass potrebbero richiedere il download di una nuova versione di IDT per V2. AWS IoT Greengrass Riceverai una notifica quando inizi un'esecuzione di test se IDT per AWS IoT Greengrass V2 non è compatibile con la versione che stai utilizzando. AWS IoT Greengrass

IDT v4.9.4 per AWS IoT Greengrass
AWS IoT Greengrass Versioni supportate:
Download del software IDT:
Note di rilascio:
  • Consente la convalida e la qualificazione dei dispositivi per i dispositivi che eseguono le versioni del software Core 2.12.0, 2.11.0, 2.10.0 e 2.9.5. AWS IoT Greengrass

  • Rimuove lo stream manager e i gruppi di test di machine learning.

Note aggiuntive:
  • Se il tuo dispositivo utilizza un HSM e stai usando nucleus 2.10.x, esegui la migrazione alla versione 2.11.0 o successiva di Greengrass nucleus.

Versione della suite di test:
GGV2Q_2.5.4
  • Rilasciato il 2024.05.03

Scarica IDT a livello di codice

IDT fornisce un'operazione API che puoi utilizzare per recuperare un URL da cui scaricare IDT a livello di codice. Puoi anche utilizzare questa operazione API per verificare se disponi della versione più recente di IDT. Questa operazione API ha il seguente endpoint.

https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt

Per richiamare questa operazione API, è necessario disporre dell'autorizzazione per eseguire l'iot-device-tester:LatestIdtazione. Includi la tua AWS firma e iot-device-tester usala come nome del servizio.

Richiesta API

HostOs — Il sistema operativo del computer host. Seleziona una delle opzioni seguenti:
  • mac

  • linux

  • windows

TestSuiteType — Il tipo di suite di test. Scegliete la seguente opzione:

GGV2— IDT per V2 AWS IoT Greengrass

ProductVersion

(Opzionale) La versione del nucleo Greengrass. Il servizio restituisce l'ultima versione compatibile di IDT per quella versione del nucleo Greengrass. Se non si specifica questa opzione, il servizio restituisce la versione più recente di IDT.

Risposta API

La risposta dell'API ha il seguente formato. DownloadURLInclude un file 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 } }

Esempi

È possibile fare riferimento ai seguenti esempi per scaricare IDT a livello di programmazione. Questi esempi utilizzano credenziali memorizzate nelle variabili di ambiente e. AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY Per seguire le migliori pratiche di sicurezza, non memorizzate le credenziali nel codice.

Esempio: download utilizzando cURL versione 7.75.0 o successiva (Mac e Linux)

Se hai cURL versione 7.75.0 o successiva, puoi usare il aws-sigv4 flag per firmare la richiesta API. Questo esempio utilizza jq per analizzare l'URL di download dalla risposta.

avvertimento

Il aws-sigv4 flag richiede che i parametri di query della richiesta curl GET siano nell'ordine di o. HostOs/ProductVersion/TestSuiteType HostOs/TestSuiteType Gli ordini non conformi comporteranno un errore nell'ottenere firme non corrispondenti per la stringa canonica dall'API Gateway.

Se il parametro opzionale ProductVersion è incluso, è necessario utilizzare una versione del prodotto supportata come documentato in Versioni supportate di for V2. AWS IoT Device TesterAWS IoT Greengrass

  • Sostituisci us-west-2 con il tuo. Regione AWS Per l'elenco dei codici regionali, consulta Endpoint regionali.

  • Sostituisci linux con il sistema operativo della tua macchina host.

  • Sostituisci 2.5.3 con la tua versione di 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
Esempio: download utilizzando una versione precedente di cURL (Mac e Linux)

È possibile utilizzare il seguente comando cURL con una AWS firma da firmare e calcolare. Per ulteriori informazioni su come firmare e calcolare una AWS firma, consulta Firmare le richieste AWS API.

  • Sostituisci linux con il sistema operativo della tua macchina host.

  • Sostituisci Timestamp con data e ora, ad esempio. 20220210T004606Z

  • Sostituisci Date con la data, ad esempio. 20220210

  • Sostituisci AWSRegioncon il tuo Regione AWS. Per l'elenco dei codici regionali, consulta Endpoint regionali.

  • Sostituiscilo AWSSignaturecon la AWS firma generata.

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'
Esempio: download utilizzando uno script Python

Questo esempio utilizza la libreria di richieste Python. Questo esempio è adattato dall'esempio Python per Sign an AWS API request nel AWS General Reference.

  • Sostituisci us-west-2 con la tua Regione. Per l'elenco dei codici regionali, vedi Endpoint regionali.

  • Sostituisci linux con il sistema operativo della tua macchina 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)