AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::ACMPCA::Permission

CfnPermission

Grants permissions to the Certificate Manager ( ACM ) service principal ( `acm.amazonaws.com` ) to perform [IssueCertificate](https://docs.aws.amazon.com/privateca/latest/APIReference/API_IssueCertificate.html) , [GetCertificate](https://docs.aws.amazon.com/privateca/latest/APIReference/API_GetCertificate.html) , and [ListPermissions](https://docs.aws.amazon.com/privateca/latest/APIReference/API_ListPermissions.html) actions on a CA. These actions are needed for the ACM principal to renew private PKI certificates requested through ACM and residing in the same AWS account as the CA. **About permissions** - If the private CA and the certificates it issues reside in the same account, you can use `AWS::ACMPCA::Permission` 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 permissions. - 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 AWS Private CA](https://docs.aws.amazon.com/privateca/latest/userguide/pca-rbp.html) . > To update an `AWS::ACMPCA::Permission` resource, you must first delete the existing permission resource from the CloudFormation stack and then create a new permission resource with updated properties.

Import

import { CfnPermission } from 'aws-cdk-lib/aws-acmpca';

Or use the module namespace:

import * as acmpca from 'aws-cdk-lib/aws-acmpca';
// acmpca.CfnPermission

Properties

Configuration passed to the constructor as CfnPermissionProps.

actionsRequired
string[]

The private CA actions that can be performed by the designated AWS service. Supported actions are `IssueCertificate` , `GetCertificate` , and `ListPermissions` .

certificateAuthorityArnRequired
string | ICertificateAuthorityRef

The Amazon Resource Number (ARN) of the private CA from which the permission was issued.

principalRequired
string

The AWS service or entity that holds the permission. At this time, the only valid principal is `acm.amazonaws.com` .

sourceAccountOptional
string

The ID of the account that assigned the permission.

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter