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.
# Beispiele für Unterzeichner mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Signer Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `cancel-signing-profile`
Das folgende Codebeispiel zeigt, wie Sie`cancel-signing-profile`.
**AWS CLI**
**So löschen ein Signaturprofil**
Im folgenden `cancel-signing-profile` Beispiel wird ein vorhandenes Signaturprofil aus AWS Signer entfernt.
```
aws signer cancel-signing-profile \
--profile-name MyProfile1
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie unter [CancelSigningProfile AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/cancel-signing-profile.html)*Befehlsreferenz.*
### `describe-signing-job`
Das folgende Codebeispiel zeigt die Verwendung`describe-signing-job`.
**AWS CLI**
**So zeigen Sie Details zu einem Signaturauftrag an**
Im folgenden Beispiel für `describe-signing-job` werden die Details für den angegebenen Signaturauftrag angezeigt.
```
aws signer describe-signing-job \
--job-id 2065c468-73e2-4385-a6c9-0123456789abc
```
Ausgabe:
```
{
"status": "Succeeded",
"completedAt": 1568412037,
"platformId": "AmazonFreeRTOS-Default",
"signingMaterial": {
"certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
},
"statusReason": "Signing Succeeded",
"jobId": "2065c468-73e2-4385-a6c9-0123456789abc",
"source": {
"s3": {
"version": "PNyFaUTgsQh5ZdMCcoCe6pT1gOpgB_M4",
"bucketName": "signer-source",
"key": "MyCode.rb"
}
},
"profileName": "MyProfile2",
"signedObject": {
"s3": {
"bucketName": "signer-destination",
"key": "signed-2065c468-73e2-4385-a6c9-0123456789abc"
}
},
"requestedBy": "arn:aws:iam::123456789012:user/maria",
"createdAt": 1568412036
}
```
+ Einzelheiten zur API finden Sie [DescribeSigningJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/describe-signing-job.html)in der *AWS CLI Befehlsreferenz*.
### `get-signing-platform`
Das folgende Codebeispiel zeigt die Verwendung`get-signing-platform`.
**AWS CLI**
**So zeigen Sie Details zu einer Signaturplattform an**
Im folgenden Beispiel für `get-signing-platform` werden die Details für die angegebene Signaturplattform angezeigt.
```
aws signer get-signing-platform \
--platform-id AmazonFreeRTOS-TI-CC3220SF
```
Ausgabe:
```
{
"category": "AWS",
"displayName": "Amazon FreeRTOS SHA1-RSA CC3220SF-Format",
"target": "SHA1-RSA-TISHA1",
"platformId": "AmazonFreeRTOS-TI-CC3220SF",
"signingConfiguration": {
"encryptionAlgorithmOptions": {
"defaultValue": "RSA",
"allowedValues": [
"RSA"
]
},
"hashAlgorithmOptions": {
"defaultValue": "SHA1",
"allowedValues": [
"SHA1"
]
}
},
"maxSizeInMB": 16,
"partner": "AmazonFreeRTOS",
"signingImageFormat": {
"defaultFormat": "JSONEmbedded",
"supportedFormats": [
"JSONEmbedded"
]
}
}
```
+ Einzelheiten zur API finden Sie [GetSigningPlatform](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/get-signing-platform.html)in der *AWS CLI Befehlsreferenz*.
### `get-signing-profile`
Das folgende Codebeispiel zeigt die Verwendung`get-signing-profile`.
**AWS CLI**
**So zeigen Sie Details zu einem Signaturprofil an**
Im folgenden Beispiel für `get-signing-profile` werden die Details für das angegebene Signaturprofil angezeigt.
```
aws signer get-signing-profile \
--profile-name MyProfile3
```
Ausgabe:
```
{
"platformId": "AmazonFreeRTOS-TI-CC3220SF",
"profileName": "MyProfile3",
"status": "Active",
"signingMaterial": {
"certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
}
}
```
+ Einzelheiten zur API finden Sie [GetSigningProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/get-signing-profile.html)in der *AWS CLI Befehlsreferenz*.
### `list-signing-jobs`
Das folgende Codebeispiel zeigt die Verwendung`list-signing-jobs`.
**AWS CLI**
**So listen Sie alle Signaturaufträge auf**
Im folgenden Beispiel für `list-signing-jobs` werden Details zu allen Signaturaufträgen für das Konto angezeigt.
```
aws signer list-signing-jobs
```
In diesem Beispiel werden zwei Aufträge zurückgegeben, einer erfolgreich und einer fehlgeschlagen.
```
{
"jobs": [
{
"status": "Succeeded",
"signingMaterial": {
"certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
},
"jobId": "2065c468-73e2-4385-a6c9-0123456789abc",
"source": {
"s3": {
"version": "PNyFaUTgsQh5ZdMCcoCe6pT1gOpgB_M4",
"bucketName": "signer-source",
"key": "MyCode.rb"
}
},
"signedObject": {
"s3": {
"bucketName": "signer-destination",
"key": "signed-2065c468-73e2-4385-a6c9-0123456789abc"
}
},
"createdAt": 1568412036
},
{
"status": "Failed",
"source": {
"s3": {
"version": "PNyFaUTgsQh5ZdMCcoCe6pT1gOpgB_M4",
"bucketName": "signer-source",
"key": "MyOtherCode.rb"
}
},
"signingMaterial": {
"certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
},
"createdAt": 1568402690,
"jobId": "74d9825e-22fc-4a0d-b962-0123456789abc"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListSigningJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-jobs.html)in der *AWS CLI Befehlsreferenz*.
### `list-signing-platforms`
Das folgende Codebeispiel zeigt die Verwendung`list-signing-platforms`.
**AWS CLI**
**So listen Sie alle Signierungsplattformen auf**
Im folgenden Beispiel für `list-signing-platforms` werden Details zu allen verfügbaren Signaturplattformen angezeigt.
```
aws signer list-signing-platforms
```
Ausgabe:
```
{
"platforms": [
{
"category": "AWS",
"displayName": "AWS IoT Device Management SHA256-ECDSA ",
"target": "SHA256-ECDSA",
"platformId": "AWSIoTDeviceManagement-SHA256-ECDSA",
"signingConfiguration": {
"encryptionAlgorithmOptions": {
"defaultValue": "ECDSA",
"allowedValues": [
"ECDSA"
]
},
"hashAlgorithmOptions": {
"defaultValue": "SHA256",
"allowedValues": [
"SHA256"
]
}
},
"maxSizeInMB": 2048,
"partner": "AWSIoTDeviceManagement",
"signingImageFormat": {
"defaultFormat": "JSONDetached",
"supportedFormats": [
"JSONDetached"
]
}
},
{
"category": "AWS",
"displayName": "Amazon FreeRTOS SHA1-RSA CC3220SF-Format",
"target": "SHA1-RSA-TISHA1",
"platformId": "AmazonFreeRTOS-TI-CC3220SF",
"signingConfiguration": {
"encryptionAlgorithmOptions": {
"defaultValue": "RSA",
"allowedValues": [
"RSA"
]
},
"hashAlgorithmOptions": {
"defaultValue": "SHA1",
"allowedValues": [
"SHA1"
]
}
},
"maxSizeInMB": 16,
"partner": "AmazonFreeRTOS",
"signingImageFormat": {
"defaultFormat": "JSONEmbedded",
"supportedFormats": [
"JSONEmbedded"
]
}
},
{
"category": "AWS",
"displayName": "Amazon FreeRTOS SHA256-ECDSA",
"target": "SHA256-ECDSA",
"platformId": "AmazonFreeRTOS-Default",
"signingConfiguration": {
"encryptionAlgorithmOptions": {
"defaultValue": "ECDSA",
"allowedValues": [
"ECDSA"
]
},
"hashAlgorithmOptions": {
"defaultValue": "SHA256",
"allowedValues": [
"SHA256"
]
}
},
"maxSizeInMB": 16,
"partner": "AmazonFreeRTOS",
"signingImageFormat": {
"defaultFormat": "JSONEmbedded",
"supportedFormats": [
"JSONEmbedded"
]
}
}
]
}
```
+ Einzelheiten zur API finden Sie [ListSigningPlatforms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-platforms.html)in der *AWS CLI Befehlsreferenz*.
### `list-signing-profiles`
Das folgende Codebeispiel zeigt die Verwendung`list-signing-profiles`.
**AWS CLI**
**So listen Sie alle Signaturprofile auf**
Im folgenden Beispiel für `list-signing-profiles` werden Details zu allen Signaturprofilen für das Konto angezeigt.
```
aws signer list-signing-profiles
```
Ausgabe:
```
{
"profiles": [
{
"platformId": "AmazonFreeRTOS-TI-CC3220SF",
"profileName": "MyProfile4",
"status": "Active",
"signingMaterial": {
"certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
}
},
{
"platformId": "AWSIoTDeviceManagement-SHA256-ECDSA",
"profileName": "MyProfile5",
"status": "Active",
"signingMaterial": {
"certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [ListSigningProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-profiles.html)in der *AWS CLI Befehlsreferenz*.
### `put-signing-profile`
Das folgende Codebeispiel zeigt die Verwendung`put-signing-profile`.
**AWS CLI**
**So erstellen Sie ein Signaturprofil**
Im folgenden Beispiel für `put-signing-profile` wird ein Signaturprofil unter Verwendung des angegebenen Zertifikats und der angegebenen Plattform erstellt.
```
aws signer put-signing-profile \
--profile-name MyProfile6 \
--signing-material certificateArn=arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc \
--platform AmazonFreeRTOS-TI-CC3220SF
```
Ausgabe:
```
{
"arn": "arn:aws:signer:us-west-2:123456789012:/signing-profiles/MyProfile6"
}
```
+ Einzelheiten zur API finden Sie [PutSigningProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/put-signing-profile.html)in der *AWS CLI Befehlsreferenz*.
### `start-signing-job`
Das folgende Codebeispiel zeigt die Verwendung`start-signing-job`.
**AWS CLI**
**So starten Sie einen Signaturauftrag**
Im folgenden Beispiel für `start-signing-job` wird ein Signaturauftrag für den Code gestartet, der in der angegebenen Quelle aufgefunden wurde. Dabei wird das angegebene Profil für die Signatur verwendet und der signierte Code wird im angegebenen Ziel platziert.
```
aws signer start-signing-job \
--source 's3={bucketName=signer-source,key=MyCode.rb,version=PNyFaUTgsQh5ZdMCcoCe6pT1gOpgB_M4}' \
--destination 's3={bucketName=signer-destination,prefix=signed-}' \
--profile-name MyProfile7
```
Die Ausgabe ist die ID des signierenden Auftrags.
```
{
"jobId": "2065c468-73e2-4385-a6c9-0123456789abc"
}
```
+ Einzelheiten zur API finden Sie [StartSigningJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/start-signing-job.html)in der *AWS CLI Befehlsreferenz*.