Signer
Service object for interacting with AWS Signer service.
public struct Signer: AWSService
AWS Signer is a fully managed code signing service to help you ensure the trust and integrity of your code.
AWS 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.
<p>With <i>code signing for IoT</i>, you can sign code for any IoT device that is
supported by AWS. 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 certificate using ACM, and use that to
sign updates in Amazon FreeRTOS and AWS IoT Device Management. </p>
<p>For more information about AWS Signer, see the <a href="http://docs.aws.amazon.com/signer/latest/developerguide/Welcome.html">AWS Signer Developer Guide</a>.</p>
<p></p>
Inheritance
AWSService
Initializers
init(client:region:partition:endpoint:timeout:byteBufferAllocator:options:)
Initialize the Signer client
public init(
client: AWSClient,
region: SotoCore.Region? = nil,
partition: AWSPartition = .aws,
endpoint: String? = nil,
timeout: TimeAmount? = nil,
byteBufferAllocator: ByteBufferAllocator = ByteBufferAllocator(),
options: AWSServiceConfig.Options = []
)
Parameters
- client: AWSClient used to process requests
- region: Region of server you want to communicate with. This will override the partition parameter.
- partition: AWS partition where service resides, standard (.aws), china (.awscn), government (.awsusgov).
- endpoint: Custom endpoint URL to use instead of standard AWS servers
- timeout: Timeout value for HTTP requests
init(from:patch:)
Initializer required by AWSService.with(middlewares:timeout:byteBufferAllocator:options)
. You are not able to use this initializer directly as there are no public initializers for AWSServiceConfig.Patch
. Please use AWSService.with(middlewares:timeout:byteBufferAllocator:options)
instead.
public init(from: Signer, patch: AWSServiceConfig.Patch)
Properties
client
Client used for communication with AWS
public let client: AWSClient
config
Service configuration
public let config: AWSServiceConfig
Methods
addProfilePermission(_:logger:on:)
public func addProfilePermission(_ input: AddProfilePermissionRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<AddProfilePermissionResponse>
Adds cross-account permissions to a signing profile.
cancelSigningProfile(_:logger:on:)
@discardableResult public func cancelSigningProfile(_ input: CancelSigningProfileRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<Void>
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.
describeSigningJob(_:logger:on:)
public func describeSigningJob(_ input: DescribeSigningJobRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<DescribeSigningJobResponse>
Returns information about a specific code signing job. You specify the job by using
the jobId
value that is returned by the StartSigningJob
operation.
getSigningPlatform(_:logger:on:)
public func getSigningPlatform(_ input: GetSigningPlatformRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<GetSigningPlatformResponse>
Returns information on a specific signing platform.
getSigningProfile(_:logger:on:)
public func getSigningProfile(_ input: GetSigningProfileRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<GetSigningProfileResponse>
Returns information on a specific signing profile.
listProfilePermissions(_:logger:on:)
public func listProfilePermissions(_ input: ListProfilePermissionsRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<ListProfilePermissionsResponse>
Lists the cross-account permissions associated with a signing profile.
listSigningJobs(_:logger:on:)
public func listSigningJobs(_ input: ListSigningJobsRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<ListSigningJobsResponse>
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, code signing 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 code signing returns in the nextToken
parameter until all of your signing jobs have been returned.
listSigningPlatforms(_:logger:on:)
public func listSigningPlatforms(_ input: ListSigningPlatformsRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<ListSigningPlatformsResponse>
Lists all signing platforms available in code signing that match the request parameters. If
additional jobs remain to be listed, code signing 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 code signing returns in the
nextToken
parameter until all of your signing jobs have been
returned.
listSigningProfiles(_:logger:on:)
public func listSigningProfiles(_ input: ListSigningProfilesRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<ListSigningProfilesResponse>
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, code signing 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 code signing returns in the nextToken
parameter until all of your
signing jobs have been returned.
listTagsForResource(_:logger:on:)
public func listTagsForResource(_ input: ListTagsForResourceRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<ListTagsForResourceResponse>
Returns a list of the tags associated with a signing profile resource.
putSigningProfile(_:logger:on:)
public func putSigningProfile(_ input: PutSigningProfileRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<PutSigningProfileResponse>
Creates a signing profile. A signing profile is a code signing template that can be used to carry out a pre-defined signing job. For more information, see http://docs.aws.amazon.com/signer/latest/developerguide/gs-profile.html
removeProfilePermission(_:logger:on:)
public func removeProfilePermission(_ input: RemoveProfilePermissionRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<RemoveProfilePermissionResponse>
Removes cross-account permissions from a signing profile.
revokeSignature(_:logger:on:)
@discardableResult public func revokeSignature(_ input: RevokeSignatureRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<Void>
Changes the state of a signing job to REVOKED. This indicates that the signature is no longer valid.
revokeSigningProfile(_:logger:on:)
@discardableResult public func revokeSigningProfile(_ input: RevokeSigningProfileRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<Void>
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.
startSigningJob(_:logger:on:)
public func startSigningJob(_ input: StartSigningJobRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<StartSigningJobResponse>
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 Create a Bucket in the Amazon S3 Getting Started Guide.
-
Your S3 source bucket must be version enabled.
-
You must create an S3 destination bucket. Code signing 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 also specify a request token that identifies your request to code signing.
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 http://docs.aws.amazon.com/acm/latest/userguide/
tagResource(_:logger:on:)
public func tagResource(_ input: TagResourceRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<TagResourceResponse>
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.
untagResource(_:logger:on:)
public func untagResource(_ input: UntagResourceRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil) -> EventLoopFuture<UntagResourceResponse>
Removes one or more tags from a signing profile. To remove the tags, specify a list of tag keys.
listSigningJobsPaginator(_:logger:on:)
compiler(>=5.5.2) && canImport(_Concurrency)
public func listSigningJobsPaginator( _ input: ListSigningJobsRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil ) -> AWSClient.PaginatorSequence<ListSigningJobsRequest, ListSigningJobsResponse>
Lists all your signing jobs. You can use the
Return PaginatorSequence for operation. - Parameters: - input: Input for request - logger: Logger used flot logging - eventLoop: EventLoop to run this process onmaxResults
parameter to limit the number of signing jobs that are returned in the response. If additional jobs remain to be listed, code signing returns anextToken
value. Use this value in subsequent calls toListSigningJobs
to fetch the remaining values. You can continue callingListSigningJobs
with yourmaxResults
parameter and with new values that code signing returns in thenextToken
parameter until all of your signing jobs have been returned.
listSigningPlatformsPaginator(_:logger:on:)
compiler(>=5.5.2) && canImport(_Concurrency)
public func listSigningPlatformsPaginator( _ input: ListSigningPlatformsRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil ) -> AWSClient.PaginatorSequence<ListSigningPlatformsRequest, ListSigningPlatformsResponse>
Lists all signing platforms available in code signing that match the request parameters. If additional jobs remain to be listed, code signing returns a
Return PaginatorSequence for operation. - Parameters: - input: Input for request - logger: Logger used flot logging - eventLoop: EventLoop to run this process onnextToken
value. Use this value in subsequent calls toListSigningJobs
to fetch the remaining values. You can continue callingListSigningJobs
with yourmaxResults
parameter and with new values that code signing returns in thenextToken
parameter until all of your signing jobs have been returned.
listSigningProfilesPaginator(_:logger:on:)
compiler(>=5.5.2) && canImport(_Concurrency)
public func listSigningProfilesPaginator( _ input: ListSigningProfilesRequest, logger: Logger = AWSClient.loggingDisabled, on eventLoop: EventLoop? = nil ) -> AWSClient.PaginatorSequence<ListSigningProfilesRequest, ListSigningProfilesResponse>
Lists all available signing profiles in your AWS account. Returns only profiles with an
Return PaginatorSequence for operation. - Parameters: - input: Input for request - logger: Logger used flot logging - eventLoop: EventLoop to run this process onACTIVE
status unless theincludeCanceled
request field is set totrue
. If additional jobs remain to be listed, code signing returns anextToken
value. Use this value in subsequent calls toListSigningJobs
to fetch the remaining values. You can continue callingListSigningJobs
with yourmaxResults
parameter and with new values that code signing returns in thenextToken
parameter until all of your signing jobs have been returned.
listSigningJobsPaginator(_:_:logger:on:onPage:)
Provide paginated results to closure onPage
for it to combine them into one result. This works in a similar manner to Array.reduce<Result>(_:_:) -> Result
.
public func listSigningJobsPaginator<Result>(
_ input: ListSigningJobsRequest,
_ initialValue: Result,
logger: Logger = AWSClient.loggingDisabled,
on eventLoop: EventLoop? = nil,
onPage: @escaping (Result, ListSigningJobsResponse, EventLoop) -> EventLoopFuture<(Bool, Result)>
) -> EventLoopFuture<Result>
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, code signing 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 code signing returns in the nextToken
parameter until all of your signing jobs have been returned.
Parameters:
- input: Input for request
- initialValue: The value to use as the initial accumulating value.
initialValue
is passed toonPage
the first time it is called.
- logger: Logger used flot logging
- eventLoop: EventLoop to run this process on
- onPage: closure called with each paginated response. It combines an accumulating result with the contents of response. This combined result is then returned along with a boolean indicating if the paginate operation should continue.
listSigningJobsPaginator(_:logger:on:onPage:)
Provide paginated results to closure onPage
.
public func listSigningJobsPaginator(
_ input: ListSigningJobsRequest,
logger: Logger = AWSClient.loggingDisabled,
on eventLoop: EventLoop? = nil,
onPage: @escaping (ListSigningJobsResponse, EventLoop) -> EventLoopFuture<Bool>
) -> EventLoopFuture<Void>
Parameters
- input: Input for request
- logger: Logger used flot logging
- eventLoop: EventLoop to run this process on
- onPage: closure called with each block of entries. Returns boolean indicating whether we should continue.
listSigningPlatformsPaginator(_:_:logger:on:onPage:)
Provide paginated results to closure onPage
for it to combine them into one result. This works in a similar manner to Array.reduce<Result>(_:_:) -> Result
.
public func listSigningPlatformsPaginator<Result>(
_ input: ListSigningPlatformsRequest,
_ initialValue: Result,
logger: Logger = AWSClient.loggingDisabled,
on eventLoop: EventLoop? = nil,
onPage: @escaping (Result, ListSigningPlatformsResponse, EventLoop) -> EventLoopFuture<(Bool, Result)>
) -> EventLoopFuture<Result>
Lists all signing platforms available in code signing that match the request parameters. If
additional jobs remain to be listed, code signing 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 code signing returns in the
nextToken
parameter until all of your signing jobs have been
returned.
Parameters:
- input: Input for request
- initialValue: The value to use as the initial accumulating value.
initialValue
is passed toonPage
the first time it is called.
- logger: Logger used flot logging
- eventLoop: EventLoop to run this process on
- onPage: closure called with each paginated response. It combines an accumulating result with the contents of response. This combined result is then returned along with a boolean indicating if the paginate operation should continue.
listSigningPlatformsPaginator(_:logger:on:onPage:)
Provide paginated results to closure onPage
.
public func listSigningPlatformsPaginator(
_ input: ListSigningPlatformsRequest,
logger: Logger = AWSClient.loggingDisabled,
on eventLoop: EventLoop? = nil,
onPage: @escaping (ListSigningPlatformsResponse, EventLoop) -> EventLoopFuture<Bool>
) -> EventLoopFuture<Void>
Parameters
- input: Input for request
- logger: Logger used flot logging
- eventLoop: EventLoop to run this process on
- onPage: closure called with each block of entries. Returns boolean indicating whether we should continue.
listSigningProfilesPaginator(_:_:logger:on:onPage:)
Provide paginated results to closure onPage
for it to combine them into one result. This works in a similar manner to Array.reduce<Result>(_:_:) -> Result
.
public func listSigningProfilesPaginator<Result>(
_ input: ListSigningProfilesRequest,
_ initialValue: Result,
logger: Logger = AWSClient.loggingDisabled,
on eventLoop: EventLoop? = nil,
onPage: @escaping (Result, ListSigningProfilesResponse, EventLoop) -> EventLoopFuture<(Bool, Result)>
) -> EventLoopFuture<Result>
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, code signing 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 code signing returns in the nextToken
parameter until all of your
signing jobs have been returned.
Parameters:
- input: Input for request
- initialValue: The value to use as the initial accumulating value.
initialValue
is passed toonPage
the first time it is called.
- logger: Logger used flot logging
- eventLoop: EventLoop to run this process on
- onPage: closure called with each paginated response. It combines an accumulating result with the contents of response. This combined result is then returned along with a boolean indicating if the paginate operation should continue.
listSigningProfilesPaginator(_:logger:on:onPage:)
Provide paginated results to closure onPage
.
public func listSigningProfilesPaginator(
_ input: ListSigningProfilesRequest,
logger: Logger = AWSClient.loggingDisabled,
on eventLoop: EventLoop? = nil,
onPage: @escaping (ListSigningProfilesResponse, EventLoop) -> EventLoopFuture<Bool>
) -> EventLoopFuture<Void>
Parameters
- input: Input for request
- logger: Logger used flot logging
- eventLoop: EventLoop to run this process on
- onPage: closure called with each block of entries. Returns boolean indicating whether we should continue.
waitUntilSuccessfulSigningJob(_:maxWaitTime:logger:on:)
public func waitUntilSuccessfulSigningJob(
_ input: DescribeSigningJobRequest,
maxWaitTime: TimeAmount? = nil,
logger: Logger = AWSClient.loggingDisabled,
on eventLoop: EventLoop? = nil
) -> EventLoopFuture<Void>