Skip to content

Commit 4ab1523

Browse files
author
awstools
committed
docs(client-signer): Documentation updates for AWS Signer
1 parent faf048e commit 4ab1523

13 files changed

+171
-144
lines changed

clients/client-signer/README.md

+11-8
Original file line numberDiff line numberDiff line change
@@ -6,20 +6,23 @@
66

77
AWS SDK for JavaScript Signer Client for Node.js, Browser and React Native.
88

9-
<p>AWS Signer is a fully managed code signing service to help you ensure the trust and
9+
<p>AWS Signer is a fully managed code-signing service to help you ensure the trust and
1010
integrity of your code. </p>
11-
<p>AWS Signer supports the following applications:</p>
11+
<p>Signer supports the following applications:</p>
1212
<p>With code signing for AWS Lambda, you can sign <a href="http://docs.aws.amazon.com/lambda/latest/dg/">AWS
1313
Lambda</a> deployment packages. Integrated support is provided for <a href="http://docs.aws.amazon.com/AmazonS3/latest/gsg/">Amazon S3</a>, <a href="http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/">Amazon
1414
CloudWatch</a>, and <a href="http://docs.aws.amazon.com/awscloudtrail/latest/userguide/">AWS CloudTrail</a>. In order
15-
to sign code, you create a signing profile and then use Signer to sign Lambda zip files
16-
in S3. </p>
15+
to sign code, you create a signing profile and then use Signer to sign Lambda zip
16+
files in S3. </p>
1717
<p>With code signing for IoT, you can sign code for any IoT device that is supported by AWS.
18-
IoT code signing is available for <a href="http://docs.aws.amazon.com/freertos/latest/userguide/">Amazon FreeRTOS</a> and <a href="http://docs.aws.amazon.com/iot/latest/developerguide/">AWS IoT Device Management</a>, and is integrated with <a href="http://docs.aws.amazon.com/acm/latest/userguide/">AWS Certificate Manager (ACM)</a>. In order to sign code, you import a third-party code signing
18+
IoT code signing is available for <a href="http://docs.aws.amazon.com/freertos/latest/userguide/">Amazon FreeRTOS</a> and <a href="http://docs.aws.amazon.com/iot/latest/developerguide/">AWS IoT Device Management</a>, and is integrated with <a href="http://docs.aws.amazon.com/acm/latest/userguide/">AWS Certificate Manager (ACM)</a>. In order to sign code, you import a third-party code-signing
1919
certificate using ACM, and use that to sign updates in Amazon FreeRTOS and AWS IoT Device Management. </p>
20-
<p>With code signing for
21-
containers …(TBD)</p>
22-
<p>For more information about AWS Signer, see the <a href="https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer
20+
<p>With Signer and the Notation CLI from the <a href="https://notaryproject.dev/">Notary

21+
Project</a>, you can sign container images stored in a container registry such
22+
as Amazon Elastic Container Registry (ECR). The signatures are stored in the registry
23+
alongside the images, where they are available for verifying image authenticity and
24+
integrity.</p>
25+
<p>For more information about Signer, see the <a href="https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer
2326
Guide</a>.</p>
2427

2528
## Installing

clients/client-signer/src/Signer.ts

+11-8
Original file line numberDiff line numberDiff line change
@@ -413,20 +413,23 @@ export interface Signer {
413413

414414
/**
415415
* @public
416-
* <p>AWS Signer is a fully managed code signing service to help you ensure the trust and
416+
* <p>AWS Signer is a fully managed code-signing service to help you ensure the trust and
417417
* integrity of your code. </p>
418-
* <p>AWS Signer supports the following applications:</p>
418+
* <p>Signer supports the following applications:</p>
419419
* <p>With code signing for AWS Lambda, you can sign <a href="http://docs.aws.amazon.com/lambda/latest/dg/">AWS
420420
* Lambda</a> deployment packages. Integrated support is provided for <a href="http://docs.aws.amazon.com/AmazonS3/latest/gsg/">Amazon S3</a>, <a href="http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/">Amazon
421421
* CloudWatch</a>, and <a href="http://docs.aws.amazon.com/awscloudtrail/latest/userguide/">AWS CloudTrail</a>. In order
422-
* to sign code, you create a signing profile and then use Signer to sign Lambda zip files
423-
* in S3. </p>
422+
* to sign code, you create a signing profile and then use Signer to sign Lambda zip
423+
* files in S3. </p>
424424
* <p>With code signing for IoT, you can sign code for any IoT device that is supported by AWS.
425-
* IoT code signing is available for <a href="http://docs.aws.amazon.com/freertos/latest/userguide/">Amazon FreeRTOS</a> and <a href="http://docs.aws.amazon.com/iot/latest/developerguide/">AWS IoT Device Management</a>, and is integrated with <a href="http://docs.aws.amazon.com/acm/latest/userguide/">AWS Certificate Manager (ACM)</a>. In order to sign code, you import a third-party code signing
425+
* IoT code signing is available for <a href="http://docs.aws.amazon.com/freertos/latest/userguide/">Amazon FreeRTOS</a> and <a href="http://docs.aws.amazon.com/iot/latest/developerguide/">AWS IoT Device Management</a>, and is integrated with <a href="http://docs.aws.amazon.com/acm/latest/userguide/">AWS Certificate Manager (ACM)</a>. In order to sign code, you import a third-party code-signing
426426
* certificate using ACM, and use that to sign updates in Amazon FreeRTOS and AWS IoT Device Management. </p>
427-
* <p>With code signing for
428-
* containers …(TBD)</p>
429-
* <p>For more information about AWS Signer, see the <a href="https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer
427+
* <p>With Signer and the Notation CLI from the <a href="https://notaryproject.dev/">Notary
428+
* Project</a>, you can sign container images stored in a container registry such
429+
* as Amazon Elastic Container Registry (ECR). The signatures are stored in the registry
430+
* alongside the images, where they are available for verifying image authenticity and
431+
* integrity.</p>
432+
* <p>For more information about Signer, see the <a href="https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer
430433
* Guide</a>.</p>
431434
*/
432435
export class Signer extends SignerClient implements Signer {}

clients/client-signer/src/SignerClient.ts

+11-8
Original file line numberDiff line numberDiff line change
@@ -327,20 +327,23 @@ export interface SignerClientResolvedConfig extends SignerClientResolvedConfigTy
327327

328328
/**
329329
* @public
330-
* <p>AWS Signer is a fully managed code signing service to help you ensure the trust and
330+
* <p>AWS Signer is a fully managed code-signing service to help you ensure the trust and
331331
* integrity of your code. </p>
332-
* <p>AWS Signer supports the following applications:</p>
332+
* <p>Signer supports the following applications:</p>
333333
* <p>With code signing for AWS Lambda, you can sign <a href="http://docs.aws.amazon.com/lambda/latest/dg/">AWS
334334
* Lambda</a> deployment packages. Integrated support is provided for <a href="http://docs.aws.amazon.com/AmazonS3/latest/gsg/">Amazon S3</a>, <a href="http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/">Amazon
335335
* CloudWatch</a>, and <a href="http://docs.aws.amazon.com/awscloudtrail/latest/userguide/">AWS CloudTrail</a>. In order
336-
* to sign code, you create a signing profile and then use Signer to sign Lambda zip files
337-
* in S3. </p>
336+
* to sign code, you create a signing profile and then use Signer to sign Lambda zip
337+
* files in S3. </p>
338338
* <p>With code signing for IoT, you can sign code for any IoT device that is supported by AWS.
339-
* IoT code signing is available for <a href="http://docs.aws.amazon.com/freertos/latest/userguide/">Amazon FreeRTOS</a> and <a href="http://docs.aws.amazon.com/iot/latest/developerguide/">AWS IoT Device Management</a>, and is integrated with <a href="http://docs.aws.amazon.com/acm/latest/userguide/">AWS Certificate Manager (ACM)</a>. In order to sign code, you import a third-party code signing
339+
* IoT code signing is available for <a href="http://docs.aws.amazon.com/freertos/latest/userguide/">Amazon FreeRTOS</a> and <a href="http://docs.aws.amazon.com/iot/latest/developerguide/">AWS IoT Device Management</a>, and is integrated with <a href="http://docs.aws.amazon.com/acm/latest/userguide/">AWS Certificate Manager (ACM)</a>. In order to sign code, you import a third-party code-signing
340340
* certificate using ACM, and use that to sign updates in Amazon FreeRTOS and AWS IoT Device Management. </p>
341-
* <p>With code signing for
342-
* containers …(TBD)</p>
343-
* <p>For more information about AWS Signer, see the <a href="https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer
341+
* <p>With Signer and the Notation CLI from the <a href="https://notaryproject.dev/">Notary
342+
* Project</a>, you can sign container images stored in a container registry such
343+
* as Amazon Elastic Container Registry (ECR). The signatures are stored in the registry
344+
* alongside the images, where they are available for verifying image authenticity and
345+
* integrity.</p>
346+
* <p>For more information about Signer, see the <a href="https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer
344347
* Guide</a>.</p>
345348
*/
346349
export class SignerClient extends __Client<

clients/client-signer/src/commands/GetRevocationStatusCommand.ts

+2-3
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,8 @@ export interface GetRevocationStatusCommandOutput extends GetRevocationStatusRes
3737

3838
/**
3939
* @public
40-
* <p>Retrieves the
41-
* revocation status of one or more of the signing profile, signing job, and signing
42-
* certificate.</p>
40+
* <p>Retrieves the revocation status of one or more of the signing profile, signing job,
41+
* and signing certificate.</p>
4342
* @example
4443
* Use a bare-bones client and the command you need to make an API call.
4544
* ```javascript

clients/client-signer/src/commands/ListSigningJobsCommand.ts

+4-4
Original file line numberDiff line numberDiff line change
@@ -37,12 +37,12 @@ export interface ListSigningJobsCommandOutput extends ListSigningJobsResponse, _
3737

3838
/**
3939
* @public
40-
* <p>Lists all your signing jobs. You can use the <code>maxResults</code> parameter to
41-
* limit the number of signing jobs that are returned in the response. If additional jobs
42-
* remain to be listed, code signing returns a <code>nextToken</code> value. Use this value in
40+
* <p>Lists all your signing jobs. You can use the <code>maxResults</code> parameter to limit the
41+
* number of signing jobs that are returned in the response. If additional jobs remain to
42+
* be listed, AWS Signer returns a <code>nextToken</code> value. Use this value in
4343
* subsequent calls to <code>ListSigningJobs</code> to fetch the remaining values. You can
4444
* continue calling <code>ListSigningJobs</code> with your <code>maxResults</code>
45-
* parameter and with new values that code signing returns in the <code>nextToken</code>
45+
* parameter and with new values that Signer returns in the <code>nextToken</code>
4646
* parameter until all of your signing jobs have been returned. </p>
4747
* @example
4848
* Use a bare-bones client and the command you need to make an API call.

clients/client-signer/src/commands/ListSigningPlatformsCommand.ts

+5-5
Original file line numberDiff line numberDiff line change
@@ -37,11 +37,11 @@ export interface ListSigningPlatformsCommandOutput extends ListSigningPlatformsR
3737

3838
/**
3939
* @public
40-
* <p>Lists all signing platforms available in code signing that match the request parameters. If
41-
* additional jobs remain to be listed, code signing returns a <code>nextToken</code> value. Use
42-
* this value in subsequent calls to <code>ListSigningJobs</code> to fetch the remaining
43-
* values. You can continue calling <code>ListSigningJobs</code> with your
44-
* <code>maxResults</code> parameter and with new values that code signing returns in the
40+
* <p>Lists all signing platforms available in AWS Signer that match the request parameters. If
41+
* additional jobs remain to be listed, Signer returns a <code>nextToken</code> value.
42+
* Use this value in subsequent calls to <code>ListSigningJobs</code> to fetch the
43+
* remaining values. You can continue calling <code>ListSigningJobs</code> with your
44+
* <code>maxResults</code> parameter and with new values that Signer returns in the
4545
* <code>nextToken</code> parameter until all of your signing jobs have been
4646
* returned.</p>
4747
* @example

clients/client-signer/src/commands/ListSigningProfilesCommand.ts

+5-5
Original file line numberDiff line numberDiff line change
@@ -37,14 +37,14 @@ export interface ListSigningProfilesCommandOutput extends ListSigningProfilesRes
3737

3838
/**
3939
* @public
40-
* <p>Lists all available signing profiles in your AWS account. Returns only profiles with
41-
* an <code>ACTIVE</code> status unless the <code>includeCanceled</code> request field is
42-
* set to <code>true</code>. If additional jobs remain to be listed, code signing returns a
40+
* <p>Lists all available signing profiles in your AWS account. Returns only profiles with an
41+
* <code>ACTIVE</code> status unless the <code>includeCanceled</code> request field is
42+
* set to <code>true</code>. If additional jobs remain to be listed, AWS Signer returns a
4343
* <code>nextToken</code> value. Use this value in subsequent calls to
4444
* <code>ListSigningJobs</code> to fetch the remaining values. You can continue calling
4545
* <code>ListSigningJobs</code> with your <code>maxResults</code> parameter and with
46-
* new values that code signing returns in the <code>nextToken</code> parameter until all of your
47-
* signing jobs have been returned.</p>
46+
* new values that Signer returns in the <code>nextToken</code> parameter until all of
47+
* your signing jobs have been returned.</p>
4848
* @example
4949
* Use a bare-bones client and the command you need to make an API call.
5050
* ```javascript

clients/client-signer/src/commands/PutSigningProfileCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ export interface PutSigningProfileCommandOutput extends PutSigningProfileRespons
3737

3838
/**
3939
* @public
40-
* <p>Creates a signing profile. A signing profile is a code signing template that can be used to
40+
* <p>Creates a signing profile. A signing profile is a code-signing template that can be used to
4141
* carry out a pre-defined signing job.
4242
* </p>
4343
* @example

clients/client-signer/src/commands/SignPayloadCommand.ts

+1-2
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,7 @@ export interface SignPayloadCommandOutput extends SignPayloadResponse, __Metadat
3737

3838
/**
3939
* @public
40-
* <p>Signs a binary
41-
* payload and returns a signature envelope.</p>
40+
* <p>Signs a binary payload and returns a signature envelope.</p>
4241
* @example
4342
* Use a bare-bones client and the command you need to make an API call.
4443
* ```javascript

clients/client-signer/src/commands/StartSigningJobCommand.ts

+3-4
Original file line numberDiff line numberDiff line change
@@ -49,16 +49,15 @@ export interface StartSigningJobCommandOutput extends StartSigningJobResponse, _
4949
* <p>Your S3 source bucket must be version enabled.</p>
5050
* </li>
5151
* <li>
52-
* <p>You must create an S3 destination bucket. Code signing uses your S3 destination
53-
* bucket to write your signed code.</p>
52+
* <p>You must create an S3 destination bucket. AWS Signer uses your S3 destination bucket to
53+
* write your signed code.</p>
5454
* </li>
5555
* <li>
5656
* <p>You specify the name of the source and destination buckets when calling the
5757
* <code>StartSigningJob</code> operation.</p>
5858
* </li>
5959
* <li>
60-
* <p>You must also specify a request token that identifies your request to
61-
* code signing.</p>
60+
* <p>You must also specify a request token that identifies your request to Signer.</p>
6261
* </li>
6362
* </ul>
6463
* <p>You can call the <a>DescribeSigningJob</a> and the <a>ListSigningJobs</a> actions after you call

clients/client-signer/src/index.ts

+11-8
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,23 @@
11
// smithy-typescript generated code
22
/* eslint-disable */
33
/**
4-
* <p>AWS Signer is a fully managed code signing service to help you ensure the trust and
4+
* <p>AWS Signer is a fully managed code-signing service to help you ensure the trust and
55
* integrity of your code. </p>
6-
* <p>AWS Signer supports the following applications:</p>
6+
* <p>Signer supports the following applications:</p>
77
* <p>With code signing for AWS Lambda, you can sign <a href="http://docs.aws.amazon.com/lambda/latest/dg/">AWS
88
* Lambda</a> deployment packages. Integrated support is provided for <a href="http://docs.aws.amazon.com/AmazonS3/latest/gsg/">Amazon S3</a>, <a href="http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/">Amazon
99
* CloudWatch</a>, and <a href="http://docs.aws.amazon.com/awscloudtrail/latest/userguide/">AWS CloudTrail</a>. In order
10-
* to sign code, you create a signing profile and then use Signer to sign Lambda zip files
11-
* in S3. </p>
10+
* to sign code, you create a signing profile and then use Signer to sign Lambda zip
11+
* files in S3. </p>
1212
* <p>With code signing for IoT, you can sign code for any IoT device that is supported by AWS.
13-
* IoT code signing is available for <a href="http://docs.aws.amazon.com/freertos/latest/userguide/">Amazon FreeRTOS</a> and <a href="http://docs.aws.amazon.com/iot/latest/developerguide/">AWS IoT Device Management</a>, and is integrated with <a href="http://docs.aws.amazon.com/acm/latest/userguide/">AWS Certificate Manager (ACM)</a>. In order to sign code, you import a third-party code signing
13+
* IoT code signing is available for <a href="http://docs.aws.amazon.com/freertos/latest/userguide/">Amazon FreeRTOS</a> and <a href="http://docs.aws.amazon.com/iot/latest/developerguide/">AWS IoT Device Management</a>, and is integrated with <a href="http://docs.aws.amazon.com/acm/latest/userguide/">AWS Certificate Manager (ACM)</a>. In order to sign code, you import a third-party code-signing
1414
* certificate using ACM, and use that to sign updates in Amazon FreeRTOS and AWS IoT Device Management. </p>
15-
* <p>With code signing for
16-
* containers …(TBD)</p>
17-
* <p>For more information about AWS Signer, see the <a href="https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer
15+
* <p>With Signer and the Notation CLI from the <a href="https://notaryproject.dev/">Notary
16+
* Project</a>, you can sign container images stored in a container registry such
17+
* as Amazon Elastic Container Registry (ECR). The signatures are stored in the registry
18+
* alongside the images, where they are available for verifying image authenticity and
19+
* integrity.</p>
20+
* <p>For more information about Signer, see the <a href="https://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer
1821
* Guide</a>.</p>
1922
*
2023
* @packageDocumentation

0 commit comments

Comments
 (0)