Auth0

Auth0 is an identity provider and a API -based data source. Its logs can produce CloudService documents.

To set up Auth0, you’ll need to:

  1. Configure Auth0 to send data to your Collector.
  2. Set up the Auth0 event source in InsightIDR.
  3. Verify the configuration works.

Configure Auth0 to send data to your Collector

To configure Auth0 for InsightIDR, sign-in to Auth0 and take the following actions from the dashboard:

  1. Set up a machine-to-machine application: This will provide the credentials needed to access the Management API. For instructions, see "Create and Authorize Machine-to-Machine Applications for Management API" in the Auth0 documentation: https://auth0.com/docs/tokens/management-api-access-tokens/create-and-authorize-a-machine-to-machine-application

  2. Define token settings for the JSON Web Token: To authenticate to an API endpoint, you'll need a JSON Web Token scopes. The default timeout for the token is around ten hours (36000 seconds). Since the data source fetches a new token on each run, you can safely reduce the timeout down to one hour or less. You can follow the steps listed in this documentation by Auth0 to manage API Access Tokens: https://auth0.com/docs/tokens/management-api-access-tokens

  3. Authorize a Machine-to-Machine application: Select these roles: read:logs, read:logs_users, read:users, read:user_idp_tokens. You can follow the steps listed in this documentation by Auth0: https://auth0.com/docs/tokens/management-api-access-tokens/get-management-api-access-tokens-for-production

Configure InsightIDR to collect data from the event source

After you complete the prerequisite steps and configure the event source to send data, you must add the event source in InsightIDR.

To configure the new event source in InsightIDR:

  1. From the left menu, go to Data Collection and click Setup Event Source > Add Event Source.
  2. Do one of the following:
    • Search for Auth0 in the event sources search bar.
    • In the Product Type filter, select Cloud Service.
  3. Select the Auth0 event source tile.
  4. Select your collector and Auth0 from the event source dropdown.
  5. Name your event source.
  6. Optionally choose to send unparsed data.
  7. Select your LDAP account attribution preference.
  8. Specify the user domain that will use the access tokens you set up in the Before your Begin step.
  9. Select a credential you set up in the Before your Begin step.
  10. Click Save.

Verify the configuration

Complete the following steps to view your logs and ensure events are making it to the Collector:

  1. Click Data Collection in the left menu of InsightIDR and navigate to the Event Sources tab. Find the new event source that was just created and click the View Raw Log button. If you see log messages in the box, then this shows that logs are flowing to the Collector.
  2. Click Log Search in the left menu of InsightIDR.
  3. Select the applicable Log Sets and the Log Names within them. The Log Name will be the name you gave to your event source. Auth0 logs flow into the Cloud Service Activity log set.

Please note that logs take at least 7 minutes to appear in Log Search after you set up the event source. If you see log messages when you select View Raw Log on the event source but do not see any log messages in Log Search after waiting for a few minutes for them to appear, then your logs do not match the recommended format and type for this event source.