- DarkLight
You can use cryptographic keys stored and managed in your AWS account KMS to encrypt your organization's data stored in Gong.
For Gong to use the external KMS keys, two conditions must be met:
The KMS should have a policy that allows a Gong-owned principal (specifically an IAM role), to use the KMS with a set of predefined permissions, for example, Encrypt or Decrypt.
The principal should have an attached policy to use the KMS with appropriate permissions.
To meet these conditions, your administrator must set up the KMS in your AWS account as explained in this article.
Required permissions
This table explains the permissions we need for your key and why:
Permission | Why we need the permission |
---|---|
| To enable Gong to store encrypted files for your organization. |
| To enable Gong to verify that the key is a symmetric key that meets requirements. |
| To enable Gong to list existing grants for the CMK. |
| To enable Gong to delegate permissions dynamically from the ExternalCmkAccessGranter principal to the various services in Gong that store and read encrypted data. |
| To enable Gong to remove the created grant, retire in regular cases, and revoke if some services get forcefully shutdown. |
Create and configure your CMK
Make sure your region is us-east-1.
In AWS KMS, create a symmetric encryption.
When you are asked to add a policy, paste the following snippet to enable access from the Gong AWS account:
{ "Sid": "Allow Gong.io to use this CMK", "Effect": "Allow", "Principal": { "AWS":"arn:aws:iam::655275192472:role/ExternalCmkAccessGranter" }, "Action":[ "kms:Decrypt", "kms:Encrypt", "kms:RevokeGrant", "kms:GenerateDataKey", "kms:DescribeKey", "kms:RetireGrant", "kms:CreateGrant", "kms:ListGrants" ], "Resource": "*" }
After the KMS is created, make a note of the KMS ARN, for example:
arn:aws:kms::1234567890:key/12345678-90ab-cdef-1234-123456789ab
Gong uses this key to encrypt all new S3 files stored in your organization’s Gong account. Existing files will not be re-encrypted.
This key is used to encrypt your organization's data in Gong.