LightBeam Documentation
Installer GuidesData SourcesPlaybooksInsightsPrivacyOpsGovernance
  • 💡What is LightBeam?
  • 🚀Getting Started
    • ⚙️Installer Guides
      • Pre-Requisites / Security Configurations
        • Firewall Requirements
        • Securing LightBeam on EKS with AWS Certificate Manager on Elastic Load Balancer
        • Configure HTTPS for LightBeam Endpoint FQDN Standalone deployment
        • Using Custom Certificates with LightBeam
        • Securing LightBeam on GKE with Google Certificate Manager and GCE Ingress
      • Core
        • LightBeam Deployment Instructions
        • LightBeam Installer
        • Web App Deployment
        • LightBeam Diagnostics
        • LightBeam Cluster Backup & Restore using Velero
      • Platform Specific
        • AWS
        • Microsoft Azure
        • Google Cloud (GKE)
        • Standalone Virtual Machine
        • Deployment on an Existing Managed Kubernetes Cluster
        • Azure Marketplace Deployment
      • Integration and Setup
        • Setting Up AWS PrivateLink for RDS-EKS Interaction
        • Twingate and LightBeam Integration Guide
        • Data Subject Request Web Application Server
        • Generate CSR for LightBeam
  • 🧠Core Features
    • 🔦Spectra AI
      • 🔗Data Sources
        • Cloud Platforms
          • AWS Auto Discovery
          • GCP Auto Discovery
        • Databases and Datalakes
          • PostgreSQL
          • Aurora (PostgreSQL)
          • Snowflake
          • MS SQL
          • MySQL
          • Aurora (MySQL)
          • BigQuery
          • AWS Redshift
          • Oracle
          • DynamoDB
          • MongoDB
          • CosmosDB (PostgreSQL)
          • CosmosDB (MongoDB)
          • CosmosDB (NoSQL)
          • Looker
          • AWS Glue
          • Databricks
          • SAP HANA
          • CSV Files as a Datasource
        • Messaging
          • Gmail
          • Slack
          • MS Teams
          • MS Outlook
        • Developer Tools
          • Zendesk
          • ServiceNow
          • Jira
          • GitHub
          • Confluence
        • File Repositories
          • NetDocuments
          • AWS S3
          • Azure Blob
          • Google Drive
          • OneDrive
          • SharePoint
          • Viva Engage
          • Dropbox
          • Box
          • SMB
        • CRM
          • Hubspot
          • Salesforce
          • Automated Data Processing (ADP)
          • Marketo
          • Iterable
          • MS Dynamics 365 Sales
          • Salesforce Marketing Cloud
      • 🔔PlayBooks
        • What is LightBeam Playbooks?
        • Policy and Alerts
          • Types of Policies
          • How to create a rule set
            • File Extension Filter
          • Configuring Retention Policies
          • Viewing Alerts
          • Sub Alerts
            • Reassigning Sub-Alerts
            • Sub-alert States
          • Levels of Actions on Alerts
          • User Roles and Permissions
            • Admin View
            • Alert Owner View
            • Onboarding New Users
              • User Management
              • Okta Integration
              • Alert Assignment Settings
              • Email Notifications
            • Planned Enhancements
          • Audit Logs
          • No Scan List
          • Permit List
          • Policy in read-only mode
      • 📊Insights
        • Entity Workflow
        • Document Classification
        • Attribute Management Overview
          • Attributes Page View
          • Attribute Sets
          • Creating Custom Attribute
          • Attributes List
        • Template Builder
        • Label Management
          • MIP Integration
          • Google Labels Integration
      • 🗃️Reporting
        • Delta Reporting
        • Executive Report
        • LightBeam Lens
      • Scanning and Redaction of Files
        • On-demand scanning
      • How-to Guides
        • Leveraging LightBeam insights for structured data sources
      • LightBeam Dashboard Outlay
      • Risk Score
    • 🏛️PrivacyOps
      • Data Subject Request (DSR)
        • What is DSR?
        • Accessing the DSR Module
        • DSR Form Builder (DPO View)
          • Creating a New DSR Form
            • Using a Predefined Template
            • Creating a Custom Form
          • Form Configuration
          • Form Preview and Publishing
          • Multi-Form Management
          • Messaging Templates
        • Form Submission & Email Verification (Data Subject View)
        • DSR Management Dashboard (DPO View)
        • Processing DSR Requests
          • Data Protection Officer (DPO) Workflow
          • Self Service Workflow (Direct Validation)
          • Data Source Owner (DSO) Workflow
        • DSR Report
      • 🚧Consent Management
        • Overview
        • Consent Logs
        • Preference Centre
        • Settings
      • 🍪Cookie Consent
        • Dashboard
        • Banners
        • Domains
        • Settings
        • CMP Deployment Guide for Google Tag Manager
        • FAQs
      • 🔏Privacy Impact Assessment (PIA)
        • PIA Templates
        • PIA Assessment Workflow
        • Collaborator View
        • Process Owner Login View (With Collaborator)
        • Filling questionnaire without collaborator
        • Submitting the assessment for DPO review
        • DPO review process
        • Marking the assessment as reviewed
        • Editing and resubmitting assessments after DPO review
        • Revoke review request
        • Edit Reviewer
        • PIA Reports
      • ⏺️Records of Processing Activity (RoPA)
        • Creating a RoPA Template
          • How to clone a template
          • How to use a template
        • How to create a process
          • Adding Process Details
          • Adding Data Elements
          • Adding Data Subjects
          • Adding Data Retention
          • Adding Safeguards
          • Adding Transfers
          • Adding a Custom Section
          • Setting a Review Schedule
          • Data Flow Diagram
        • How to add a collaborator
        • Overview Section
        • Generating a RoPA Report Using LightBeam
        • Collaborator working on a ticket
    • 🛡️Governance
      • Access
        • Dashboard
        • Users
        • Groups
        • Objects
        • Active Directory Settings
        • Access Governance at a Data Source Level
        • Policies and Alerting
        • Access Governance Statistics
        • Governance Module Dashboard
      • Privacy At Partners
  • 📊Tools & Resources
    • 🔀API Documentation
      • API to Create Reports for Structured Datasource
    • ❓Onboarding Assessments
      • Structured Datasource Onboarding Questionnaire
        • MongoDB/CosmosDB Questionnaire
        • Oracle Datasource Questionnaire
      • SMB Questionnaire
    • 🛠️Administration
      • Audit Logs
      • SMTP
        • Basic and oAuth Configuration
      • User Management
        • SAML Identity Providers
          • Okta
            • LightBeam Okta SAML Configuration Guide
          • Azure
            • Azure AD SAML Configuration for LightBeam
          • Google
            • Google IDP
        • Local User Management
          • Adding a User to the LightBeam Dashboard
          • Reset Default Admin Password
  • 📚Support & Reference
    • 📅Release Notes
      • LightBeam v2.2.0
      • Reporting Release Notes
      • Q1 2024 Key Enhancements
      • Q2 2024 Key Enhancements
      • Q3 2024 Key Enhancements
      • Q4 2024 Key Enhancements
    • 📖Glossary
Powered by GitBook
On this page
  • Overview
  • Scanning Behavior
  • Technical Implementation
  • Connecting Outlook Data Source
  • Inbox and Sent Mail Scanning
  • Appendix
  • About LightBeam
  1. Core Features
  2. Spectra AI
  3. Data Sources
  4. Messaging

MS Outlook

Connecting MS Outlook to LightBeam

Overview

LightBeam Spectra users can connect various data sources to the LightBeam application and these data sources will be continuously monitored for PII, PHI data.

Example: MS Outlook, Gmail, Slack, etc.


Scanning Behavior

LightBeam’s Outlook scanning operates in two modes:

Default Mode

  • Scans only the “Sent Items” folder by default for Outlook datasource.

  • Active by default

Inbox Scanning Mode

  • Controlled by an environment variable.

  • Disabled by default.

  • When enabled:

    • Scans all folders except “Deleted Items.”

    • Includes inbox, sent items, and other user folders.


Technical Implementation

  • Scanning begins automatically after data source configuration.

  • Inbox scanning requires environment variable configuration.

  • Users can be included or excluded from scanning at any time.

  • Inbox Scanning Mode can be enabled/disabled per datasource, with flexible user configuration options post-setup.


Connecting Outlook Data Source

  1. Log in to your LightBeam Instance.

  2. Click on DATASOURCES on the Top Navigation Bar.

  3. Click on Add a Data Source.

  1. Search for “Outlook”.

  1. Click on Outlook.

  1. Fill in the details as shown below and click on Next:

Basic Information

  1. Data Source Name: This is the unique name given to the data source.

  2. Description: This is an optional field needed to describe the use of this data source.

  3. Primary Owner: Email address of the person responsible for this data source which will get alerts by default.

  4. Entity Creation: LightBeam Spectra detects and associates attributes based on the context and identifies whose data it is; these are called entities. Example: Jane Doe is an entity for whom LightBeam Spectra might have detected Name and SSN in a monitored data source.

  5. Source of Truth: LightBeam Spectra would have monitored data sources that contain data acting as a single point of truth and that can be used for looking up entities/attributes which help to identify if the other attributes/entities found in any other data source are accurate or not. A Source of Truth data set would create entities based on the attributes found in the data.

  6. Location: The location of the data source.

  7. Purpose: The purpose of the data being collected/processed.

  8. Stage: The stage of the data source. Example: Source, Processing, Archival, etc.

Datasource Configuration

  1. Provide the credentials as shown below and click on Test Connection.

Connection Details

  • Client Id: It refers to the unique identifier assigned to the Azure portal application that is used for integrating LightBeam with the Outlook data source. It is generated when you register an application in the Azure portal.

  • Client Secret Value: It is a confidential key or password associated with the Azure portal application. It is used to authenticate and authorize the application when accessing Outlook resources. The Client Secret Value is generated when you create a new client secret value in the Azure portal.

  • Scan Data: It refers to a configuration setting that determines the frequency at which the data from the Outlook data source is scanned or updated. In this case, it is mentioned as "10 Minutes", indicating that the data will be scanned or updated every 10 minutes.

  • Tenant Id: It is a unique identifier assigned to the Azure Active Directory (AAD) tenant associated with the organization. It represents the organization's directory or identity store in Azure AD. The Tenant Id is obtained from the Azure portal.

  • Status: It indicates if the current state of the integration between LightBeam and the Outlook data source is currently active or inactive.

  1. Verify that you get the message “Connection Success!”. Click on Next.

  2. In this step, you can choose :

    1. Domain which you want to scan for: This is optional field where you specify the domain name which you want to scan from total detected domains.

    2. Scan selected members and groups: Email address of members and groups which you want include or exclude from scanning.

i) All members and groups

ii) Selected members and grou

To choose option (i), select All members and groups, and click on Save.

Under EXCLUSION LIST FOR SCANNING, you can enter the email addresses of the members and groups you would like to exclude from the scan.

To choose option (ii), select Selected members and groups. Now enter the email address(es) of the member(s) and group(s) that you would like to include for scanning in the Search box individually.

Select the inputs by ticking the checkboxes next to them.

  1. Click on Save.

Now we are ready to browse through the onboarded Outlook datasource dashboard.

Note: To get the Outlook data source details please check Appendix


Inbox and Sent Mail Scanning

LightBeam Spectra now scans both inbox and sent mailboxes for a comprehensive analysis of email data. This enhancement provides a more complete picture of PII and PHI data flow within your organization.

2.1 Dashboard Updates

The dashboard now displays separate counters for sent and received emails containing sensitive information. This allows for a quick overview of potential data exposure risks in both outgoing and incoming communications.

Total Email count, now shows separate counts for Sent and Received emails.

Email(s) with PII count, which on hover displays the breakdown of Sent and Received emails containing PII.

2.2 Email Tab Enhancements

The email tab has been updated to include three main sections:

  1. Sent Emails(Individuals): This tab shows information about emails sent from your organization, including the number of emails with PII/PHI and whether they were shared with external recipients.

  1. Received Emails(Individuals): This new tab displays information about received emails, including those from external senders that may contain sensitive information.

The Card view layout for each user shows PII/PHI email counts and external sharing information.

2.3 External Members Section

The external members section now provides a more comprehensive view of data sharing:

  • Emails Sent: Shows recipient email addresses outside your organization that received emails containing sensitive information.

  • When you click on an item in the "Emails Sent" list, it redirects to the Emails Sent tab with that particular recipient filter applied in the sent mailbox view.

  • Emails Received: Displays sender email addresses from outside your organization that sent emails containing sensitive information to your users.

  • When you click on an item in the "Emails Received" list, which shows senders, it redirects to the Inbox tab with the sender filter applied, showing received emails from that external sender.

This enhanced External Members section gives you a more detailed overview of how sensitive information is shared with or received from external parties.


Appendix

Steps to Generate Outlook Data Source Credentials

  1. Click on Portal.

  1. Click on the Search box on the Top Navigation bar. Type and search for “App Registrations”.

  2. Click on App Registrations.

  1. Click on New Registration. Add details as shown below and click Register.

Make sure that the redirect URL is as follows:

  1. Click on Certificates and secrets.

  2. Click on New client secret.

  3. Fill in the client secret details in the Description and Expires fields.

  4. Click on Add.

  1. Copy the Client Secret value and keep it secure for future use as you will not be able to retrieve it later.

Example: x_sWncr4m~.2lFeKlWR1pu3SgT42lg.254

  1. Configure API Permissions.

Click API permissions -> Add a permission -> Microsoft Graph -> Application permissions -> Add following permissions

Then add the following permissions:

Domain.Read.All
GroupMember.Read.All
Mail.Read
Mail.ReadBasic
Mail.ReadBasic.All
User.Read
User.Read.All
  1. Once permissions are added, click on Grant admin consent for “Lightbeam.ai.”

Now, your application is ready to register.

NOTE: You should be an admin user to approve the permissions. If you’re not an admin user, take admin access or contact the administrator.

Click on Overview and get the Application Client Id and the Directory Tenant Id.

With this, we have all the required configuration parameters like Client ID, Client Secret, Tenant ID, and Delegated credentials (User Email ID) to onboard the Outlook data source to LightBeam.

This is the request body for the OneDrive registration. Replace Tenant ID, Client ID and Client Secret Key with the appropriate values.

{
"Configuration": {
"name": "Outlook",
"location": "India",
"datasourceType": "Outlook",
"microsoftOfficeConfig": {
"clientId": "CLIENT_ID",
"clientSecret": "CLIENT_SECRET",
"tenantId": "TENANT_ID",
"accountType": "organization",
"delegatedCredential": "EMAIL_ID"
}
}
}

Here, delegatedCredential is the email of a logged-in user who has created the Application/Admin Owner.

Success Tip: We recommend creating a dedicated Azure portal application specifically for integrating LightBeam with the Outlook data source. This application should be exclusively used for this purpose and not shared or repurposed for any other clients or applications. By doing so, you ensure secure and efficient access control, as well as maintain proper management of the LightBeam-Outlook connection.


About LightBeam

LightBeam automates Privacy, Security, and AI Governance, so businesses can accelerate their growth in new markets. Leveraging generative AI, LightBeam has rapidly gained customers’ trust by pioneering a unique privacy-centric and automation-first approach to security. Unlike siloed solutions, LightBeam ties together sensitive data cataloging, control, and compliance across structured and unstructured data applications providing 360-visibility, redaction, self-service DSRs, and automated ROPA reporting ensuring ultimate protection against ransomware and accidental exposures while meeting data privacy obligations efficiently. LightBeam is on a mission to create a secure privacy-first world helping customers automate compliance against a patchwork of existing and emerging regulations.

PreviousMS TeamsNextDeveloper Tools

Last updated 4 months ago

Figure 1. Add Data Source
Figure 2. Search Outlook
Figure 2.1 Outlook
Figure 3. LightBeam Outlook- Basic Information
Figure 5.2 LightBeam Outlook - Scan Settings
Figure 5.3 LightBeam Outlook - Scan Settings

Received Emails(Groups): This tab provides insights into emails sent to group addresses within your organization (e.g., , ). It shows the number of PII/PHI emails for each group.

Log in to

Figure 9. Microsoft Azure Portal
Figure 10. Click on App Registrations
Figure 11. Register an application

Figure 12. Add a client secret value
Figure 13. Client secret value
Figure 15. Onboard Datasource to LightBeam

For any questions or suggestions, please get in touch with us at: .

🧠
🔦
🔗
hr@company.com
all_employees@company.com
https://azure.microsoft.com/en-gb/
https://login.microsoftonline.com/common/oauth2/nativeclient
support@lightbeam.ai
Figure 4. LightBeam Outlook - Test Connection
Figure 5.1 LightBeam Outlook - Scan Settings
Figure 6. Updated Dashboard - Total Email count
Figure 6.1. Updated Dashboard - Email(s) with PII count
Figure 7. Emails Tab Enhancement
Figure 7.1 Emails Tab Enhancement - Sent Emails
Figure 7.2 Emails Tab Enhancement - Received Emails(Individuals)
Figure 7.3 Emails Tab Enhancement - Received Emails(Groups)
Figure 8. External Members
Figure 8. External Members - Emails Sent
Figure 8.1 External Members - Mailbox View with Recipient Filter
Figure 8.2 External Members - Emails Received
Figure 8.3 External Members - Inbox View with Sender Filter
Figure 14. Admin consent for “Lightbeam.ai.”