/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.acmpca; import javax.annotation.Generated; import com.amazonaws.services.acmpca.model.*; /** * Interface for accessing ACM-PCA asynchronously. Each asynchronous method will return a Java Future object * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *

* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.acmpca.AbstractAWSACMPCAAsync} instead. *

*

*

* This is the Amazon Web Services Private Certificate Authority API Reference. It provides descriptions, syntax, * and usage examples for each of the actions and data types involved in creating and managing a private certificate * authority (CA) for your organization. *

*

* The documentation for each action shows the API request parameters and the JSON response. Alternatively, you can use * one of the Amazon Web Services SDKs to access an API that is tailored to the programming language or platform that * you prefer. For more information, see Amazon Web Services SDKs. *

*

* Each Amazon Web Services Private CA API operation has a quota that determines the number of times the operation can * be called per second. Amazon Web Services Private CA throttles API requests at different rates depending on the * operation. Throttling means that Amazon Web Services Private CA rejects an otherwise valid request because the * request exceeds the operation's quota for the number of requests per second. When a request is throttled, Amazon Web * Services Private CA returns a ThrottlingException error. * Amazon Web Services Private CA does not guarantee a minimum request rate for APIs. *

*

* To see an up-to-date list of your Amazon Web Services Private CA quotas, or to request a quota increase, log into * your Amazon Web Services account and visit the Service * Quotas console. *

*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AWSACMPCAAsync extends AWSACMPCA { /** *

* Creates a root or subordinate private certificate authority (CA). You must specify the CA configuration, an * optional configuration for Online Certificate Status Protocol (OCSP) and/or a certificate revocation list (CRL), * the CA type, and an optional idempotency token to avoid accidental creation of multiple CAs. The CA configuration * specifies the name of the algorithm and key size to be used to create the CA private key, the type of signing * algorithm that the CA uses, and X.500 subject information. The OCSP configuration can optionally specify a custom * URL for the OCSP responder. The CRL configuration specifies the CRL expiration period in days (the validity * period of the CRL), the Amazon S3 bucket that will contain the CRL, and a CNAME alias for the S3 bucket that is * included in certificates issued by the CA. If successful, this action returns the Amazon Resource Name (ARN) of * the CA. *

* *

* Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you * specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception * is thrown. For more information, see Access policies for * CRLs in Amazon S3. *

*
*

* Amazon Web Services Private CA assets that are stored in Amazon S3 can be protected with encryption. For more * information, see Encrypting Your * CRLs. *

* * @param createCertificateAuthorityRequest * @return A Java Future containing the result of the CreateCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsync.CreateCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future createCertificateAuthorityAsync( CreateCertificateAuthorityRequest createCertificateAuthorityRequest); /** *

* Creates a root or subordinate private certificate authority (CA). You must specify the CA configuration, an * optional configuration for Online Certificate Status Protocol (OCSP) and/or a certificate revocation list (CRL), * the CA type, and an optional idempotency token to avoid accidental creation of multiple CAs. The CA configuration * specifies the name of the algorithm and key size to be used to create the CA private key, the type of signing * algorithm that the CA uses, and X.500 subject information. The OCSP configuration can optionally specify a custom * URL for the OCSP responder. The CRL configuration specifies the CRL expiration period in days (the validity * period of the CRL), the Amazon S3 bucket that will contain the CRL, and a CNAME alias for the S3 bucket that is * included in certificates issued by the CA. If successful, this action returns the Amazon Resource Name (ARN) of * the CA. *

* *

* Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you * specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception * is thrown. For more information, see Access policies for * CRLs in Amazon S3. *

*
*

* Amazon Web Services Private CA assets that are stored in Amazon S3 can be protected with encryption. For more * information, see Encrypting Your * CRLs. *

* * @param createCertificateAuthorityRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsyncHandler.CreateCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future createCertificateAuthorityAsync( CreateCertificateAuthorityRequest createCertificateAuthorityRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates an audit report that lists every time that your CA private key is used. The report is saved in the Amazon * S3 bucket that you specify on input. The IssueCertificate * and RevokeCertificate * actions use the private key. *

* *

* Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you * specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception * is thrown. For more information, see Access policies for * CRLs in Amazon S3. *

*
*

* Amazon Web Services Private CA assets that are stored in Amazon S3 can be protected with encryption. For more * information, see Encrypting Your Audit Reports. *

* *

* You can generate a maximum of one report every 30 minutes. *

*
* * @param createCertificateAuthorityAuditReportRequest * @return A Java Future containing the result of the CreateCertificateAuthorityAuditReport operation returned by * the service. * @sample AWSACMPCAAsync.CreateCertificateAuthorityAuditReport * @see AWS API Documentation */ java.util.concurrent.Future createCertificateAuthorityAuditReportAsync( CreateCertificateAuthorityAuditReportRequest createCertificateAuthorityAuditReportRequest); /** *

* Creates an audit report that lists every time that your CA private key is used. The report is saved in the Amazon * S3 bucket that you specify on input. The IssueCertificate * and RevokeCertificate * actions use the private key. *

* *

* Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you * specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception * is thrown. For more information, see Access policies for * CRLs in Amazon S3. *

*
*

* Amazon Web Services Private CA assets that are stored in Amazon S3 can be protected with encryption. For more * information, see Encrypting Your Audit Reports. *

* *

* You can generate a maximum of one report every 30 minutes. *

*
* * @param createCertificateAuthorityAuditReportRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateCertificateAuthorityAuditReport operation returned by * the service. * @sample AWSACMPCAAsyncHandler.CreateCertificateAuthorityAuditReport * @see AWS API Documentation */ java.util.concurrent.Future createCertificateAuthorityAuditReportAsync( CreateCertificateAuthorityAuditReportRequest createCertificateAuthorityAuditReportRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Grants one or more permissions on a private CA to the Certificate Manager (ACM) service principal ( * acm.amazonaws.com). These permissions allow ACM to issue and renew ACM certificates that reside in * the same Amazon Web Services account as the CA. *

*

* You can list current permissions with the ListPermissions * action and revoke them with the DeletePermission * action. *

*

* About Permissions *

*
    *
  • *

    * If the private CA and the certificates it issues reside in the same account, you can use * CreatePermission to grant permissions for ACM to carry out automatic certificate renewals. *

    *
  • *
  • *

    * For automatic certificate renewal to succeed, the ACM service principal needs permissions to create, retrieve, * and list certificates. *

    *
  • *
  • *

    * If the private CA and the ACM certificates reside in different accounts, then permissions cannot be used to * enable automatic renewals. Instead, the ACM certificate owner must set up a resource-based policy to enable * cross-account issuance and renewals. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
* * @param createPermissionRequest * @return A Java Future containing the result of the CreatePermission operation returned by the service. * @sample AWSACMPCAAsync.CreatePermission * @see AWS API * Documentation */ java.util.concurrent.Future createPermissionAsync(CreatePermissionRequest createPermissionRequest); /** *

* Grants one or more permissions on a private CA to the Certificate Manager (ACM) service principal ( * acm.amazonaws.com). These permissions allow ACM to issue and renew ACM certificates that reside in * the same Amazon Web Services account as the CA. *

*

* You can list current permissions with the ListPermissions * action and revoke them with the DeletePermission * action. *

*

* About Permissions *

*
    *
  • *

    * If the private CA and the certificates it issues reside in the same account, you can use * CreatePermission to grant permissions for ACM to carry out automatic certificate renewals. *

    *
  • *
  • *

    * For automatic certificate renewal to succeed, the ACM service principal needs permissions to create, retrieve, * and list certificates. *

    *
  • *
  • *

    * If the private CA and the ACM certificates reside in different accounts, then permissions cannot be used to * enable automatic renewals. Instead, the ACM certificate owner must set up a resource-based policy to enable * cross-account issuance and renewals. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
* * @param createPermissionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreatePermission operation returned by the service. * @sample AWSACMPCAAsyncHandler.CreatePermission * @see AWS API * Documentation */ java.util.concurrent.Future createPermissionAsync(CreatePermissionRequest createPermissionRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes a private certificate authority (CA). You must provide the Amazon Resource Name (ARN) of the private CA * that you want to delete. You can find the ARN by calling the ListCertificateAuthorities action. *

* *

* Deleting a CA will invalidate other CAs and certificates below it in your CA hierarchy. *

*
*

* Before you can delete a CA that you have created and activated, you must disable it. To do this, call the * UpdateCertificateAuthority action and set the CertificateAuthorityStatus parameter to * DISABLED. *

*

* Additionally, you can delete a CA if you are waiting for it to be created (that is, the status of the CA is * CREATING). You can also delete it if the CA has been created but you haven't yet imported the signed * certificate into Amazon Web Services Private CA (that is, the status of the CA is * PENDING_CERTIFICATE). *

*

* When you successfully call DeleteCertificateAuthority, the CA's status changes to DELETED. However, the CA won't be * permanently deleted until the restoration period has passed. By default, if you do not set the * PermanentDeletionTimeInDays parameter, the CA remains restorable for 30 days. You can set the * parameter from 7 to 30 days. The DescribeCertificateAuthority action returns the time remaining in the restoration window of a private CA in * the DELETED state. To restore an eligible CA, call the RestoreCertificateAuthority action. *

* * @param deleteCertificateAuthorityRequest * @return A Java Future containing the result of the DeleteCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsync.DeleteCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future deleteCertificateAuthorityAsync( DeleteCertificateAuthorityRequest deleteCertificateAuthorityRequest); /** *

* Deletes a private certificate authority (CA). You must provide the Amazon Resource Name (ARN) of the private CA * that you want to delete. You can find the ARN by calling the ListCertificateAuthorities action. *

* *

* Deleting a CA will invalidate other CAs and certificates below it in your CA hierarchy. *

*
*

* Before you can delete a CA that you have created and activated, you must disable it. To do this, call the * UpdateCertificateAuthority action and set the CertificateAuthorityStatus parameter to * DISABLED. *

*

* Additionally, you can delete a CA if you are waiting for it to be created (that is, the status of the CA is * CREATING). You can also delete it if the CA has been created but you haven't yet imported the signed * certificate into Amazon Web Services Private CA (that is, the status of the CA is * PENDING_CERTIFICATE). *

*

* When you successfully call DeleteCertificateAuthority, the CA's status changes to DELETED. However, the CA won't be * permanently deleted until the restoration period has passed. By default, if you do not set the * PermanentDeletionTimeInDays parameter, the CA remains restorable for 30 days. You can set the * parameter from 7 to 30 days. The DescribeCertificateAuthority action returns the time remaining in the restoration window of a private CA in * the DELETED state. To restore an eligible CA, call the RestoreCertificateAuthority action. *

* * @param deleteCertificateAuthorityRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsyncHandler.DeleteCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future deleteCertificateAuthorityAsync( DeleteCertificateAuthorityRequest deleteCertificateAuthorityRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Revokes permissions on a private CA granted to the Certificate Manager (ACM) service principal * (acm.amazonaws.com). *

*

* These permissions allow ACM to issue and renew ACM certificates that reside in the same Amazon Web Services * account as the CA. If you revoke these permissions, ACM will no longer renew the affected certificates * automatically. *

*

* Permissions can be granted with the CreatePermission * action and listed with the ListPermissions * action. *

*

* About Permissions *

*
    *
  • *

    * If the private CA and the certificates it issues reside in the same account, you can use * CreatePermission to grant permissions for ACM to carry out automatic certificate renewals. *

    *
  • *
  • *

    * For automatic certificate renewal to succeed, the ACM service principal needs permissions to create, retrieve, * and list certificates. *

    *
  • *
  • *

    * If the private CA and the ACM certificates reside in different accounts, then permissions cannot be used to * enable automatic renewals. Instead, the ACM certificate owner must set up a resource-based policy to enable * cross-account issuance and renewals. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
* * @param deletePermissionRequest * @return A Java Future containing the result of the DeletePermission operation returned by the service. * @sample AWSACMPCAAsync.DeletePermission * @see AWS API * Documentation */ java.util.concurrent.Future deletePermissionAsync(DeletePermissionRequest deletePermissionRequest); /** *

* Revokes permissions on a private CA granted to the Certificate Manager (ACM) service principal * (acm.amazonaws.com). *

*

* These permissions allow ACM to issue and renew ACM certificates that reside in the same Amazon Web Services * account as the CA. If you revoke these permissions, ACM will no longer renew the affected certificates * automatically. *

*

* Permissions can be granted with the CreatePermission * action and listed with the ListPermissions * action. *

*

* About Permissions *

*
    *
  • *

    * If the private CA and the certificates it issues reside in the same account, you can use * CreatePermission to grant permissions for ACM to carry out automatic certificate renewals. *

    *
  • *
  • *

    * For automatic certificate renewal to succeed, the ACM service principal needs permissions to create, retrieve, * and list certificates. *

    *
  • *
  • *

    * If the private CA and the ACM certificates reside in different accounts, then permissions cannot be used to * enable automatic renewals. Instead, the ACM certificate owner must set up a resource-based policy to enable * cross-account issuance and renewals. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
* * @param deletePermissionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeletePermission operation returned by the service. * @sample AWSACMPCAAsyncHandler.DeletePermission * @see AWS API * Documentation */ java.util.concurrent.Future deletePermissionAsync(DeletePermissionRequest deletePermissionRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes the resource-based policy attached to a private CA. Deletion will remove any access that the policy has * granted. If there is no policy attached to the private CA, this action will return successful. *

*

* If you delete a policy that was applied through Amazon Web Services Resource Access Manager (RAM), the CA will be * removed from all shares in which it was included. *

*

* The Certificate Manager Service Linked Role that the policy supports is not affected when you delete the policy. *

*

* The current policy can be shown with GetPolicy and updated * with PutPolicy. *

*

* About Policies *

*
    *
  • *

    * A policy grants access on a private CA to an Amazon Web Services customer account, to Amazon Web Services * Organizations, or to an Amazon Web Services Organizations unit. Policies are under the control of a CA * administrator. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
  • *

    * A policy permits a user of Certificate Manager (ACM) to issue ACM certificates signed by a CA in another account. *

    *
  • *
  • *

    * For ACM to manage automatic renewal of these certificates, the ACM user must configure a Service Linked Role * (SLR). The SLR allows the ACM service to assume the identity of the user, subject to confirmation against the * Amazon Web Services Private CA policy. For more information, see Using a Service Linked Role with ACM. *

    *
  • *
  • *

    * Updates made in Amazon Web Services Resource Manager (RAM) are reflected in policies. For more information, see * Attach a Policy for Cross-Account * Access. *

    *
  • *
* * @param deletePolicyRequest * @return A Java Future containing the result of the DeletePolicy operation returned by the service. * @sample AWSACMPCAAsync.DeletePolicy * @see AWS API * Documentation */ java.util.concurrent.Future deletePolicyAsync(DeletePolicyRequest deletePolicyRequest); /** *

* Deletes the resource-based policy attached to a private CA. Deletion will remove any access that the policy has * granted. If there is no policy attached to the private CA, this action will return successful. *

*

* If you delete a policy that was applied through Amazon Web Services Resource Access Manager (RAM), the CA will be * removed from all shares in which it was included. *

*

* The Certificate Manager Service Linked Role that the policy supports is not affected when you delete the policy. *

*

* The current policy can be shown with GetPolicy and updated * with PutPolicy. *

*

* About Policies *

*
    *
  • *

    * A policy grants access on a private CA to an Amazon Web Services customer account, to Amazon Web Services * Organizations, or to an Amazon Web Services Organizations unit. Policies are under the control of a CA * administrator. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
  • *

    * A policy permits a user of Certificate Manager (ACM) to issue ACM certificates signed by a CA in another account. *

    *
  • *
  • *

    * For ACM to manage automatic renewal of these certificates, the ACM user must configure a Service Linked Role * (SLR). The SLR allows the ACM service to assume the identity of the user, subject to confirmation against the * Amazon Web Services Private CA policy. For more information, see Using a Service Linked Role with ACM. *

    *
  • *
  • *

    * Updates made in Amazon Web Services Resource Manager (RAM) are reflected in policies. For more information, see * Attach a Policy for Cross-Account * Access. *

    *
  • *
* * @param deletePolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeletePolicy operation returned by the service. * @sample AWSACMPCAAsyncHandler.DeletePolicy * @see AWS API * Documentation */ java.util.concurrent.Future deletePolicyAsync(DeletePolicyRequest deletePolicyRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists information about your private certificate authority (CA) or one that has been shared with you. You specify * the private CA on input by its ARN (Amazon Resource Name). The output contains the status of your CA. This can be * any of the following: *

*
    *
  • *

    * CREATING - Amazon Web Services Private CA is creating your private certificate authority. *

    *
  • *
  • *

    * PENDING_CERTIFICATE - The certificate is pending. You must use your Amazon Web Services Private * CA-hosted or on-premises root or subordinate CA to sign your private CA CSR and then import it into Amazon Web * Services Private CA. *

    *
  • *
  • *

    * ACTIVE - Your private CA is active. *

    *
  • *
  • *

    * DISABLED - Your private CA has been disabled. *

    *
  • *
  • *

    * EXPIRED - Your private CA certificate has expired. *

    *
  • *
  • *

    * FAILED - Your private CA has failed. Your CA can fail because of problems such a network outage or * back-end Amazon Web Services failure or other errors. A failed CA can never return to the pending state. You must * create a new CA. *

    *
  • *
  • *

    * DELETED - Your private CA is within the restoration period, after which it is permanently deleted. * The length of time remaining in the CA's restoration period is also included in this action's output. *

    *
  • *
* * @param describeCertificateAuthorityRequest * @return A Java Future containing the result of the DescribeCertificateAuthority operation returned by the * service. * @sample AWSACMPCAAsync.DescribeCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future describeCertificateAuthorityAsync( DescribeCertificateAuthorityRequest describeCertificateAuthorityRequest); /** *

* Lists information about your private certificate authority (CA) or one that has been shared with you. You specify * the private CA on input by its ARN (Amazon Resource Name). The output contains the status of your CA. This can be * any of the following: *

*
    *
  • *

    * CREATING - Amazon Web Services Private CA is creating your private certificate authority. *

    *
  • *
  • *

    * PENDING_CERTIFICATE - The certificate is pending. You must use your Amazon Web Services Private * CA-hosted or on-premises root or subordinate CA to sign your private CA CSR and then import it into Amazon Web * Services Private CA. *

    *
  • *
  • *

    * ACTIVE - Your private CA is active. *

    *
  • *
  • *

    * DISABLED - Your private CA has been disabled. *

    *
  • *
  • *

    * EXPIRED - Your private CA certificate has expired. *

    *
  • *
  • *

    * FAILED - Your private CA has failed. Your CA can fail because of problems such a network outage or * back-end Amazon Web Services failure or other errors. A failed CA can never return to the pending state. You must * create a new CA. *

    *
  • *
  • *

    * DELETED - Your private CA is within the restoration period, after which it is permanently deleted. * The length of time remaining in the CA's restoration period is also included in this action's output. *

    *
  • *
* * @param describeCertificateAuthorityRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeCertificateAuthority operation returned by the * service. * @sample AWSACMPCAAsyncHandler.DescribeCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future describeCertificateAuthorityAsync( DescribeCertificateAuthorityRequest describeCertificateAuthorityRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists information about a specific audit report created by calling the CreateCertificateAuthorityAuditReport action. Audit information is created every time the certificate * authority (CA) private key is used. The private key is used when you call the IssueCertificate * action or the RevokeCertificate * action. *

* * @param describeCertificateAuthorityAuditReportRequest * @return A Java Future containing the result of the DescribeCertificateAuthorityAuditReport operation returned by * the service. * @sample AWSACMPCAAsync.DescribeCertificateAuthorityAuditReport * @see AWS API Documentation */ java.util.concurrent.Future describeCertificateAuthorityAuditReportAsync( DescribeCertificateAuthorityAuditReportRequest describeCertificateAuthorityAuditReportRequest); /** *

* Lists information about a specific audit report created by calling the CreateCertificateAuthorityAuditReport action. Audit information is created every time the certificate * authority (CA) private key is used. The private key is used when you call the IssueCertificate * action or the RevokeCertificate * action. *

* * @param describeCertificateAuthorityAuditReportRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeCertificateAuthorityAuditReport operation returned by * the service. * @sample AWSACMPCAAsyncHandler.DescribeCertificateAuthorityAuditReport * @see AWS API Documentation */ java.util.concurrent.Future describeCertificateAuthorityAuditReportAsync( DescribeCertificateAuthorityAuditReportRequest describeCertificateAuthorityAuditReportRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Retrieves a certificate from your private CA or one that has been shared with you. The ARN of the certificate is * returned when you call the IssueCertificate * action. You must specify both the ARN of your private CA and the ARN of the issued certificate when calling the * GetCertificate action. You can retrieve the certificate if it is in the ISSUED state. You can call * the CreateCertificateAuthorityAuditReport action to create a report that contains information about all of the * certificates issued and revoked by your private CA. *

* * @param getCertificateRequest * @return A Java Future containing the result of the GetCertificate operation returned by the service. * @sample AWSACMPCAAsync.GetCertificate * @see AWS API * Documentation */ java.util.concurrent.Future getCertificateAsync(GetCertificateRequest getCertificateRequest); /** *

* Retrieves a certificate from your private CA or one that has been shared with you. The ARN of the certificate is * returned when you call the IssueCertificate * action. You must specify both the ARN of your private CA and the ARN of the issued certificate when calling the * GetCertificate action. You can retrieve the certificate if it is in the ISSUED state. You can call * the CreateCertificateAuthorityAuditReport action to create a report that contains information about all of the * certificates issued and revoked by your private CA. *

* * @param getCertificateRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetCertificate operation returned by the service. * @sample AWSACMPCAAsyncHandler.GetCertificate * @see AWS API * Documentation */ java.util.concurrent.Future getCertificateAsync(GetCertificateRequest getCertificateRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Retrieves the certificate and certificate chain for your private certificate authority (CA) or one that has been * shared with you. Both the certificate and the chain are base64 PEM-encoded. The chain does not include the CA * certificate. Each certificate in the chain signs the one before it. *

* * @param getCertificateAuthorityCertificateRequest * @return A Java Future containing the result of the GetCertificateAuthorityCertificate operation returned by the * service. * @sample AWSACMPCAAsync.GetCertificateAuthorityCertificate * @see AWS API Documentation */ java.util.concurrent.Future getCertificateAuthorityCertificateAsync( GetCertificateAuthorityCertificateRequest getCertificateAuthorityCertificateRequest); /** *

* Retrieves the certificate and certificate chain for your private certificate authority (CA) or one that has been * shared with you. Both the certificate and the chain are base64 PEM-encoded. The chain does not include the CA * certificate. Each certificate in the chain signs the one before it. *

* * @param getCertificateAuthorityCertificateRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetCertificateAuthorityCertificate operation returned by the * service. * @sample AWSACMPCAAsyncHandler.GetCertificateAuthorityCertificate * @see AWS API Documentation */ java.util.concurrent.Future getCertificateAuthorityCertificateAsync( GetCertificateAuthorityCertificateRequest getCertificateAuthorityCertificateRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Retrieves the certificate signing request (CSR) for your private certificate authority (CA). The CSR is created * when you call the CreateCertificateAuthority action. Sign the CSR with your Amazon Web Services Private CA-hosted or * on-premises root or subordinate CA. Then import the signed certificate back into Amazon Web Services Private CA * by calling the ImportCertificateAuthorityCertificate action. The CSR is returned as a base64 PEM-encoded string. *

* * @param getCertificateAuthorityCsrRequest * @return A Java Future containing the result of the GetCertificateAuthorityCsr operation returned by the service. * @sample AWSACMPCAAsync.GetCertificateAuthorityCsr * @see AWS API Documentation */ java.util.concurrent.Future getCertificateAuthorityCsrAsync( GetCertificateAuthorityCsrRequest getCertificateAuthorityCsrRequest); /** *

* Retrieves the certificate signing request (CSR) for your private certificate authority (CA). The CSR is created * when you call the CreateCertificateAuthority action. Sign the CSR with your Amazon Web Services Private CA-hosted or * on-premises root or subordinate CA. Then import the signed certificate back into Amazon Web Services Private CA * by calling the ImportCertificateAuthorityCertificate action. The CSR is returned as a base64 PEM-encoded string. *

* * @param getCertificateAuthorityCsrRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetCertificateAuthorityCsr operation returned by the service. * @sample AWSACMPCAAsyncHandler.GetCertificateAuthorityCsr * @see AWS API Documentation */ java.util.concurrent.Future getCertificateAuthorityCsrAsync( GetCertificateAuthorityCsrRequest getCertificateAuthorityCsrRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Retrieves the resource-based policy attached to a private CA. If either the private CA resource or the policy * cannot be found, this action returns a ResourceNotFoundException. *

*

* The policy can be attached or updated with PutPolicy and removed * with DeletePolicy. *

*

* About Policies *

*
    *
  • *

    * A policy grants access on a private CA to an Amazon Web Services customer account, to Amazon Web Services * Organizations, or to an Amazon Web Services Organizations unit. Policies are under the control of a CA * administrator. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
  • *

    * A policy permits a user of Certificate Manager (ACM) to issue ACM certificates signed by a CA in another account. *

    *
  • *
  • *

    * For ACM to manage automatic renewal of these certificates, the ACM user must configure a Service Linked Role * (SLR). The SLR allows the ACM service to assume the identity of the user, subject to confirmation against the * Amazon Web Services Private CA policy. For more information, see Using a Service Linked Role with ACM. *

    *
  • *
  • *

    * Updates made in Amazon Web Services Resource Manager (RAM) are reflected in policies. For more information, see * Attach a Policy for Cross-Account * Access. *

    *
  • *
* * @param getPolicyRequest * @return A Java Future containing the result of the GetPolicy operation returned by the service. * @sample AWSACMPCAAsync.GetPolicy * @see AWS API * Documentation */ java.util.concurrent.Future getPolicyAsync(GetPolicyRequest getPolicyRequest); /** *

* Retrieves the resource-based policy attached to a private CA. If either the private CA resource or the policy * cannot be found, this action returns a ResourceNotFoundException. *

*

* The policy can be attached or updated with PutPolicy and removed * with DeletePolicy. *

*

* About Policies *

*
    *
  • *

    * A policy grants access on a private CA to an Amazon Web Services customer account, to Amazon Web Services * Organizations, or to an Amazon Web Services Organizations unit. Policies are under the control of a CA * administrator. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
  • *

    * A policy permits a user of Certificate Manager (ACM) to issue ACM certificates signed by a CA in another account. *

    *
  • *
  • *

    * For ACM to manage automatic renewal of these certificates, the ACM user must configure a Service Linked Role * (SLR). The SLR allows the ACM service to assume the identity of the user, subject to confirmation against the * Amazon Web Services Private CA policy. For more information, see Using a Service Linked Role with ACM. *

    *
  • *
  • *

    * Updates made in Amazon Web Services Resource Manager (RAM) are reflected in policies. For more information, see * Attach a Policy for Cross-Account * Access. *

    *
  • *
* * @param getPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetPolicy operation returned by the service. * @sample AWSACMPCAAsyncHandler.GetPolicy * @see AWS API * Documentation */ java.util.concurrent.Future getPolicyAsync(GetPolicyRequest getPolicyRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Imports a signed private CA certificate into Amazon Web Services Private CA. This action is used when you are * using a chain of trust whose root is located outside Amazon Web Services Private CA. Before you can call this * action, the following preparations must in place: *

*
    *
  1. *

    * In Amazon Web Services Private CA, call the CreateCertificateAuthority action to create the private CA that you plan to back with the imported * certificate. *

    *
  2. *
  3. *

    * Call the * GetCertificateAuthorityCsr action to generate a certificate signing request (CSR). *

    *
  4. *
  5. *

    * Sign the CSR using a root or intermediate CA hosted by either an on-premises PKI hierarchy or by a commercial CA. *

    *
  6. *
  7. *

    * Create a certificate chain and copy the signed certificate and the certificate chain to your working directory. *

    *
  8. *
*

* Amazon Web Services Private CA supports three scenarios for installing a CA certificate: *

*
    *
  • *

    * Installing a certificate for a root CA hosted by Amazon Web Services Private CA. *

    *
  • *
  • *

    * Installing a subordinate CA certificate whose parent authority is hosted by Amazon Web Services Private CA. *

    *
  • *
  • *

    * Installing a subordinate CA certificate whose parent authority is externally hosted. *

    *
  • *
*

* The following additional requirements apply when you import a CA certificate. *

*
    *
  • *

    * Only a self-signed certificate can be imported as a root CA. *

    *
  • *
  • *

    * A self-signed certificate cannot be imported as a subordinate CA. *

    *
  • *
  • *

    * Your certificate chain must not include the private CA certificate that you are importing. *

    *
  • *
  • *

    * Your root CA must be the last certificate in your chain. The subordinate certificate, if any, that your root CA * signed must be next to last. The subordinate certificate signed by the preceding subordinate CA must come next, * and so on until your chain is built. *

    *
  • *
  • *

    * The chain must be PEM-encoded. *

    *
  • *
  • *

    * The maximum allowed size of a certificate is 32 KB. *

    *
  • *
  • *

    * The maximum allowed size of a certificate chain is 2 MB. *

    *
  • *
*

* Enforcement of Critical Constraints *

*

* Amazon Web Services Private CA allows the following extensions to be marked critical in the imported CA * certificate or chain. *

*
    *
  • *

    * Basic constraints (must be marked critical) *

    *
  • *
  • *

    * Subject alternative names *

    *
  • *
  • *

    * Key usage *

    *
  • *
  • *

    * Extended key usage *

    *
  • *
  • *

    * Authority key identifier *

    *
  • *
  • *

    * Subject key identifier *

    *
  • *
  • *

    * Issuer alternative name *

    *
  • *
  • *

    * Subject directory attributes *

    *
  • *
  • *

    * Subject information access *

    *
  • *
  • *

    * Certificate policies *

    *
  • *
  • *

    * Policy mappings *

    *
  • *
  • *

    * Inhibit anyPolicy *

    *
  • *
*

* Amazon Web Services Private CA rejects the following extensions when they are marked critical in an imported CA * certificate or chain. *

*
    *
  • *

    * Name constraints *

    *
  • *
  • *

    * Policy constraints *

    *
  • *
  • *

    * CRL distribution points *

    *
  • *
  • *

    * Authority information access *

    *
  • *
  • *

    * Freshest CRL *

    *
  • *
  • *

    * Any other extension *

    *
  • *
* * @param importCertificateAuthorityCertificateRequest * @return A Java Future containing the result of the ImportCertificateAuthorityCertificate operation returned by * the service. * @sample AWSACMPCAAsync.ImportCertificateAuthorityCertificate * @see AWS API Documentation */ java.util.concurrent.Future importCertificateAuthorityCertificateAsync( ImportCertificateAuthorityCertificateRequest importCertificateAuthorityCertificateRequest); /** *

* Imports a signed private CA certificate into Amazon Web Services Private CA. This action is used when you are * using a chain of trust whose root is located outside Amazon Web Services Private CA. Before you can call this * action, the following preparations must in place: *

*
    *
  1. *

    * In Amazon Web Services Private CA, call the CreateCertificateAuthority action to create the private CA that you plan to back with the imported * certificate. *

    *
  2. *
  3. *

    * Call the * GetCertificateAuthorityCsr action to generate a certificate signing request (CSR). *

    *
  4. *
  5. *

    * Sign the CSR using a root or intermediate CA hosted by either an on-premises PKI hierarchy or by a commercial CA. *

    *
  6. *
  7. *

    * Create a certificate chain and copy the signed certificate and the certificate chain to your working directory. *

    *
  8. *
*

* Amazon Web Services Private CA supports three scenarios for installing a CA certificate: *

*
    *
  • *

    * Installing a certificate for a root CA hosted by Amazon Web Services Private CA. *

    *
  • *
  • *

    * Installing a subordinate CA certificate whose parent authority is hosted by Amazon Web Services Private CA. *

    *
  • *
  • *

    * Installing a subordinate CA certificate whose parent authority is externally hosted. *

    *
  • *
*

* The following additional requirements apply when you import a CA certificate. *

*
    *
  • *

    * Only a self-signed certificate can be imported as a root CA. *

    *
  • *
  • *

    * A self-signed certificate cannot be imported as a subordinate CA. *

    *
  • *
  • *

    * Your certificate chain must not include the private CA certificate that you are importing. *

    *
  • *
  • *

    * Your root CA must be the last certificate in your chain. The subordinate certificate, if any, that your root CA * signed must be next to last. The subordinate certificate signed by the preceding subordinate CA must come next, * and so on until your chain is built. *

    *
  • *
  • *

    * The chain must be PEM-encoded. *

    *
  • *
  • *

    * The maximum allowed size of a certificate is 32 KB. *

    *
  • *
  • *

    * The maximum allowed size of a certificate chain is 2 MB. *

    *
  • *
*

* Enforcement of Critical Constraints *

*

* Amazon Web Services Private CA allows the following extensions to be marked critical in the imported CA * certificate or chain. *

*
    *
  • *

    * Basic constraints (must be marked critical) *

    *
  • *
  • *

    * Subject alternative names *

    *
  • *
  • *

    * Key usage *

    *
  • *
  • *

    * Extended key usage *

    *
  • *
  • *

    * Authority key identifier *

    *
  • *
  • *

    * Subject key identifier *

    *
  • *
  • *

    * Issuer alternative name *

    *
  • *
  • *

    * Subject directory attributes *

    *
  • *
  • *

    * Subject information access *

    *
  • *
  • *

    * Certificate policies *

    *
  • *
  • *

    * Policy mappings *

    *
  • *
  • *

    * Inhibit anyPolicy *

    *
  • *
*

* Amazon Web Services Private CA rejects the following extensions when they are marked critical in an imported CA * certificate or chain. *

*
    *
  • *

    * Name constraints *

    *
  • *
  • *

    * Policy constraints *

    *
  • *
  • *

    * CRL distribution points *

    *
  • *
  • *

    * Authority information access *

    *
  • *
  • *

    * Freshest CRL *

    *
  • *
  • *

    * Any other extension *

    *
  • *
* * @param importCertificateAuthorityCertificateRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ImportCertificateAuthorityCertificate operation returned by * the service. * @sample AWSACMPCAAsyncHandler.ImportCertificateAuthorityCertificate * @see AWS API Documentation */ java.util.concurrent.Future importCertificateAuthorityCertificateAsync( ImportCertificateAuthorityCertificateRequest importCertificateAuthorityCertificateRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Uses your private certificate authority (CA), or one that has been shared with you, to issue a client * certificate. This action returns the Amazon Resource Name (ARN) of the certificate. You can retrieve the * certificate by calling the GetCertificate * action and specifying the ARN. *

* *

* You cannot use the ACM ListCertificateAuthorities action to retrieve the ARNs of the certificates that you * issue by using Amazon Web Services Private CA. *

*
* * @param issueCertificateRequest * @return A Java Future containing the result of the IssueCertificate operation returned by the service. * @sample AWSACMPCAAsync.IssueCertificate * @see AWS API * Documentation */ java.util.concurrent.Future issueCertificateAsync(IssueCertificateRequest issueCertificateRequest); /** *

* Uses your private certificate authority (CA), or one that has been shared with you, to issue a client * certificate. This action returns the Amazon Resource Name (ARN) of the certificate. You can retrieve the * certificate by calling the GetCertificate * action and specifying the ARN. *

* *

* You cannot use the ACM ListCertificateAuthorities action to retrieve the ARNs of the certificates that you * issue by using Amazon Web Services Private CA. *

*
* * @param issueCertificateRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the IssueCertificate operation returned by the service. * @sample AWSACMPCAAsyncHandler.IssueCertificate * @see AWS API * Documentation */ java.util.concurrent.Future issueCertificateAsync(IssueCertificateRequest issueCertificateRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists the private certificate authorities that you created by using the CreateCertificateAuthority action. *

* * @param listCertificateAuthoritiesRequest * @return A Java Future containing the result of the ListCertificateAuthorities operation returned by the service. * @sample AWSACMPCAAsync.ListCertificateAuthorities * @see AWS API Documentation */ java.util.concurrent.Future listCertificateAuthoritiesAsync( ListCertificateAuthoritiesRequest listCertificateAuthoritiesRequest); /** *

* Lists the private certificate authorities that you created by using the CreateCertificateAuthority action. *

* * @param listCertificateAuthoritiesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListCertificateAuthorities operation returned by the service. * @sample AWSACMPCAAsyncHandler.ListCertificateAuthorities * @see AWS API Documentation */ java.util.concurrent.Future listCertificateAuthoritiesAsync( ListCertificateAuthoritiesRequest listCertificateAuthoritiesRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* List all permissions on a private CA, if any, granted to the Certificate Manager (ACM) service principal * (acm.amazonaws.com). *

*

* These permissions allow ACM to issue and renew ACM certificates that reside in the same Amazon Web Services * account as the CA. *

*

* Permissions can be granted with the CreatePermission * action and revoked with the DeletePermission * action. *

*

* About Permissions *

*
    *
  • *

    * If the private CA and the certificates it issues reside in the same account, you can use * CreatePermission to grant permissions for ACM to carry out automatic certificate renewals. *

    *
  • *
  • *

    * For automatic certificate renewal to succeed, the ACM service principal needs permissions to create, retrieve, * and list certificates. *

    *
  • *
  • *

    * If the private CA and the ACM certificates reside in different accounts, then permissions cannot be used to * enable automatic renewals. Instead, the ACM certificate owner must set up a resource-based policy to enable * cross-account issuance and renewals. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
* * @param listPermissionsRequest * @return A Java Future containing the result of the ListPermissions operation returned by the service. * @sample AWSACMPCAAsync.ListPermissions * @see AWS API * Documentation */ java.util.concurrent.Future listPermissionsAsync(ListPermissionsRequest listPermissionsRequest); /** *

* List all permissions on a private CA, if any, granted to the Certificate Manager (ACM) service principal * (acm.amazonaws.com). *

*

* These permissions allow ACM to issue and renew ACM certificates that reside in the same Amazon Web Services * account as the CA. *

*

* Permissions can be granted with the CreatePermission * action and revoked with the DeletePermission * action. *

*

* About Permissions *

*
    *
  • *

    * If the private CA and the certificates it issues reside in the same account, you can use * CreatePermission to grant permissions for ACM to carry out automatic certificate renewals. *

    *
  • *
  • *

    * For automatic certificate renewal to succeed, the ACM service principal needs permissions to create, retrieve, * and list certificates. *

    *
  • *
  • *

    * If the private CA and the ACM certificates reside in different accounts, then permissions cannot be used to * enable automatic renewals. Instead, the ACM certificate owner must set up a resource-based policy to enable * cross-account issuance and renewals. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
* * @param listPermissionsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListPermissions operation returned by the service. * @sample AWSACMPCAAsyncHandler.ListPermissions * @see AWS API * Documentation */ java.util.concurrent.Future listPermissionsAsync(ListPermissionsRequest listPermissionsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists the tags, if any, that are associated with your private CA or one that has been shared with you. Tags are * labels that you can use to identify and organize your CAs. Each tag consists of a key and an optional value. Call * the * TagCertificateAuthority action to add one or more tags to your CA. Call the UntagCertificateAuthority action to remove tags. *

* * @param listTagsRequest * @return A Java Future containing the result of the ListTags operation returned by the service. * @sample AWSACMPCAAsync.ListTags * @see AWS API * Documentation */ java.util.concurrent.Future listTagsAsync(ListTagsRequest listTagsRequest); /** *

* Lists the tags, if any, that are associated with your private CA or one that has been shared with you. Tags are * labels that you can use to identify and organize your CAs. Each tag consists of a key and an optional value. Call * the * TagCertificateAuthority action to add one or more tags to your CA. Call the UntagCertificateAuthority action to remove tags. *

* * @param listTagsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListTags operation returned by the service. * @sample AWSACMPCAAsyncHandler.ListTags * @see AWS API * Documentation */ java.util.concurrent.Future listTagsAsync(ListTagsRequest listTagsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Attaches a resource-based policy to a private CA. *

*

* A policy can also be applied by sharing a private CA through Amazon Web Services Resource Access Manager (RAM). * For more information, see Attach a * Policy for Cross-Account Access. *

*

* The policy can be displayed with GetPolicy and removed * with DeletePolicy. *

*

* About Policies *

*
    *
  • *

    * A policy grants access on a private CA to an Amazon Web Services customer account, to Amazon Web Services * Organizations, or to an Amazon Web Services Organizations unit. Policies are under the control of a CA * administrator. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
  • *

    * A policy permits a user of Certificate Manager (ACM) to issue ACM certificates signed by a CA in another account. *

    *
  • *
  • *

    * For ACM to manage automatic renewal of these certificates, the ACM user must configure a Service Linked Role * (SLR). The SLR allows the ACM service to assume the identity of the user, subject to confirmation against the * Amazon Web Services Private CA policy. For more information, see Using a Service Linked Role with ACM. *

    *
  • *
  • *

    * Updates made in Amazon Web Services Resource Manager (RAM) are reflected in policies. For more information, see * Attach a Policy for Cross-Account * Access. *

    *
  • *
* * @param putPolicyRequest * @return A Java Future containing the result of the PutPolicy operation returned by the service. * @sample AWSACMPCAAsync.PutPolicy * @see AWS API * Documentation */ java.util.concurrent.Future putPolicyAsync(PutPolicyRequest putPolicyRequest); /** *

* Attaches a resource-based policy to a private CA. *

*

* A policy can also be applied by sharing a private CA through Amazon Web Services Resource Access Manager (RAM). * For more information, see Attach a * Policy for Cross-Account Access. *

*

* The policy can be displayed with GetPolicy and removed * with DeletePolicy. *

*

* About Policies *

*
    *
  • *

    * A policy grants access on a private CA to an Amazon Web Services customer account, to Amazon Web Services * Organizations, or to an Amazon Web Services Organizations unit. Policies are under the control of a CA * administrator. For more information, see Using a Resource Based Policy with * Amazon Web Services Private CA. *

    *
  • *
  • *

    * A policy permits a user of Certificate Manager (ACM) to issue ACM certificates signed by a CA in another account. *

    *
  • *
  • *

    * For ACM to manage automatic renewal of these certificates, the ACM user must configure a Service Linked Role * (SLR). The SLR allows the ACM service to assume the identity of the user, subject to confirmation against the * Amazon Web Services Private CA policy. For more information, see Using a Service Linked Role with ACM. *

    *
  • *
  • *

    * Updates made in Amazon Web Services Resource Manager (RAM) are reflected in policies. For more information, see * Attach a Policy for Cross-Account * Access. *

    *
  • *
* * @param putPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutPolicy operation returned by the service. * @sample AWSACMPCAAsyncHandler.PutPolicy * @see AWS API * Documentation */ java.util.concurrent.Future putPolicyAsync(PutPolicyRequest putPolicyRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Restores a certificate authority (CA) that is in the DELETED state. You can restore a CA during the * period that you defined in the PermanentDeletionTimeInDays parameter of the DeleteCertificateAuthority action. Currently, you can specify 7 to 30 days. If you did not specify a * PermanentDeletionTimeInDays value, by default you can restore the CA at any time in a 30 day period. You * can check the time remaining in the restoration period of a private CA in the DELETED state by * calling the DescribeCertificateAuthority or ListCertificateAuthorities actions. The status of a restored CA is set to its pre-deletion status when the * RestoreCertificateAuthority action returns. To change its status to ACTIVE, call the UpdateCertificateAuthority action. If the private CA was in the PENDING_CERTIFICATE state at * deletion, you must use the ImportCertificateAuthorityCertificate action to import a certificate authority into the private CA before it * can be activated. You cannot restore a CA after the restoration period has ended. *

* * @param restoreCertificateAuthorityRequest * @return A Java Future containing the result of the RestoreCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsync.RestoreCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future restoreCertificateAuthorityAsync( RestoreCertificateAuthorityRequest restoreCertificateAuthorityRequest); /** *

* Restores a certificate authority (CA) that is in the DELETED state. You can restore a CA during the * period that you defined in the PermanentDeletionTimeInDays parameter of the DeleteCertificateAuthority action. Currently, you can specify 7 to 30 days. If you did not specify a * PermanentDeletionTimeInDays value, by default you can restore the CA at any time in a 30 day period. You * can check the time remaining in the restoration period of a private CA in the DELETED state by * calling the DescribeCertificateAuthority or ListCertificateAuthorities actions. The status of a restored CA is set to its pre-deletion status when the * RestoreCertificateAuthority action returns. To change its status to ACTIVE, call the UpdateCertificateAuthority action. If the private CA was in the PENDING_CERTIFICATE state at * deletion, you must use the ImportCertificateAuthorityCertificate action to import a certificate authority into the private CA before it * can be activated. You cannot restore a CA after the restoration period has ended. *

* * @param restoreCertificateAuthorityRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RestoreCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsyncHandler.RestoreCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future restoreCertificateAuthorityAsync( RestoreCertificateAuthorityRequest restoreCertificateAuthorityRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Revokes a certificate that was issued inside Amazon Web Services Private CA. If you enable a certificate * revocation list (CRL) when you create or update your private CA, information about the revoked certificates will * be included in the CRL. Amazon Web Services Private CA writes the CRL to an S3 bucket that you specify. A CRL is * typically updated approximately 30 minutes after a certificate is revoked. If for any reason the CRL update * fails, Amazon Web Services Private CA attempts makes further attempts every 15 minutes. With Amazon CloudWatch, * you can create alarms for the metrics CRLGenerated and MisconfiguredCRLBucket. For more * information, see Supported * CloudWatch Metrics. *

* *

* Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you * specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception * is thrown. For more information, see Access policies for * CRLs in Amazon S3. *

*
*

* Amazon Web Services Private CA also writes revocation information to the audit report. For more information, see * CreateCertificateAuthorityAuditReport. *

* *

* You cannot revoke a root CA self-signed certificate. *

*
* * @param revokeCertificateRequest * @return A Java Future containing the result of the RevokeCertificate operation returned by the service. * @sample AWSACMPCAAsync.RevokeCertificate * @see AWS API * Documentation */ java.util.concurrent.Future revokeCertificateAsync(RevokeCertificateRequest revokeCertificateRequest); /** *

* Revokes a certificate that was issued inside Amazon Web Services Private CA. If you enable a certificate * revocation list (CRL) when you create or update your private CA, information about the revoked certificates will * be included in the CRL. Amazon Web Services Private CA writes the CRL to an S3 bucket that you specify. A CRL is * typically updated approximately 30 minutes after a certificate is revoked. If for any reason the CRL update * fails, Amazon Web Services Private CA attempts makes further attempts every 15 minutes. With Amazon CloudWatch, * you can create alarms for the metrics CRLGenerated and MisconfiguredCRLBucket. For more * information, see Supported * CloudWatch Metrics. *

* *

* Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you * specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception * is thrown. For more information, see Access policies for * CRLs in Amazon S3. *

*
*

* Amazon Web Services Private CA also writes revocation information to the audit report. For more information, see * CreateCertificateAuthorityAuditReport. *

* *

* You cannot revoke a root CA self-signed certificate. *

*
* * @param revokeCertificateRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RevokeCertificate operation returned by the service. * @sample AWSACMPCAAsyncHandler.RevokeCertificate * @see AWS API * Documentation */ java.util.concurrent.Future revokeCertificateAsync(RevokeCertificateRequest revokeCertificateRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Adds one or more tags to your private CA. Tags are labels that you can use to identify and organize your Amazon * Web Services resources. Each tag consists of a key and an optional value. You specify the private CA on input by * its Amazon Resource Name (ARN). You specify the tag by using a key-value pair. You can apply a tag to just one * private CA if you want to identify a specific characteristic of that CA, or you can apply the same tag to * multiple private CAs if you want to filter for a common relationship among those CAs. To remove one or more tags, * use the * UntagCertificateAuthority action. Call the ListTags action to see * what tags are associated with your CA. *

* *

* To attach tags to a private CA during the creation procedure, a CA administrator must first associate an inline * IAM policy with the CreateCertificateAuthority action and explicitly allow tagging. For more * information, see Attaching * tags to a CA at the time of creation. *

*
* * @param tagCertificateAuthorityRequest * @return A Java Future containing the result of the TagCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsync.TagCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future tagCertificateAuthorityAsync(TagCertificateAuthorityRequest tagCertificateAuthorityRequest); /** *

* Adds one or more tags to your private CA. Tags are labels that you can use to identify and organize your Amazon * Web Services resources. Each tag consists of a key and an optional value. You specify the private CA on input by * its Amazon Resource Name (ARN). You specify the tag by using a key-value pair. You can apply a tag to just one * private CA if you want to identify a specific characteristic of that CA, or you can apply the same tag to * multiple private CAs if you want to filter for a common relationship among those CAs. To remove one or more tags, * use the * UntagCertificateAuthority action. Call the ListTags action to see * what tags are associated with your CA. *

* *

* To attach tags to a private CA during the creation procedure, a CA administrator must first associate an inline * IAM policy with the CreateCertificateAuthority action and explicitly allow tagging. For more * information, see Attaching * tags to a CA at the time of creation. *

*
* * @param tagCertificateAuthorityRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the TagCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsyncHandler.TagCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future tagCertificateAuthorityAsync(TagCertificateAuthorityRequest tagCertificateAuthorityRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Remove one or more tags from your private CA. A tag consists of a key-value pair. If you do not specify the value * portion of the tag when calling this action, the tag will be removed regardless of value. If you specify a value, * the tag is removed only if it is associated with the specified value. To add tags to a private CA, use the * TagCertificateAuthority. Call the ListTags action to see * what tags are associated with your CA. *

* * @param untagCertificateAuthorityRequest * @return A Java Future containing the result of the UntagCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsync.UntagCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future untagCertificateAuthorityAsync( UntagCertificateAuthorityRequest untagCertificateAuthorityRequest); /** *

* Remove one or more tags from your private CA. A tag consists of a key-value pair. If you do not specify the value * portion of the tag when calling this action, the tag will be removed regardless of value. If you specify a value, * the tag is removed only if it is associated with the specified value. To add tags to a private CA, use the * TagCertificateAuthority. Call the ListTags action to see * what tags are associated with your CA. *

* * @param untagCertificateAuthorityRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UntagCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsyncHandler.UntagCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future untagCertificateAuthorityAsync( UntagCertificateAuthorityRequest untagCertificateAuthorityRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates the status or configuration of a private certificate authority (CA). Your private CA must be in the * ACTIVE or DISABLED state before you can update it. You can disable a private CA that is * in the ACTIVE state or make a CA that is in the DISABLED state active again. *

* *

* Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you * specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception * is thrown. For more information, see Access policies for * CRLs in Amazon S3. *

*
* * @param updateCertificateAuthorityRequest * @return A Java Future containing the result of the UpdateCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsync.UpdateCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future updateCertificateAuthorityAsync( UpdateCertificateAuthorityRequest updateCertificateAuthorityRequest); /** *

* Updates the status or configuration of a private certificate authority (CA). Your private CA must be in the * ACTIVE or DISABLED state before you can update it. You can disable a private CA that is * in the ACTIVE state or make a CA that is in the DISABLED state active again. *

* *

* Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you * specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception * is thrown. For more information, see Access policies for * CRLs in Amazon S3. *

*
* * @param updateCertificateAuthorityRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateCertificateAuthority operation returned by the service. * @sample AWSACMPCAAsyncHandler.UpdateCertificateAuthority * @see AWS API Documentation */ java.util.concurrent.Future updateCertificateAuthorityAsync( UpdateCertificateAuthorityRequest updateCertificateAuthorityRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); }