Get-PASBYOKPolicyStatement

Get-PASBYOKPolicyStatement

SYNOPSIS

Retrieves the AWS KMS key policy statements required for BYOK.

SYNTAX

Get-PASBYOKPolicyStatement [[-region] <String>] [<CommonParameters>]

DESCRIPTION

Retrieves the AWS policy statements that allow the CyberArk BYOK service to access your AWS KMS key.

Copy the returned policy statement into your KMS key policy, ensuring both the ‘Allow Encryption of customer data by CyberArk’ and ‘Allow Decryption of customer data by CyberArk’ statements are included.

For a Cross-Region Disaster Recovery (CRDR) environment, run this twice - once for the main region and once for the recovery region - using the -region parameter.

Requires one of the following roles:

  • System Administrator (Identity Administration)
  • Privilege Cloud Administrator
  • Privilege Cloud Administrator Basic
  • Privilege Cloud Administrator Lite

EXAMPLES

EXAMPLE 1

Get-PASBYOKPolicyStatement

Retrieves the key policy statement for the main region.

EXAMPLE 2

Get-PASBYOKPolicyStatement -region recovery

Retrieves the key policy statement for the recovery region of a CRDR environment.

PARAMETERS

-region

The region of the CRDR site to retrieve the key policy statement for.

Optional when retrieving the statement for the main site (defaults to main). Required when retrieving the statement for the recovery site.

Type: String
Parameter Sets: (All)
Aliases:
Accepted values: main, recovery

Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

https://pspas.pspete.dev/commands/Get-PASBYOKPolicyStatement

https://docs.cyberark.com/snapshot/ispss-deployment/en/content/privilege%20cloud/privcloud-byok-api-key-policy-statement.htm

https://docs.cyberark.com/snapshot/ispss-deployment/en/content/privilege%20cloud/privcloud-byok-api-key-policy-statement-crdr.htm