OneLogin

OneLogin is an Identity Management provider that supplies a comprehensive set of enterprise-grade identity and access management solutions, including single sign-on (SSO), user provisioning, and multi-factor authentication. The Sumo Logic App for OneLogin provides real-time visibility and analysis of OneLogin user activity through event data, such as user logins, administrative operations, and provisioning.

Prerequisites

note

To use this feature, you'll need to enable access to your OneLogin logs and ingest them into Sumo Logic.

Once you begin uploading data, your daily data usage will increase. It's a good idea to check the Account page in Sumo Logic to make sure that you have enough quota to accommodate additional data in your account. If you need additional quota you can upgrade your account at any time.

• OneLogin Enterprise or Unlimited plan subscription.
• Configure an Event Broadcaster
  • Add a Sumo Logic Hosted Collector to your Sumo Logic Org.
  • Configure an HTTP Source for your OneLogin data. Make sure to set the Source Category when configuring the OneLogin source. For example, onelogin.
  • From OneLogin, configure a broadcaster that points to this endpoint using the instructions in the OneLogin documentation. You must use SIEM (NDJSON) format. Use the Sumo Logic HTTP Source URL as the Listener URL, and custom header is not needed.

Log Types and Sample Log Message

The Sumo Logic App for OneLogin uses event logs in NDJSON format. Each event is a single-line JSON, containing information such as:

{
    "event":{
        "create":{
            "_id":"443ce874-7704-54d2-b12f-b6e4a72ec6ef"
        },
        "entity":null,
        "role_id":null,
        "client_id":null,
        "trusted_idp_name":null,
        "notes":null,
        "app_name":null,
        "service_directory_id":null,
        "actor_system":"",
        "login_name":null,
        "assuming_acting_user_id":null,
        "mapping_name":null,
        "directory_sync_run_id":null,
        "api_credential_name":null,
        "directory_id":null,
        "certificate_id":null,
        "group_id":null,
        "role_name":null,
        "imported_user_name":null,
        "resolved_at":null,
        "mapping_id":null,
        "authentication_factor_type":null,
        "user_field_name":null,
        "proxy_ip":null,
        "certificate_name":null,
        "task_name":null,
        "adc_id":null,
        "uuid":"443ce874-7704-54d2-b12f-b6e4a72ec6ef",
        "note_title":null,
        "event_timestamp":"2017-03-21 00:09:27+0000",
        "actor_user_name":"Peyton Newton",
        "proxy_agent_id":null,
        "otp_device_name":null,
        "actor_user_id":11826257,
        "trusted_idp_id":null,
        "imported_user_id":null,
        "policy_type":null,
        "user_id":11826257,
        "resource_type_id":null,
        "login_id":null,
        "solved":null,
        "policy_id":null,
        "policy_name":null,
        "otp_device_id":null,
        "radius_config_name":null,
        "app_id":null,
        "user_name":"Peyton Newton",
        "account_id":22348,
        "resolved_by_user_id":null,
        "radius_config_id":null,
        "error_description":null,
        "note_id":null,
        "param":null,
        "event_type_id":11,
        "proxy_agent_name":null,
        "privilege_id":null,
        "user_field_id":null,
        "authentication_factor_description":null,
        "ipaddr":"137.219.197.240",
        "custom_message":null,
        "directory_name":null,
        "object_id":null,
        "group_name":null,
        "resolution":null,
        "privilege_name":null,
        "authentication_factor_id":null,
        "adc_name":null
    }
}

Sample Query

Name - Events by User

_sourceCategory=onelogin
| json "event.event_type_id", "event.app_name","event.ipaddr", "event.user_name", "event.actor_user_name" as event_id, app_name, src_ip, user_name, actor_user_name  
| where event_id in ("10","11")
| count by user_name
| sort by _count

Install the Sumo Logic App

Now that you have set up collection for OneLogin, install the Sumo Logic App for OneLogin to use the preconfigured searches and dashboards that provide insight into your data.

To install the app:

1. From the left nav, select App Catalog.
   
2. Search for your app name and select it.
3. When you get to your app page:
   • If you want to see a preview of the dashboards included with the app before installing, scroll down to Dashboard Preview.
   • If your Sumo Logic app has multiple versions (not all apps do), select the version of the service you're using.
     
   • Click Add Integration.
     
4. On the next configuration page, Select Data Source for your App, complete the following fields:
   • Data Source. Select one of the following options:
     • Choose Source Category, and select a source category from the list; or
     • Choose Enter a Custom Data Filter, and enter a custom source category beginning with an underscore. For example, _sourceCategory=MyCategory.
   • Folder Name. You can retain the existing name or enter a custom name of your choice for the app.
   • All Folders (optional). Default location is the Personal folder in your Library. If desired, you can choose a different location and/or click New Folder to add it to a new folder.
5. Click Next.
   
6. You'll see a dialog confirming that the app was installed successfully.
   

Once an app is installed, it will appear in your Personal folder, or other folder that you specified. From here, you can share it with your organization.

Panels will start to fill automatically. It's important to note that each panel slowly fills with data matching the time range query and received since the panel was created. Results won't be available immediately, but within 20 minutes, you'll see full graphs and maps.

Viewing OneLogin Dashboards

The Sumo Logic App for OneLogin helps you monitor the overall health of your OneLogin deployment. Dashboards keep an eye on errors being generated by back-end applications as well as errors generated from ELB instances. The OneLogin App offers three dashboards to help you track OneLogin events.

Overview

Visitor Locations. See the count and location of visitor IP addresses over the last 24 hours on the world map.

Events by App. See events from the last 24 hours by application name in a pie chart and compare app usage.

Logins by Country. See the count of number of logins by country name displayed in a table to get an idea of your visitor traffic by country in the last 24 hours.

Event Outlier Over Time. See the events that fall outside the normal range for the last 24 hours.

Failed Login Outlier. See any logins over the last 24 hours that fall outside the specified failed login threshold.

Successful Login Outlier. See any logins over the last 24 hours that fall outside the specified successful login threshold.

Top 10 Users by Events. View the top 10 users by number of events for the last 24 hours to identify heavy activity.

App Monitoring

Event Distribution by App. See the percentage of events by application in the last 24 hours as a pie chart to identify the event distribution by apps having the most events recently.

Event Distribution by Event ID. See the percentage of each user action by Event ID for the last 24 hours as a pie chart to identify the apps having the most activity recently.

Logins by App. See the percentage of logins by application in the last 24 hours as a pie chart to identify the apps having the most events recently.

Top 10 Provisioning Errors and Warnings. See the top 10 provisioning error messages and warnings issued by OneLogin by count for the last 24 hours.

Failed Actions. See the error descriptions of failed actions and a count of the occurrence for the last 24 hours displayed in a table to identify possible issues.

Security

User Activity. View the count of user activities by username as a bar chart for the last 24 hours as a bar chart to quickly identify unusual user activity.

Password Changes. See the count of password changes by username as a bar chart for the last 24 hours to quickly identify any unusually high numbers of password changes by a particular user.

Logins by Country. View the count of the logins by country in the last 24 hours to identify any unusual activity by country.

Users Created in Apps. See the number of users created in applications in the last 24 hours as a column chart. You can filter by app name to track the count of a particular app.

Assumed Users. View the details such as the timestamp, destination user, notes, source user, and count for the event when one user acted as another user in the last 24 hours.

Failed Logins. See the number of login failures by username in the last 24 hours on a bar chart to identify any unusual activity. You can filter by username as needed.

Successful Logins. See the number of successful logins by username in the last 24 hours to identify any unusual activity. You can filter by username as needed.

User Modifications. See user modifications by timestamp, destination user, source user, notes, and error description for the last 24 hours displayed in table. You can filter by time, user name, source user, or error description as needed to track unusual behavior.