Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Laden Sie IDT für AWS IoT Greengrass V2 herunter
In diesem Thema werden die Optionen zum Herunterladen AWS IoT Device Tester für AWS IoT Greengrass V2 beschrieben. Sie können entweder einen der folgenden Links zum Herunterladen von Software verwenden oder den Anweisungen folgen, um IDT programmgesteuert herunterzuladen.
**Topics**
+ [Laden Sie IDT manuell herunter](#idt-download-options)
+ [Laden Sie IDT programmgesteuert herunter](#idt-programmatic-download-process)
[Durch das Herunterladen der Software stimmen Sie der AWS IoT Device Tester Lizenzvereinbarung zu.](https://docs.aws.amazon.com/greengrass/v2/developerguide/idt-license.html)
**Anmerkung**
IDT unterstützt nicht die Ausführung durch mehrere Benutzer von einem gemeinsam genutzten Speicherort aus, z. B. einem NFS-Verzeichnis oder einem freigegebenen Windows-Netzwerkordner. Es wird empfohlen, das IDT-Paket auf ein lokales Laufwerk zu extrahieren und die IDT-Binärdatei auf Ihrer lokalen Workstation auszuführen.
## Laden Sie IDT manuell herunter
In diesem Thema werden die unterstützten Versionen von IDT für AWS IoT Greengrass V2 aufgeführt. Als bewährte Methode empfehlen wir, dass Sie die neueste Version von IDT für AWS IoT Greengrass V2 verwenden, die Ihre Zielversion von AWS IoT Greengrass V2 unterstützt. Bei neuen Versionen von müssen Sie AWS IoT Greengrass möglicherweise eine neue Version von IDT für AWS IoT Greengrass V2 herunterladen. Sie erhalten eine Benachrichtigung, wenn Sie einen Testlauf starten, wenn IDT für AWS IoT Greengrass V2 nicht mit der von AWS IoT Greengrass Ihnen verwendeten Version kompatibel ist.
**IDT v4.9.4 für AWS IoT Greengrass**
Unterstützte Versionen: AWS IoT Greengrass
+ [Greengrass Nucleus](greengrass-nucleus-component.md) v2.12.0, v2.11.0, v2.10.0 und v2.9.5
IDT-Softwaredownloads:
+ [IDT v4.9.4 mit Testsuite Q\$12.5.4 für Linux GGV2](https://docs.aws.amazon.com/greengrass/v2/developerguide/devicetester_greengrass_v2_4.9.4_testsuite_2.5.4_linux.zip)
+ [IDT v4.9.4 mit Testsuite GGV2 Q\$12.5.4 für 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 mit Testsuite Q\$12.5.4 für Windows GGV2](https://docs.aws.amazon.com/greengrass/v2/developerguide/devicetester_greengrass_v2_4.9.4_testsuite_2.5.4_win.zip)
Versionshinweise:
+ Ermöglicht die Gerätevalidierung und Qualifizierung für Geräte, auf denen die AWS IoT Greengrass Core-Softwareversionen 2.12.0, 2.11.0, 2.10.0 und 2.9.5 ausgeführt werden.
+ Entfernt Stream Manager- und Machine-Learning-Testgruppen.
Weitere Hinweise:
+ Wenn Ihr Gerät ein HSM verwendet und Sie Nucleus 2.10.x verwenden, migrieren Sie zu Greengrass Nucleus Version 2.11.0 oder höher.
Testsuite-Version:
`GGV2Q_2.5.4`
+ Veröffentlicht am 2024.05.03
## Laden Sie IDT programmgesteuert herunter
IDT bietet eine API-Operation, mit der Sie eine URL abrufen können, über die Sie IDT programmgesteuert herunterladen können. Sie können diesen API-Vorgang auch verwenden, um zu überprüfen, ob Sie über die neueste Version von IDT verfügen. Dieser API-Vorgang hat den folgenden Endpunkt.
```
https://download.devicetester.iotdevicesecosystem.amazonaws.com/latestidt
```
Um diesen API-Vorgang aufrufen zu können, müssen Sie über die Berechtigung zum Ausführen der **iot-device-tester:LatestIdt** Aktion verfügen. Fügen Sie Ihre AWS Signatur hinzu und verwenden Sie `iot-device-tester` sie als Dienstnamen.
### API-Anfrage
HostOs — Das Betriebssystem des Host-Computers. Wählen Sie aus den folgenden Optionen aus:
+ `mac`
+ `linux`
+ `windows`
TestSuiteType — Der Typ der Testsuite. Wählen Sie die folgende Option:
`GGV2`— IDT für V2 AWS IoT Greengrass
ProductVersion
(Optional) Die Version des Greengrass-Kerns. Der Dienst gibt die neueste kompatible Version von IDT für diese Version von Greengrass Nucleus zurück. Wenn Sie diese Option nicht angeben, gibt der Dienst die neueste Version von IDT zurück.
### API-Antwort
Die API-Antwort hat das folgende Format. Das `DownloadURL` beinhaltet eine Zip-Datei.
```
{
"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
}
}
```
### Beispiele
Sie können sich auf die folgenden Beispiele beziehen, um IDT programmgesteuert herunterzuladen. In diesen Beispielen werden Anmeldeinformationen verwendet, die Sie in den Umgebungsvariablen `AWS_ACCESS_KEY_ID` und `AWS_SECRET_ACCESS_KEY` speichern. Speichern Sie Ihre Anmeldeinformationen nicht in Ihrem Code, um die besten Sicherheitsvorkehrungen zu befolgen.
**Example Beispiel: Herunterladen mit cURL Version 7.75.0 oder höher (Mac und Linux)**
Wenn Sie die cURL-Version 7.75.0 oder höher haben, können Sie das `aws-sigv4` Flag verwenden, um die API-Anfrage zu signieren. In diesem Beispiel wird [jq](https://stedolan.github.io/jq/) verwendet, um die Download-URL aus der Antwort zu analysieren.
Das `aws-sigv4` Flag erfordert, dass die Abfrageparameter der curl-GET-Anfrage in der Reihenfolge oder angegeben werden. **HostOs/ProductVersion/TestSuiteType** **HostOs/TestSuiteType** Bestellungen, die nicht konform sind, führen zu einem Fehler beim Abrufen nicht übereinstimmender Signaturen für den Canonical String vom API Gateway.
Wenn der optionale Parameter enthalten **ProductVersion** ist, müssen Sie eine unterstützte Produktversion verwenden, wie unter Unterstützte [Versionen von](dev-test-versions.md) für V2 dokumentiert. AWS IoT Device Tester AWS IoT Greengrass
+ Ersetze es *us-west-2* durch dein AWS-Region. Eine Liste der Regionscodes finden Sie unter [Regionale Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ *linux*Ersetzen Sie es durch das Betriebssystem Ihres Host-Computers.
+ *2.5.3*Ersetzen Sie es durch Ihre Version von 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 Beispiel: Herunterladen mit einer früheren Version von cURL (Mac und Linux)**
Sie können den folgenden cURL-Befehl mit einer AWS Signatur verwenden, die Sie signieren und berechnen. Weitere Informationen zum Signieren und Berechnen einer AWS Signatur finden Sie unter [AWS API-Anfragen signieren](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html).
+ *linux*Ersetzen Sie es durch das Betriebssystem Ihres Host-Computers.
+ *Timestamp*Ersetzen Sie durch Datum und Uhrzeit, z. **20220210T004606Z** B.
+ *Date*Ersetzen Sie es durch das Datum, z. **20220210** B.
+ Ersetze *AWSRegion* durch dein AWS-Region. Eine Liste der Regionscodes finden Sie unter [Regionale Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ *AWSSignature*Ersetzen Sie es durch die [AWS Signatur](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html), die Sie generieren.
```
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 Beispiel: Herunterladen mit einem Python-Skript**
In diesem Beispiel wird die [Python-Anforderungsbibliothek](https://pypi.org/project/requests/) verwendet. Dieses Beispiel ist an das Python-Beispiel angepasst, um [eine AWS API-Anfrage zu signieren](https://docs.aws.amazon.com/general/latest/gr/sigv4-signed-request-examples.html) in der *AWS Allgemeinen Referenz*.
+ Ersetzen Sie *us-west-2* durch Ihre Region. Eine Liste der Regionscodes finden Sie unter [Regionale Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ *linux*Ersetzen Sie es durch das Betriebssystem Ihres Host-Computers.
```
# 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)
```