# Generated by default/object.tt package Paws::ACMPCA::CrlConfiguration; use Moose; has CustomCname => (is => 'ro', isa => 'Str'); has Enabled => (is => 'ro', isa => 'Bool', required => 1); has ExpirationInDays => (is => 'ro', isa => 'Int'); has S3BucketName => (is => 'ro', isa => 'Str'); has S3ObjectAcl => (is => 'ro', isa => 'Str'); 1; ### main pod documentation begin ### =head1 NAME Paws::ACMPCA::CrlConfiguration =head1 USAGE This class represents one of two things: =head3 Arguments in a call to a service Use the attributes of this class as arguments to methods. You shouldn't make instances of this class. Each attribute should be used as a named argument in the calls that expect this type of object. As an example, if Att1 is expected to be a Paws::ACMPCA::CrlConfiguration object: $service_obj->Method(Att1 => { CustomCname => $value, ..., S3ObjectAcl => $value }); =head3 Results returned from an API call Use accessors for each attribute. If Att1 is expected to be an Paws::ACMPCA::CrlConfiguration object: $result = $service_obj->Method(...); $result->Att1->CustomCname =head1 DESCRIPTION Contains configuration information for a certificate revocation list (CRL). Your private certificate authority (CA) creates base CRLs. Delta CRLs are not supported. You can enable CRLs for your new or an existing private CA by setting the B parameter to C. Your private CA writes CRLs to an S3 bucket that you specify in the B parameter. You can hide the name of your bucket by specifying a value for the B parameter. Your private CA copies the CNAME or the S3 bucket name to the B extension of each certificate it issues. Your S3 bucket policy must give write permission to ACM Private CA. ACM Private CA assets that are stored in Amazon S3 can be protected with encryption. For more information, see Encrypting Your CRLs (https://docs.aws.amazon.com/acm-pca/latest/userguide/PcaCreateCa.html#crl-encryption). Your private CA uses the value in the B parameter to calculate the B field in the CRL. The CRL is refreshed at 1/2 the age of next update or when a certificate is revoked. When a certificate is revoked, it is recorded in the next CRL that is generated and in the next audit report. Only time valid certificates are listed in the CRL. Expired certificates are not included. CRLs contain the following fields: =over =item * B: The current version number defined in RFC 5280 is V2. The integer value is 0x1. =item * B: The name of the algorithm used to sign the CRL. =item * B: The X.500 distinguished name of your private CA that issued the CRL. =item * B: The issue date and time of this CRL. =item * B: The day and time by which the next CRL will be issued. =item * B: List of revoked certificates. Each list item contains the following information. =over =item * B: The serial number, in hexadecimal format, of the revoked certificate. =item * B: Date and time the certificate was revoked. =item * B: Optional extensions for the CRL entry. =over =item * B: Reason the certificate was revoked. =back =back =item * B: Optional extensions for the CRL. =over =item * B: Identifies the public key associated with the private key used to sign the certificate. =item * B: Decimal sequence number for the CRL. =back =item * B: Algorithm used by your private CA to sign the CRL. =item * B: Signature computed over the CRL. =back Certificate revocation lists created by ACM Private CA are DER-encoded. You can use the following OpenSSL command to list a CRL. C -noout> =head1 ATTRIBUTES =head2 CustomCname => Str Name inserted into the certificate B extension that enables the use of an alias for the CRL distribution point. Use this value if you don't want the name of your S3 bucket to be public. =head2 B Enabled => Bool Boolean value that specifies whether certificate revocation lists (CRLs) are enabled. You can use this value to enable certificate revocation for a new CA when you call the CreateCertificateAuthority (https://docs.aws.amazon.com/acm-pca/latest/APIReference/API_CreateCertificateAuthority.html) action or for an existing CA when you call the UpdateCertificateAuthority (https://docs.aws.amazon.com/acm-pca/latest/APIReference/API_UpdateCertificateAuthority.html) action. =head2 ExpirationInDays => Int Validity period of the CRL in days. =head2 S3BucketName => Str Name of the S3 bucket that contains the CRL. If you do not provide a value for the B argument, the name of your S3 bucket is placed into the B extension of the issued certificate. You can change the name of your bucket by calling the UpdateCertificateAuthority (https://docs.aws.amazon.com/acm-pca/latest/APIReference/API_UpdateCertificateAuthority.html) action. You must specify a bucket policy (https://docs.aws.amazon.com/acm-pca/latest/userguide/PcaCreateCa.html#s3-policies) that allows ACM Private CA to write the CRL to your bucket. =head2 S3ObjectAcl => Str Determines whether the CRL will be publicly readable or privately held in the CRL Amazon S3 bucket. If you choose PUBLIC_READ, the CRL will be accessible over the public internet. If you choose BUCKET_OWNER_FULL_CONTROL, only the owner of the CRL S3 bucket can access the CRL, and your PKI clients may need an alternative method of access. If no value is specified, the default is C. I This default can cause CA creation to fail in some circumstances. If you have have enabled the Block Public Access (BPA) feature in your S3 account, then you must specify the value of this parameter as C, and not doing so results in an error. If you have disabled BPA in S3, then you can specify either C or C as the value. For more information, see Blocking public access to the S3 bucket (https://docs.aws.amazon.com/acm-pca/latest/userguide/PcaCreateCa.html#s3-bpa). =head1 SEE ALSO This class forms part of L, describing an object used in L =head1 BUGS and CONTRIBUTIONS The source code is located here: L Please report bugs to: L =cut