Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Contoh penandatangan menggunakan AWS CLI
Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface With Signer.
*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.
Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.
**Topics**
+ [Tindakan](#actions)
## Tindakan
### `cancel-signing-profile`
Contoh kode berikut menunjukkan cara menggunakan`cancel-signing-profile`.
**AWS CLI**
**Untuk menghapus profil penandatanganan**
`cancel-signing-profile`Contoh berikut menghapus profil penandatanganan yang ada dari AWS Penandatangan.
```
aws signer cancel-signing-profile \
--profile-name MyProfile1
```
Perintah ini tidak menghasilkan output.
+ Untuk detail API, lihat [CancelSigningProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/cancel-signing-profile.html)di *Referensi AWS CLI Perintah*.
### `describe-signing-job`
Contoh kode berikut menunjukkan cara menggunakan`describe-signing-job`.
**AWS CLI**
**Untuk menampilkan detail tentang pekerjaan penandatanganan**
`describe-signing-job`Contoh berikut menampilkan rincian tentang pekerjaan penandatanganan yang ditentukan.
```
aws signer describe-signing-job \
--job-id 2065c468-73e2-4385-a6c9-0123456789abc
```
Output:
```
{
"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
}
```
+ Untuk detail API, lihat [DescribeSigningJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/describe-signing-job.html)di *Referensi AWS CLI Perintah*.
### `get-signing-platform`
Contoh kode berikut menunjukkan cara menggunakan`get-signing-platform`.
**AWS CLI**
**Untuk menampilkan detail tentang platform penandatanganan**
`get-signing-platform`Contoh berikut menampilkan rincian tentang platform penandatanganan yang ditentukan.
```
aws signer get-signing-platform \
--platform-id AmazonFreeRTOS-TI-CC3220SF
```
Output:
```
{
"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"
]
}
}
```
+ Untuk detail API, lihat [GetSigningPlatform](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/get-signing-platform.html)di *Referensi AWS CLI Perintah*.
### `get-signing-profile`
Contoh kode berikut menunjukkan cara menggunakan`get-signing-profile`.
**AWS CLI**
**Untuk menampilkan detail tentang profil penandatanganan**
`get-signing-profile`Contoh berikut menampilkan rincian tentang profil penandatanganan yang ditentukan.
```
aws signer get-signing-profile \
--profile-name MyProfile3
```
Output:
```
{
"platformId": "AmazonFreeRTOS-TI-CC3220SF",
"profileName": "MyProfile3",
"status": "Active",
"signingMaterial": {
"certificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/6a55389b-306b-4e8c-a95c-0123456789abc"
}
}
```
+ Untuk detail API, lihat [GetSigningProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/get-signing-profile.html)di *Referensi AWS CLI Perintah*.
### `list-signing-jobs`
Contoh kode berikut menunjukkan cara menggunakan`list-signing-jobs`.
**AWS CLI**
**Untuk daftar semua pekerjaan penandatanganan**
`list-signing-jobs`Contoh berikut menampilkan detail tentang semua pekerjaan penandatanganan untuk akun.
```
aws signer list-signing-jobs
```
Dalam contoh ini, dua pekerjaan dikembalikan, satu berhasil, dan satu gagal.
```
{
"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"
}
]
}
```
+ Untuk detail API, lihat [ListSigningJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-jobs.html)di *Referensi AWS CLI Perintah*.
### `list-signing-platforms`
Contoh kode berikut menunjukkan cara menggunakan`list-signing-platforms`.
**AWS CLI**
**Untuk membuat daftar semua platform penandatanganan**
`list-signing-platforms`Contoh berikut menampilkan detail tentang semua platform penandatanganan yang tersedia.
```
aws signer list-signing-platforms
```
Output:
```
{
"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"
]
}
}
]
}
```
+ Untuk detail API, lihat [ListSigningPlatforms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-platforms.html)di *Referensi AWS CLI Perintah*.
### `list-signing-profiles`
Contoh kode berikut menunjukkan cara menggunakan`list-signing-profiles`.
**AWS CLI**
**Untuk membuat daftar semua profil penandatanganan**
`list-signing-profiles`Contoh berikut menampilkan detail tentang semua profil penandatanganan untuk akun.
```
aws signer list-signing-profiles
```
Output:
```
{
"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"
}
}
]
}
```
+ Untuk detail API, lihat [ListSigningProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/list-signing-profiles.html)di *Referensi AWS CLI Perintah*.
### `put-signing-profile`
Contoh kode berikut menunjukkan cara menggunakan`put-signing-profile`.
**AWS CLI**
**Untuk membuat profil penandatanganan**
`put-signing-profile`Contoh berikut membuat profil penandatanganan menggunakan sertifikat dan platform yang ditentukan.
```
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
```
Output:
```
{
"arn": "arn:aws:signer:us-west-2:123456789012:/signing-profiles/MyProfile6"
}
```
+ Untuk detail API, lihat [PutSigningProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/put-signing-profile.html)di *Referensi AWS CLI Perintah*.
### `start-signing-job`
Contoh kode berikut menunjukkan cara menggunakan`start-signing-job`.
**AWS CLI**
**Untuk memulai pekerjaan penandatanganan**
`start-signing-job`Contoh berikut memulai pekerjaan penandatanganan pada kode yang ditemukan di sumber yang ditentukan. Ini menggunakan profil yang ditentukan untuk melakukan penandatanganan dan menempatkan kode yang ditandatangani di tujuan yang ditentukan.
```
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
```
Outputnya adalah ID dari pekerjaan penandatanganan.
```
{
"jobId": "2065c468-73e2-4385-a6c9-0123456789abc"
}
```
+ Untuk detail API, lihat [StartSigningJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/signer/start-signing-job.html)di *Referensi AWS CLI Perintah*.