AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Interface for accessing Signer

AWS Signer is a fully managed code-signing service to help you ensure the trust and integrity of your code.

Signer supports the following applications:

With code signing for AWS Lambda, you can sign AWS Lambda deployment packages. Integrated support is provided for Amazon S3, Amazon CloudWatch, and AWS CloudTrail. In order to sign code, you create a signing profile and then use Signer to sign Lambda zip files in S3.

With code signing for IoT, you can sign code for any IoT device that is supported by AWS. IoT code signing is available for Amazon FreeRTOS and AWS IoT Device Management, and is integrated with AWS Certificate Manager (ACM). In order to sign code, you import a third-party code-signing certificate using ACM, and use that to sign updates in Amazon FreeRTOS and AWS IoT Device Management.

With Signer and the Notation CLI from the Notary
 Project, you can sign container images stored in a container registry such as Amazon Elastic Container Registry (ECR). The signatures are stored in the registry alongside the images, where they are available for verifying image authenticity and integrity.

For more information about Signer, see the AWS Signer Developer Guide.

Inheritance Hierarchy

Amazon.Signer.IAmazonSigner

Namespace: Amazon.Signer
Assembly: AWSSDK.Signer.dll
Version: 3.x.y.z

Syntax

C#
public interface IAmazonSigner
         IAmazonService, IDisposable

The IAmazonSigner type exposes the following members

Properties

NameTypeDescription
Public Property Paginators Amazon.Signer.Model.ISignerPaginatorFactory

Paginators for the service

Methods

Note:

Asynchronous operations (methods ending with Async) in the table below are for .NET 4.5 or higher. For .NET 3.5 the SDK follows the standard naming convention of BeginMethodName and EndMethodName to indicate asynchronous operations - these method pairs are not shown in the table below.

NameDescription
Public Method AddProfilePermission(AddProfilePermissionRequest)

Adds cross-account permissions to a signing profile.

Public Method AddProfilePermissionAsync(AddProfilePermissionRequest, CancellationToken)

Adds cross-account permissions to a signing profile.

Public Method CancelSigningProfile(CancelSigningProfileRequest)

Changes the state of an ACTIVE signing profile to CANCELED. A canceled profile is still viewable with the ListSigningProfiles operation, but it cannot perform new signing jobs, and is deleted two years after cancelation.

Public Method CancelSigningProfileAsync(CancelSigningProfileRequest, CancellationToken)

Changes the state of an ACTIVE signing profile to CANCELED. A canceled profile is still viewable with the ListSigningProfiles operation, but it cannot perform new signing jobs, and is deleted two years after cancelation.

Public Method DescribeSigningJob(DescribeSigningJobRequest)

Returns information about a specific code signing job. You specify the job by using the jobId value that is returned by the StartSigningJob operation.

Public Method DescribeSigningJobAsync(DescribeSigningJobRequest, CancellationToken)

Returns information about a specific code signing job. You specify the job by using the jobId value that is returned by the StartSigningJob operation.

Public Method DetermineServiceOperationEndpoint(AmazonWebServiceRequest)

Returns the endpoint that will be used for a particular request.

Public Method GetRevocationStatus(GetRevocationStatusRequest)

Retrieves the revocation status of one or more of the signing profile, signing job, and signing certificate.

Public Method GetRevocationStatusAsync(GetRevocationStatusRequest, CancellationToken)

Retrieves the revocation status of one or more of the signing profile, signing job, and signing certificate.

Public Method GetSigningPlatform(GetSigningPlatformRequest)

Returns information on a specific signing platform.

Public Method GetSigningPlatformAsync(GetSigningPlatformRequest, CancellationToken)

Returns information on a specific signing platform.

Public Method GetSigningProfile(GetSigningProfileRequest)

Returns information on a specific signing profile.

Public Method GetSigningProfileAsync(GetSigningProfileRequest, CancellationToken)

Returns information on a specific signing profile.

Public Method ListProfilePermissions(ListProfilePermissionsRequest)

Lists the cross-account permissions associated with a signing profile.

Public Method ListProfilePermissionsAsync(ListProfilePermissionsRequest, CancellationToken)

Lists the cross-account permissions associated with a signing profile.

Public Method ListSigningJobs(ListSigningJobsRequest)

Lists all your signing jobs. You can use the maxResults parameter to limit the number of signing jobs that are returned in the response. If additional jobs remain to be listed, AWS Signer returns a nextToken value. Use this value in subsequent calls to ListSigningJobs to fetch the remaining values. You can continue calling ListSigningJobs with your maxResults parameter and with new values that Signer returns in the nextToken parameter until all of your signing jobs have been returned.

Public Method ListSigningJobsAsync(ListSigningJobsRequest, CancellationToken)

Lists all your signing jobs. You can use the maxResults parameter to limit the number of signing jobs that are returned in the response. If additional jobs remain to be listed, AWS Signer returns a nextToken value. Use this value in subsequent calls to ListSigningJobs to fetch the remaining values. You can continue calling ListSigningJobs with your maxResults parameter and with new values that Signer returns in the nextToken parameter until all of your signing jobs have been returned.

Public Method ListSigningPlatforms(ListSigningPlatformsRequest)

Lists all signing platforms available in AWS Signer that match the request parameters. If additional jobs remain to be listed, Signer returns a nextToken value. Use this value in subsequent calls to ListSigningJobs to fetch the remaining values. You can continue calling ListSigningJobs with your maxResults parameter and with new values that Signer returns in the nextToken parameter until all of your signing jobs have been returned.

Public Method ListSigningPlatformsAsync(ListSigningPlatformsRequest, CancellationToken)

Lists all signing platforms available in AWS Signer that match the request parameters. If additional jobs remain to be listed, Signer returns a nextToken value. Use this value in subsequent calls to ListSigningJobs to fetch the remaining values. You can continue calling ListSigningJobs with your maxResults parameter and with new values that Signer returns in the nextToken parameter until all of your signing jobs have been returned.

Public Method ListSigningProfiles(ListSigningProfilesRequest)

Lists all available signing profiles in your AWS account. Returns only profiles with an ACTIVE status unless the includeCanceled request field is set to true. If additional jobs remain to be listed, AWS Signer returns a nextToken value. Use this value in subsequent calls to ListSigningJobs to fetch the remaining values. You can continue calling ListSigningJobs with your maxResults parameter and with new values that Signer returns in the nextToken parameter until all of your signing jobs have been returned.

Public Method ListSigningProfilesAsync(ListSigningProfilesRequest, CancellationToken)

Lists all available signing profiles in your AWS account. Returns only profiles with an ACTIVE status unless the includeCanceled request field is set to true. If additional jobs remain to be listed, AWS Signer returns a nextToken value. Use this value in subsequent calls to ListSigningJobs to fetch the remaining values. You can continue calling ListSigningJobs with your maxResults parameter and with new values that Signer returns in the nextToken parameter until all of your signing jobs have been returned.

Public Method ListTagsForResource(ListTagsForResourceRequest)

Returns a list of the tags associated with a signing profile resource.

Public Method ListTagsForResourceAsync(ListTagsForResourceRequest, CancellationToken)

Returns a list of the tags associated with a signing profile resource.

Public Method PutSigningProfile(PutSigningProfileRequest)

Creates a signing profile. A signing profile is a code-signing template that can be used to carry out a pre-defined signing job.

Public Method PutSigningProfileAsync(PutSigningProfileRequest, CancellationToken)

Creates a signing profile. A signing profile is a code-signing template that can be used to carry out a pre-defined signing job.

Public Method RemoveProfilePermission(RemoveProfilePermissionRequest)

Removes cross-account permissions from a signing profile.

Public Method RemoveProfilePermissionAsync(RemoveProfilePermissionRequest, CancellationToken)

Removes cross-account permissions from a signing profile.

Public Method RevokeSignature(RevokeSignatureRequest)

Changes the state of a signing job to REVOKED. This indicates that the signature is no longer valid.

Public Method RevokeSignatureAsync(RevokeSignatureRequest, CancellationToken)

Changes the state of a signing job to REVOKED. This indicates that the signature is no longer valid.

Public Method RevokeSigningProfile(RevokeSigningProfileRequest)

Changes the state of a signing profile to REVOKED. This indicates that signatures generated using the signing profile after an effective start date are no longer valid.

Public Method RevokeSigningProfileAsync(RevokeSigningProfileRequest, CancellationToken)

Changes the state of a signing profile to REVOKED. This indicates that signatures generated using the signing profile after an effective start date are no longer valid.

Public Method SignPayload(SignPayloadRequest)

Signs a binary payload and returns a signature envelope.

Public Method SignPayloadAsync(SignPayloadRequest, CancellationToken)

Signs a binary payload and returns a signature envelope.

Public Method StartSigningJob(StartSigningJobRequest)

Initiates a signing job to be performed on the code provided. Signing jobs are viewable by the ListSigningJobs operation for two years after they are performed. Note the following requirements:

  • You must create an Amazon S3 source bucket. For more information, see Creating a Bucket in the Amazon S3 Getting Started Guide.

  • Your S3 source bucket must be version enabled.

  • You must create an S3 destination bucket. AWS Signer uses your S3 destination bucket to write your signed code.

  • You specify the name of the source and destination buckets when calling the StartSigningJob operation.

  • You must ensure the S3 buckets are from the same Region as the signing profile. Cross-Region signing isn't supported.

  • You must also specify a request token that identifies your request to Signer.

You can call the DescribeSigningJob and the ListSigningJobs actions after you call StartSigningJob.

For a Java example that shows how to use this action, see StartSigningJob.

Public Method StartSigningJobAsync(StartSigningJobRequest, CancellationToken)

Initiates a signing job to be performed on the code provided. Signing jobs are viewable by the ListSigningJobs operation for two years after they are performed. Note the following requirements:

  • You must create an Amazon S3 source bucket. For more information, see Creating a Bucket in the Amazon S3 Getting Started Guide.

  • Your S3 source bucket must be version enabled.

  • You must create an S3 destination bucket. AWS Signer uses your S3 destination bucket to write your signed code.

  • You specify the name of the source and destination buckets when calling the StartSigningJob operation.

  • You must ensure the S3 buckets are from the same Region as the signing profile. Cross-Region signing isn't supported.

  • You must also specify a request token that identifies your request to Signer.

You can call the DescribeSigningJob and the ListSigningJobs actions after you call StartSigningJob.

For a Java example that shows how to use this action, see StartSigningJob.

Public Method TagResource(TagResourceRequest)

Adds one or more tags to a signing profile. Tags are labels that you can use to identify and organize your AWS resources. Each tag consists of a key and an optional value. To specify the signing profile, use its Amazon Resource Name (ARN). To specify the tag, use a key-value pair.

Public Method TagResourceAsync(TagResourceRequest, CancellationToken)

Adds one or more tags to a signing profile. Tags are labels that you can use to identify and organize your AWS resources. Each tag consists of a key and an optional value. To specify the signing profile, use its Amazon Resource Name (ARN). To specify the tag, use a key-value pair.

Public Method UntagResource(UntagResourceRequest)

Removes one or more tags from a signing profile. To remove the tags, specify a list of tag keys.

Public Method UntagResourceAsync(UntagResourceRequest, CancellationToken)

Removes one or more tags from a signing profile. To remove the tags, specify a list of tag keys.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer, 3.5