- Sync Gong users (including deactivated users), and each workspace’s permission profiles with their members
- Review Gong permission profile membership in access reviews
- Set the right resource owners for each workspace and permission profile
Supported resources
This is a read-only integration. Opal can’t grant or revoke Gong permission profiles. Gong’s API has no endpoint that assigns a user to a permission profile or removes them from one. Its API can only read profiles and their members. In Gong, profiles are assigned in the Admin center or by Gong’s team member provisioning, which applies a profile to each member of an identity provider group.To manage Gong access through Opal, map an Okta or Microsoft Entra ID group to a permission profile in Gong’s team member provisioning, with Update settings set to Automatic updates. Then manage that group in Opal with the Okta or Azure integration. When a user gains or loses the group, Gong updates their permission profile.
How Gong access maps to Opal
- Workspaces: each Gong workspace is a resource, with its permission profiles nested under it.
- Permission profiles: each profile is a resource, and its members are the users Gong lists for that profile. A user holds one permission profile in each workspace they belong to.
- Users: Opal syncs all Gong users returned by the API, including deactivated users. Deactivated users can still hold permission profiles in Gong, so they remain visible for reviews.
Requirements
Before you begin, you must:- Be an Opal Admin
- Be a Gong Technical Administrator, which is the only role that can create API keys
- Ask the Opal team to enable the Gong integration for your organization
Configuration steps
1. Create a Gong API key
- In Gong, go to Admin center > Settings > Ecosystem > API, and select + Get API key.
- Name the key, for example
Opal. Leave the expiration empty, because Opal stops syncing when the key expires. - Leave Trusted IPs empty unless you’ve confirmed Opal’s outbound IP addresses with the Opal team. Gong rejects calls from any other address.
- Select Get API key, then copy the Access key and Access key secret. Gong shows the secret only once.
- On the same page, copy your API base URL, for example
https://us-12345.api.gong.io. You’ll enter its first part,us-12345, in Opal.
2. Create the Gong app in Opal
In Opal, go to Inventory > +App and select Gong. Fill in the following fields:
Opal checks the API key when you save the app.