

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.

# Instance-Identitätsdokument für eine Amazon-EC2-Instance verifizieren

Wenn Sie beabsichtigen, den Inhalt des Instance-Identitätsdokument für einen wichtigen Zweck zu verwenden, sollten Sie den Inhalt und die Authentizität überprüfen, bevor Sie es verwenden.

Das Klartext-Instance-Identitätsdokument wird von drei gehashten und verschlüsselten Signaturen ergänzt. Sie können diese Signaturen verwenden, um die Herkunft und Authentizität des Instance-Identitätsdokument und der darin enthaltenen Informationen zu überprüfen. Die folgenden Signaturen werden bereitgestellt:
+ Base64-encoded Signatur — Dies ist ein Base64-kodierter SHA256-Hash des Instanzidentitätsdokuments, der mit einem RSA-Schlüsselpaar verschlüsselt wird.
+ PKCS7-Signatur—Dies ist ein SHA1-Hash des Instance-Identitätsdokument, der mit einem DSA-Schlüsselpaar verschlüsselt wird.
+ RSA-2048 Signatur — Dies ist ein SHA256-Hash des Instanzidentitätsdokuments, der mit einem Schlüsselpaar verschlüsselt wird. RSA-2048 

Jede Signatur ist an einem anderen Endpunkt in den Metadaten der Instance verfügbar. Sie können je nach Ihren Hashing- und Verschlüsselungsanforderungen eine beliebige dieser Signaturen verwenden. Um die Signaturen zu überprüfen, müssen Sie das entsprechende öffentliche Zertifikat verwenden. AWS 

**Contents**
+ [Option 1: Verwenden der PKCS7-Signatur zur Verifizierung des Instance-Identitätsdokuments](#verify-pkcs7)
+ [Option 2: Verwendung der Base64-kodierten Signatur zur Verifizierung des Instance-Identitätsdokuments](#verify-signature)
+ [Option 3: Überprüfen Sie das Identitätsdokument der Instanz anhand der Signatur RSA-2048](#verify-rsa2048)

## Option 1: Verwenden der PKCS7-Signatur zur Verifizierung des Instance-Identitätsdokuments
<a name="verify-pkcs7"></a>

In diesem Thema wird erläutert, wie Sie das Instanzidentitätsdokument mithilfe der PKCS7-Signatur und des öffentlichen AWS DSA-Zertifikats verifizieren.

### Linux-Instances
<a name="verify-pkcs7-linux"></a>

**Um das Instanzidentitätsdokument mithilfe der PKCS7-Signatur und der AWS Öffentliches DSA-Zertifikat**

1. Stellen Sie eine Verbindung zur Instance her.

1. Rufen Sie die PKCS7-Signatur aus den Metadaten der Instance ab und fügen Sie sie zu einer Datei namens `pkcs7` mit benötigter Kopf- und Fußzeile hinzu. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```bash
   $ echo "-----BEGIN PKCS7-----" >> {{pkcs7}} \
   	&& TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
   	&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/pkcs7 >> {{pkcs7}} \
   	&& echo "" >> {{pkcs7}} \
   	&& echo "-----END PKCS7-----" >> {{pkcs7}}
   ```

------
#### [ IMDSv1 ]

   ```bash
   $ echo "-----BEGIN PKCS7-----" >> {{pkcs7}} \
   	&& curl -s http://169.254.169.254/latest/dynamic/instance-identity/pkcs7 >> {{pkcs7}} \
   	&& echo "" >> {{pkcs7}} \
   	&& echo "-----END PKCS7-----" >> {{pkcs7}}
   ```

------

1. Suchen Sie das öffentliche **DSA**-Zertifikat für Ihre Region in [AWS öffentliche Zertifikate, zum Beispiel Signaturen von Ausweisdokumenten](regions-certs.md) und fügen Sie den Inhalt in eine neue Datei mit dem Namen `certificate` ein.

1. Verwenden Sie den Befehl **OpenSSL smime**, um die Signatur zu überprüfen. Fügen Sie die Option `-verify` ein, um anzugeben, dass die Signatur verifiziert werden muss, und die Option `-noverify`, um anzugeben, dass das Zertifikat nicht verifiziert werden muss.

   ```bash
   $ openssl smime -verify -in {{pkcs7}} -inform PEM -certfile {{certificate}} -noverify | tee document
   ```

   Wenn die Signatur gültig ist, wird die Meldung `Verification successful` angezeigt.

   Der Befehl schreibt außerdem den Inhalt des Instance-Identitätsdokuments in eine neue Datei namens `document`. Mit den folgenden Befehlen können Sie den Inhalt des Instance-Identitätsdokuments aus den Instance-Metadaten mit dem Inhalt dieser Datei vergleichen.

   ```bash
   $ openssl dgst -sha256 < {{document}}
   ```

   ```bash
   $ curl -s -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/document | openssl dgst -sha256
   ```

    Wenn die Signatur nicht verifiziert werden kann, wenden Sie sich an Support.

### Windows-Instances
<a name="verify-pkcs7-windows"></a>

**Voraussetzungen**  
Dieses Verfahren erfordert die `System.Security` Microsoft .NET Core-Klasse. Führen Sie den folgenden Befehl aus, um die Klasse zu Ihrer PowerShell Sitzung hinzuzufügen.

```PowerShell
PS C:\> Add-Type -AssemblyName System.Security
```

**Anmerkung**  
Der Befehl fügt die Klasse nur der aktuellen PowerShell Sitzung hinzu. Wenn Sie eine neue Sitzung starten, müssen Sie den Befehl erneut ausführen.

**Um das Instanzidentitätsdokument mithilfe der PKCS7-Signatur und der AWS Öffentliches DSA-Zertifikat**

1. Stellen Sie eine Verbindung zur Instance her.

1. Rufen Sie die PKCS7-Signatur aus den Metadaten der Instance ab, konvertieren Sie sie in ein Byte-Array und fügen Sie sie an eine Variable namens `$Signature` an. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```PowerShell
   PS C:\> [string]$token = (Invoke-WebRequest -Method Put -Headers @{'X-aws-ec2-metadata-token-ttl-seconds' = '21600'} -Uri http://169.254.169.254/latest/api/token).Content
   ```

   ```PowerShell
   PS C:\> {{$Signature}} = [Convert]::FromBase64String((Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $Token} -Uri http://169.254.169.254/latest/dynamic/instance-identity/pkcs7).Content)
   ```

------
#### [ IMDSv1 ]

   ```PowerShell
   PS C:\> {{$Signature}} = [Convert]::FromBase64String((Invoke-WebRequest -Uri http://169.254.169.254/latest/dynamic/instance-identity/pkcs7).Content)
   ```

------

1. Rufen Sie das Klartext-Identitätsdokument der Instance aus den Instance-Metadaten ab, konvertieren Sie es in ein Byte-Array und fügen Sie es zu einer Variablen namens `$Document` hinzu. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```PowerShell
   PS C:\> {{$Document }}= [Text.Encoding]::UTF8.GetBytes((Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $Token} -Uri http://169.254.169.254/latest/dynamic/instance-identity/document).Content)
   ```

------
#### [ IMDSv1 ]

   ```PowerShell
   PS C:\> {{$Document}} =  [Text.Encoding]::UTF8.GetBytes((Invoke-WebRequest http://169.254.169.254/latest/dynamic/instance-identity/document).Content)
   ```

------

1. Suchen Sie das öffentliche **DSA**-Zertifikat für Ihre Region in [AWS öffentliche Zertifikate, zum Beispiel Signaturen von Ausweisdokumenten](regions-certs.md) und fügen Sie den Inhalt in eine neue Datei mit dem Namen `certificate.pem` ein.

1. Extrahieren Sie das Zertifikat aus der Zertifikatsdatei und speichern Sie es in einer Variablen mit dem Namen `$Store`.

   ```bash
   PS C:\> {{$Store}} = [Security.Cryptography.X509Certificates.X509Certificate2Collection]::new([Security.Cryptography.X509Certificates.X509Certificate2]::new((Resolve-Path {{certificate.pem}})))
   ```

1. Überprüfen Sie die Signatur.

   ```bash
   PS C:\> {{$SignatureDocument}} = [Security.Cryptography.Pkcs.SignedCms]::new()
   ```

   ```bash
   PS C:\> {{$SignatureDocument}}.Decode({{$Signature}})
   ```

   ```bash
   PS C:\> {{$SignatureDocument}}.CheckSignature({{$Store}}, $true)
   ```

   Wenn die Signatur gültig ist, gibt der Befehl keine Ausgabe zurück. Wenn die Signatur nicht verifiziert werden kann, gibt der Befehl zurüc `Exception calling "CheckSignature" with "2" argument(s): "Cannot find the original signer`. Wenn Ihre Signatur nicht verifiziert werden kann, wenden Sie sich an AWS Support.

1. Validieren Sie den Inhalt des Instance-Identitätsdokuments.

   ```bash
   PS C:\> [Linq.Enumerable]::SequenceEqual(${{SignatureDocument}}.ContentInfo.Content, {{$Document}})
   ```

   Wenn der Inhalt des Identitätsdokuments der Instance gültig ist, gibt der Befehl `True` zurück. Wenn das Instance-Identitätsdokument nicht validiert werden kann, wenden Sie sich an AWS Support.

## Option 2: Verwendung der Base64-kodierten Signatur zur Verifizierung des Instance-Identitätsdokuments
<a name="verify-signature"></a>

In diesem Thema wird erklärt, wie das Instanzidentitätsdokument mithilfe der Base64-kodierten Signatur und des öffentlichen RSA-Zertifikats AWS überprüft wird.

### Linux-Instances
<a name="verify-signature-linux"></a>

**Um das Instanzidentitätsdokument mithilfe der Base64-kodierten Signatur und der AWS Öffentliches RSA-Zertifikat**

1. Stellen Sie eine Verbindung zur Instance her.

1. Rufen Sie die base64-kodierte Signatur aus den Metadaten der Instance ab, konvertieren Sie sie in ein Binärformat und fügen Sie sie zu einer Datei namens `signature` hinzu. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```bash
   $ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
   	&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/signature | base64 -d >> {{signature}}
   ```

------
#### [ IMDSv1 ]

   ```bash
   $ curl -s http://169.254.169.254/latest/dynamic/instance-identity/signature | base64 -d >> {{signature}}
   ```

------

1. Rufen Sie die Klartext-Instance-Identitätsdokument aus den Metadaten der Instance ab und fügen Sie sie zu einer Datei mit dem Namen `document` hinzu. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```bash
   $ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
   	&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/document >> {{document}}
   ```

------
#### [ IMDSv1 ]

   ```bash
   $ curl -s http://169.254.169.254/latest/dynamic/instance-identity/document >> {{document}}
   ```

------

1. Suchen Sie das öffentliche **RSA**-Zertifikat für Ihre Region in [AWS öffentliche Zertifikate, zum Beispiel Signaturen von Ausweisdokumenten](regions-certs.md) und fügen Sie den Inhalt in eine neue Datei mit dem Namen `certificate` ein.

1. Extrahieren Sie den öffentlichen Schlüssel aus dem öffentlichen AWS RSA-Zertifikat und speichern Sie ihn in einer Datei mit dem Namen. `key`

   ```bash
   $ openssl x509 -pubkey -noout -in {{certificate}} >> {{key}}
   ```

1. Verwenden Sie den Befehl **OpenSSL dgst**, um die Instance-Identitätsdokument zu überprüfen.

   ```bash
   $ openssl dgst -sha256 -verify {{key}} -signature {{signature}} {{document}}
   ```

   Wenn die Signatur gültig ist, wird die Meldung `Verification successful` angezeigt.

   Der Befehl schreibt außerdem den Inhalt des Instance-Identitätsdokuments in eine neue Datei namens `document`. Mit den folgenden Befehlen können Sie den Inhalt des Instance-Identitätsdokuments aus den Instance-Metadaten mit dem Inhalt dieser Datei vergleichen.

   ```bash
   $ openssl dgst -sha256 < {{document}}
   ```

   ```bash
   $ curl -s -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/document | openssl dgst -sha256
   ```

    Wenn die Signatur nicht verifiziert werden kann, wenden Sie sich an Support.

### Windows-Instances
<a name="verify-signature-windows"></a>

**Um das Instanzidentitätsdokument mithilfe der Base64-kodierten Signatur und der AWS Öffentliches RSA-Zertifikat**

1. Stellen Sie eine Verbindung zur Instance her.

1. Rufen Sie die base64-kodierte Signatur aus den Metadaten der Instance ab, konvertieren Sie sie in ein Byte-Array und fügen Sie sie der Variablen mit dem Namen `$Signature` hinzu. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```PowerShell
   PS C:\> [string]$token = (Invoke-WebRequest -Method Put -Headers @{'X-aws-ec2-metadata-token-ttl-seconds' = '21600'} http://169.254.169.254/latest/api/token).Content
   ```

   ```PowerShell
   PS C:\> {{$Signature}} = [Convert]::FromBase64String((Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $Token} http://169.254.169.254/latest/dynamic/instance-identity/signature).Content)
   ```

------
#### [ IMDSv1 ]

   ```PowerShell
   PS C:\> {{$Signature}} = [Convert]::FromBase64String((Invoke-WebRequest http://169.254.169.254/latest/dynamic/instance-identity/signature).Content)
   ```

------

1. Rufen Sie das Klartext-Identitätsdokument der Instance aus den Instance-Metadaten ab, konvertieren Sie es in ein Byte-Array und fügen Sie es zu einer Variablen namens `$Document` hinzu. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```PowerShell
   PS C:\> {{$Document }}= [Text.Encoding]::UTF8.GetBytes((Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $Token} http://169.254.169.254/latest/dynamic/instance-identity/document).Content)
   ```

------
#### [ IMDSv1 ]

   ```PowerShell
   PS C:\> {{$Document}} =  [Text.Encoding]::UTF8.GetBytes((Invoke-WebRequest http://169.254.169.254/latest/dynamic/instance-identity/document).Content)
   ```

------

1. Suchen Sie das öffentliche **RSA**-Zertifikat für Ihre Region in [AWS öffentliche Zertifikate, zum Beispiel Signaturen von Ausweisdokumenten](regions-certs.md) und fügen Sie den Inhalt in eine neue Datei mit dem Namen `certificate.pem` ein.

1. Überprüfen Sie das Instance-Identitätsdokument.

   ```bash
   PS C:\> [Security.Cryptography.X509Certificates.X509Certificate2]::new((Resolve-Path {{certificate.pem}})).PublicKey.Key.VerifyData({{$Document}}, 'SHA256', {{$Signature}})
   ```

   Wenn die Signatur gültig ist, gibt der Befehl `True` zurück. Wenn die Signatur nicht verifiziert werden kann, wenden Sie sich an Support.

## Option 3: Überprüfen Sie das Identitätsdokument der Instanz anhand der Signatur RSA-2048
<a name="verify-rsa2048"></a>

In diesem Thema wird erklärt, wie das Instanzidentitätsdokument mithilfe der RSA-2048 Signatur und des AWS RSA-2048 öffentlichen Zertifikats verifiziert wird.

### Linux-Instances
<a name="verify-rsa2048-linux"></a>

**Um das Instanz-Identitätsdokument anhand der RSA-2048 Signatur und der AWS RSA-2048 öffentliches Zertifikat**

1. Stellen Sie eine Verbindung zur Instance her.

1. Rufen Sie die RSA-2048 Signatur aus den Instanzmetadaten ab und fügen Sie sie einer Datei hinzu, die nach `rsa2048` der erforderlichen Kopf- und Fußzeile benannt ist. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```bash
   $ echo "-----BEGIN PKCS7-----" >> {{rsa2048}} \
   	&& TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
   	&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/rsa2048 >> {{rsa2048}} \
   	&& echo "" >> {{rsa2048}} \
   	&& echo "-----END PKCS7-----" >> {{rsa2048}}
   ```

------
#### [ IMDSv1 ]

   ```bash
   $ echo "-----BEGIN PKCS7-----" >> {{rsa2048}} \
   	&& curl -s http://169.254.169.254/latest/dynamic/instance-identity/rsa2048 >> {{rsa2048}} \
   	&& echo "" >> {{rsa2048}} \
   	&& echo "-----END PKCS7-----" >> {{rsa2048}}
   ```

------

1. Suchen Sie das ** RSA-2048 ** öffentliche Zertifikat für Ihre Region in [AWS öffentliche Zertifikate, zum Beispiel Signaturen von Ausweisdokumenten](regions-certs.md) und fügen Sie den Inhalt einer neuen Datei mit dem Namen `certificate` hinzu.

1. Verwenden Sie den Befehl **OpenSSL smime**, um die Signatur zu überprüfen. Fügen Sie die Option `-verify` ein, um anzugeben, dass die Signatur verifiziert werden muss, und die Option `-noverify`, um anzugeben, dass das Zertifikat nicht verifiziert werden muss.

   ```bash
   $ openssl smime -verify -in {{rsa2048}} -inform PEM -certfile {{certificate}} -noverify | tee document
   ```

   Wenn die Signatur gültig ist, wird die Meldung `Verification successful` angezeigt. Wenn die Signatur nicht verifiziert werden kann, wenden Sie sich an Support.

### Windows-Instances
<a name="verify-rsa2048-windows"></a>

**Voraussetzungen**  
Dieses Verfahren erfordert die `System.Security` Microsoft .NET Core-Klasse. Führen Sie den folgenden Befehl aus, um die Klasse zu Ihrer PowerShell Sitzung hinzuzufügen.

```PowerShell
PS C:\> Add-Type -AssemblyName System.Security
```

**Anmerkung**  
Der Befehl fügt die Klasse nur der aktuellen PowerShell Sitzung hinzu. Wenn Sie eine neue Sitzung starten, müssen Sie den Befehl erneut ausführen.

**Um das Instanzidentitätsdokument anhand der RSA-2048 Signatur und der AWS RSA-2048 öffentliches Zertifikat**

1. Stellen Sie eine Verbindung zur Instance her.

1. Ruft die RSA-2048 Signatur aus den Instanzmetadaten ab, konvertiert sie in ein Byte-Array und fügt sie einer Variablen mit dem Namen hinzu`$Signature`. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```PowerShell
   PS C:\> [string]$token = (Invoke-WebRequest -Method Put -Headers @{'X-aws-ec2-metadata-token-ttl-seconds' = '21600'} http://169.254.169.254/latest/api/token).Content
   ```

   ```PowerShell
   PS C:\> {{$Signature}} = [Convert]::FromBase64String((Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $Token} http://169.254.169.254/latest/dynamic/instance-identity/rsa2048).Content)
   ```

------
#### [ IMDSv1 ]

   ```PowerShell
   PS C:\> {{$Signature}} = [Convert]::FromBase64String((Invoke-WebRequest http://169.254.169.254/latest/dynamic/instance-identity/rsa2048).Content)
   ```

------

1. Rufen Sie das Klartext-Identitätsdokument der Instance aus den Instance-Metadaten ab, konvertieren Sie es in ein Byte-Array und fügen Sie es zu einer Variablen namens `$Document` hinzu. Verwenden Sie je nach der von der Instance verwendeten IMDS-Version einen der folgenden Befehle.

------
#### [ IMDSv2 ]

   ```PowerShell
   PS C:\> {{$Document }}= [Text.Encoding]::UTF8.GetBytes((Invoke-WebRequest -Headers @{'X-aws-ec2-metadata-token' = $Token} http://169.254.169.254/latest/dynamic/instance-identity/document).Content)
   ```

------
#### [ IMDSv1 ]

   ```PowerShell
   PS C:\> {{$Document}} =  [Text.Encoding]::UTF8.GetBytes((Invoke-WebRequest http://169.254.169.254/latest/dynamic/instance-identity/document).Content)
   ```

------

1. Suchen Sie das ** RSA-2048 ** öffentliche Zertifikat für Ihre Region in [AWS öffentliche Zertifikate, zum Beispiel Signaturen von Ausweisdokumenten](regions-certs.md) und fügen Sie den Inhalt einer neuen Datei mit dem Namen hinzu`certificate.pem`.

1. Extrahieren Sie das Zertifikat aus der Zertifikatsdatei und speichern Sie es in einer Variablen mit dem Namen `$Store`.

   ```bash
   PS C:\> {{$Store}} = [Security.Cryptography.X509Certificates.X509Certificate2Collection]::new([Security.Cryptography.X509Certificates.X509Certificate2]::new((Resolve-Path {{certificate.pem}})))
   ```

1. Überprüfen Sie die Signatur.

   ```bash
   PS C:\> {{$SignatureDocument}} = [Security.Cryptography.Pkcs.SignedCms]::new()
   ```

   ```bash
   PS C:\> {{$SignatureDocument}}.Decode({{$Signature}})
   ```

   ```bash
   PS C:\> {{$SignatureDocument}}.CheckSignature({{$Store}}, $true)
   ```

   Wenn die Signatur gültig ist, gibt der Befehl keine Ausgabe zurück. Wenn die Signatur nicht verifiziert werden kann, gibt der Befehl zurüc `Exception calling "CheckSignature" with "2" argument(s): "Cannot find the original signer`. Wenn Ihre Signatur nicht verifiziert werden kann, wenden Sie sich an AWS Support.

1. Validieren Sie den Inhalt des Instance-Identitätsdokuments.

   ```bash
   PS C:\> [Linq.Enumerable]::SequenceEqual(${{SignatureDocument}}.ContentInfo.Content, {{$Document}})
   ```

   Wenn der Inhalt des Identitätsdokuments der Instance gültig ist, gibt der Befehl `True` zurück. Wenn das Instance-Identitätsdokument nicht validiert werden kann, wenden Sie sich an AWS Support.