RingCentral

RingCentral provides cloud-based communication and collaboration products and services including phone, messaging, video meetings, and contact center.

Types of Assets Fetched

This adapter fetches the following types of assets:

• Devices
• Users
• Application Settings

Parameters

1. Host Name or IP Address (required, default: https://platform.ringcentral.com) - The hostname or IP address of the RingCentral server that Axonius can communicate with via the Required Ports.

2. Client ID and Client Secret (required) - Credentials with permissions to fetch assets. You need to create an App to access the API and associate client details. Refer to Configuring apps to use JWT.

3. JWT Token (required) - A JWT Token. Refer to Creating a personal JWT credential. Assign ReadAccounts permissions for this app when creating the token.

4. User Name and Password (optional) - The credentials for a user account that has the Required Permissions to fetch assets.

5. User managed by SSO - Toggle on if the user is managed by an SSO. If this option is selected, SSO Provider and 2FA Secret are displayed.
   a. SSO Provider (only used to fetch application settings) - From the dropdown, select which SSO provider you use to manage your users, either Google SSO or Other SSO. For more information, see Connecting your SSO Solution Provider.
   b. 2FA Secret (only used to fetch application settings) (optional) - The secret generated in RingCentral for setting up 2-factor authentication for the adapter user created to collect SaaS Management data.

6. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

7. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

8. HTTPS Proxy User Name (optional) - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

9. HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

1. Fetch devices - Select this option to fetch devices.
2. Fetch Application Settings - By default Axonius fetches application settings. Clear this option to not fetch application settings.

APIs

Axonius uses the RingCentral API.

Required Ports

Axonius must be able to communicate with the value supplied in Host Name or IP Address via the following ports:

• TCP port 80/443
  
  

Required Permissions

The value supplied in Client ID must be associated with credentials that have

• ReadAccounts - in order to fetch users
• ReadUserDevices - in order to fetch devices

In order for the adapter to fetch assets properly, follow this procedure:

1. Log in to developers.ringcentral.com.
2. Go to Console at the top-right corner of the screen.
3. Click on any of your applications. A dashboard opens.
4. In the left column, go to Settings. The Settings page opens with App configuration information.
5. Scroll to the bottom of the page to the Security section and Application Scopes within it.
6. Enter the required permission in Application Scopes.

Supported From Version

Supported from Axonius version 6.0