Axonius Documentation
Start typing to search…

Auth0

Auth0 provides authentication and authorization solutions for web, mobile, and legacy applications.

Asset Types Fetched

  • Users

Before You Begin

Ports

  • TCP port 80/443

Authentication Method

  • Client ID/Client Secret

APIs

Axonius uses the Get Users API.

To get API Access tokens, see Get Management API Access Tokens for Production.

📘

Note

Before getting the API Access tokens, you need to register your machine-to-machine app with Auth0 according to the instructions in Permissions.

Permissions

The value supplied in Client ID must have read:users permissions to fetch assets.

For additional required permissions, see Advanced Settings.

You must do the following before configuring the Auth0 adapter connection screen:

  1. Register a new machine-to-machine application with Auth0 and authorize it:Follow steps 1 to 3. In step 3, select the Auth0 Management API, and click Authorize.
  2. Create credentials using the Post method: Select the Client Secret (Post) method.
  3. Get a Management API token
  4. Authorize the Management API to use the credentials, by enabling the settings in the screen below. (Access this page through this path: Applications → API → Management API → Machine to Machine Applications.)
Auth0ManagementAPI
  1. Once enabled, enter the updated credentials into the Adapter connection screen.

Supported From Version

Supported from Axonius version 4.7

Connecting the Adapter in Axonius

To connect the adapter in Axonius, provide the following parameters:

Required Parameters

  1. Host Name or IP Address - The hostname or IP address of the Auth0 server.
  2. Client ID and Client Secret - The credentials for a user account that has the Required Permissions to fetch assets. To obtain the Client ID and Client Secret, follow the instructions in Authentication API, using the Post method.
Auth0

Optional Parameters

  1. 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.

  2. HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.

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

  4. HTTPS Proxy Password - 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

📘

Note

Advanced settings can either apply to all connections for this adapter, or to a specific connection. Refer to ​Advanced Configuration for Adapters.

  1. Fetch User Roles - Select this option to fetch user roles. Read permissions for roles are required for this setting.
  2. Fetch Organization Members - Select this option to fetch organization members as Axonius users. If Fetch User Roles is enabled, the adapter will also fetch the roles of the organization members.
📘

Note

The following permissions are required for the Fetch Organization Members setting:

  • read:organization_member_roles

  • read:organizations OR read:organizations_summary

  1. Exclude users that are not organization members - Select this option to not fetch users that are not part of an organization.
📘

Note

To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.

Updated about 8 hours ago