Begin Scanning a Microsoft Exchange App
Table of Contents
Expand all | Collapse all
-
-
- What’s Data Security?
- Navigate To Data Security in Cloud Management Console
- Activate Data Security on the Hub
- Access Data Security for Standalone SaaS Security
-
- Allowed List of IP Addresses
-
- Begin Scanning an Amazon Web Services App
- Begin Scanning a Bitbucket Cloud App
- Begin Scanning a Box App
- Begin Scanning a Cisco Webex Teams App
- Begin Scanning a Citrix ShareFile App
- Begin Scanning a Confluence App
- Begin Scanning a Confluence Data Center App
- Begin Scanning a Dropbox App
- Begin Scanning a GitHub App
- Begin Scanning a GitHub V2 App
- Begin Scanning a Gmail App
- Begin Scanning a Google Cloud Storage App
- Begin Scanning a Google Drive App
- Begin Scanning a Jira Cloud App
- Begin Scanning a Jira Data Center App
- Begin Scanning a Microsoft Azure Storage App
- Begin Scanning a Microsoft Exchange App
- Begin Scanning Microsoft Office 365 Apps
- Begin Scanning a Microsoft Teams App
- Begin Scanning a Salesforce App
- Begin Scanning a ServiceNow App
- Begin Scanning a Slack for Enterprise Grid App
- Begin Scanning a Slack Enterprise App
- Begin Scanning a Slack for Pro and Business App
- Begin Scanning a Workday App (Beta)
- Begin Scanning a Yammer App
- Begin Scanning a Zendesk App
- Begin Scanning a Zoom App
- Reauthenticate to a Cloud App
- Verify Permissions on Cloud Apps
- Start Scanning a Cloud App
- Stop Scanning a Cloud App
- Rescan a Managed Cloud App
- Delete Cloud Apps Managed by Data Security
- API Throttling
- Configure Classification Labels
-
-
-
- SaaS Security with Enterprise DLP
- Predefined Data Patterns on Data Security
- Proximity Keywords
- Confidence Levels
- Shared Data Profiles and Data Patterns
- Modify a Predefined Data Pattern
- Create a Custom Data Profile
- Add a File Property Data Pattern
- Create a Custom Data Pattern
- Use Exact Data Matching (EDM)
- Enable or Disable a Machine Learning Data Pattern
- Configure WildFire Analysis
- Configure Regular Expressions
- Enable or Disable a Data Pattern
- View and Filter Data Pattern Match Results
-
-
-
- What is an Incident?
- Assess New Incidents on Data Security
- View Asset Details
- Filter Incidents
- Security Controls Incident Details
- Track Down Threats with WildFire Report
- Track Down Threats with AutoFocus
- Customize the Incident Categories
- Close Incidents
- Download Assets for Incidents
- View Asset Snippets for Incidents
- Analyze Inherited Exposure
- Email Asset Owners
- Modify Incident Status
-
- What is a Data Violation?
- Assess New Data Violations on Data Security
- Configure Data Violation Alerts on Data Security
- Filter Data Violations on Data Security
- View Asset Snippets for Data Violations on Data Security
- View Data Violation Metrics on Data Security
- Modify Data Violation Status on Data Security
-
-
-
-
- What’s SaaS Security Inline?
- Navigate To SaaS Security Inline
- SaaS Visibility for NGFW
- SaaS Visibility and Controls for NGFW
- SaaS Visibility for Prisma Access
- SaaS Visibility and Controls for Panorama Managed Prisma Access
- SaaS Visibility and Controls for Cloud Managed Prisma Access
- Activate SaaS Security Inline for NGFW
- Activate SaaS Security Inline for VM-Series Firewalls with Software NGFW Credits
- Activate SaaS Security Inline for Prisma Access
- Connect SaaS Security Inline and Cortex Data Lake
- Integrate with Azure Active Directory
-
-
- SaaS Policy Rule Recommendations
- App-ID Cloud Engine
- Guidelines for SaaS Policy Rule Recommendations
- Predefined SaaS Policy Rule Recommendations
- Apply Predefined SaaS Policy Rule Recommendations
- Create SaaS Policy Rule Recommendations
- Delete SaaS Policy Rule Recommendations
- Enable SaaS Policy Rule Recommendations
- Modify Active SaaS Policy Rule Recommendations
- Monitor SaaS Policy Rule Recommendations
-
- Enable Automatic Updates for SaaS Policy Rule Recommendations on Cloud Managed Prisma Access
- Import New SaaS Policy Rule Recommendations on Cloud Managed Prisma Access
- Update Imported SaaS Policy Rule Recommendations on Cloud Managed Prisma Access
- Remove Deleted SaaS Policy Rule Recommendations on Cloud Managed Prisma Access
- Manage Enforcement of Rule Recommendations on NGFW
- Manage Enforcement of Rule Recommendations on Panorama Managed Prisma Access
- Change Risk Score for Discovered SaaS Apps
-
-
-
-
- Onboarding Overview for Supported SaaS Apps
- Onboard an Aha.io App to SSPM
- Onboard an Alteryx Designer Cloud App to SSPM
- Onboard an Aptible App to SSPM
- Onboard an ArcGIS App to SSPM
- Onboard an Articulate Global App to SSPM
- Onboard an Atlassian App to SSPM
- Onboard a BambooHR App to SSPM
- Onboard a Basecamp App to SSPM
- Onboard a Bitbucket App to SSPM
- Onboard a BlueJeans App to SSPM
- Onboard a Box App to SSPM
- Onboard a Bright Security App to SSPM
- Onboard a Celonis App to SSPM
- Onboard a Cisco Meraki App to SSPM
- Onboard a ClickUp App to SSPM
- Onboard a Confluence App to SSPM
- Onboard a Contentful App to SSPM
- Onboard a Convo App to SSPM
- Onboard a Couchbase App to SSPM
- Onboard a Coveo App to SSPM
- Onboard a Crowdin Enterprise App to SSPM
- Onboard a Customer.io App to SSPM
- Onboard a Databricks App to SSPM
- Onboard a Datadog App to SSPM
- Onboard a DocHub App to SSPM
- Onboard a DocuSign App to SSPM
- Onboard a Dropbox Business App to SSPM
- Onboard an Envoy App to SSPM
- Onboard an Expiration Reminder App to SSPM
- Onboard a Gainsight PX App to SSPM
- Onboard a GitHub Enterprise App to SSPM
- Onboard a GitLab App to SSPM
- Onboard a Google Analytics App to SSPM
- Onboard a Google Workspace App to SSPM
- Onboard a GoTo Meeting App to SSPM
- Onboard a Grammarly App to SSPM
- Onboard a Harness App to SSPM
- Onboard a Hellonext App to SSPM
- Onboard an IDrive App to SSPM
- Onboard an Intercom App to SSPM
- Onboard a Jira App to SSPM
- Onboard a Kanbanize App to SSPM
- Onboard a Kanban Tool App to SSPM
- Onboard a Kustomer App to SSPM
- Onboard a Lokalise App to SSPM
- Onboard a Microsoft Azure AD App to SSPM
- Onboard a Microsoft Exchange App to SSPM
- Onboard a Microsoft OneDrive App to SSPM
- Onboard a Microsoft Outlook App to SSPM
- Onboard a Microsoft Power BI App to SSPM
- Onboard a Microsoft SharePoint App to SSPM
- Onboard a Microsoft Teams App to SSPM
- Onboard a Miro App to SSPM
- Onboard a monday.com App to SSPM
- Onboard a MongoDB Atlas App to SSPM
- Onboard a MuleSoft App to SSPM
- Onboard a Mural App to SSPM
- Onboard an Office 365 App to SSPM
- Onboard Office 365 Productivity Apps to SSPM
- Onboard an Okta App to SSPM
- Onboard a PagerDuty App to SSPM
- Onboard a RingCentral App to SSPM
- Onboard a Salesforce App to SSPM
- Onboard an SAP Ariba App to SSPM
- Onboard a ServiceNow App to SSPM
- Onboard a Slack Enterprise App to SSPM
- Onboard a Snowflake App to SSPM
- Onboard a SparkPost App to SSPM
- Onboard a Tableau Cloud App to SSPM
- Onboard a Webex App to SSPM
- Onboard a Workday App to SSPM
- Onboard a Wrike App to SSPM
- Onboard a YouTrack App to SSPM
- Onboard a Zendesk App to SSPM
- Onboard a Zoom App to SSPM
- Onboarding an App Using Azure AD Credentials
- Onboarding an App Using Okta Credentials
- Delete SaaS Apps Managed by SSPM
Begin Scanning a Microsoft Exchange App
Use
Data Security
to scan and identify incidents
found when scanning assets and email attachments in your MS Exchange
app.To connect a Microsoft Exchange app to
Data Security
and begin scanning assets, you need to:- Ensure that you have a Microsoft Exchange or Office 365 account with Global Admin role.
- Grant Exchange API access toData Security.
- Add the Exchange app toData Security.
As
of July 2020, the Exchange integration on
Data Security
is now
updated to optimize the permissions required for cloud app features.
To revoke unnecessary permissions that you granted previously and
that Data Security
no longer needs, reauthenticate the
Exchange app.Add Microsoft Exchange App
In order for
Data Security
to scan assets,
you must consent to the following permissions during the course
of adding the Exchange app:API | Permission | Description |
---|---|---|
Microsoft Graph API | Read all users' basic profiles | Retrieves basic user information such as display name, email address, and User-ID to display user
information on People page. |
Read all users' full profiles | Allows Data Security to make a user API call. Data Security uses this permission
for both Graph API and Outlook Legacy REST API. Additionally, allows Data Security to retrieve detailed user information (For example, user
principle name (UPN), job title, office location, phone
number, etc.), but Data Security discards all this
information except for UPN, which Data Security needs to
retrieve user mailbox settings. | |
Read all user mailbox settings | Retrieves each user's mailbox settings (For
example, retention policy settings, email forward settings, public
folder access settings, and delegate rules settings), and then determines
if there is any security risk in those settings. | |
Read mail in all mailboxes | Retrieves and scan the user's email. | |
Read all hidden memberships | Not currently used, but Data Security
plans to use this permission to detect memberships of hidden groups. | |
Read all groups | Not currently used, but Data Security
plans to use this permission to scan group properties and detect
the members in the group. | |
Read calendars in all mailboxes | Allows Data Security to access attachments
in calendar events. | |
Use Exchange Web Services with full access
to all mailboxes | Retrieves each user's mailbox settings (For
example, inbox rules and eDiscovery search configuration), and then
determines if there is any security risk in those settings. Data Security plans to use this permission to determine if the user owns any
public folders. | |
Read directory data | Allows Data Security to retrieve and scan for a list of users and groups. Data Security
uses this permission for both Azure Active Directory Legacy
API and Graph API. | |
Read activity data for your organization | Allows Data Security to read and log
activity data to display activity data on Activities page. |
- (Recommended) Add your Exchange domain as an internal domain.
- Log in to Microsoft Exchange or Office 365 using an account with privileges that will enable communication betweenData Securityand the Microsoft Exchange app.Before you can establish communication betweenData Securityand the Exchange app, you must:
- Go to http://portal.microsoftonline.com and log out of Exchange or Office 365.
- Log in to Exchange or Office 365 using an account that has the Global Admin role before adding the Exchange app toData Security.
- Add the Exchange app.
- Log in to SaaS Security.
- Add the Microsoft Exchange app. Go to.Data SecurityApplicationsAdd ApplicationMicrosoft Exchange
- Enter the login credentials for the account with Global Admin role privileges on the Microsoft online page to whichData Securityredirects you.
- Review andAcceptthe changes thatData Securitycan perform on your assets in Microsoft Exchange.Data Securityrequires these permissions to scan your assets on Exchange app.
- Next step: Proceed to Customize Microsoft Exchange App.
Troubleshooting Onboarding for Microsoft Exchange App
To ensure that your app has onboarded correctly without any issues in authentication
or permissions, Data Security performs validation checks between the onboarding and
scanning process. You can start scanning only after a successful validation. For
Microsoft Exchange, the following two validations happen:
- App Authentication
- Validating Permissions
After the validation is successful, Data Security displays sample assets and sample
activities.
If you don't have any subscriptions, you will not see any User activities in the
validation page. It might take up to 12 hours for the first content blobs to
become available. For more information, see Office 365 Management Activity API
reference.
If the
App Authentication
or Validating
Permissions
check fails, try the following:- Ensure you have administrator permissions.
- Check if Palo Alto Networks application is listed in the list of Enterprise Applications. Following are the app names for specific regions:
- USA: Aperture by Palo Alto Networks - Exchange
- Japan: Palo Alto Networks NG-CASB - JP - Exchange
- EU: Aperture by Palo Alto Networks - Exchange
- India: Palo Alto Networks NG-CASB - India - Exchange
- APAC: Aperture by Palo Alto Networks - Exchange
- UK: Palo Alto Networks NG-CASB - UK - Exchange
- Australia: Palo Alto Networks NG-CASB - AUS - Exchange
- If Palo Alto Networks application is not listed, check if the Audit Logs Activity displays asConsent to application, Target as<app from the list given above>, and Status asSuccess.
See the following table to understand the errors you are facing during
validation.
Error Codes | Description |
---|---|
Errors in App Authentication | |
invalid_request | Request is invalid. |
invalid_grant | Internal error encountered. |
unauthorized_client | The installed app in the Marketplace was uninstalled manually
from your cloud app. |
invalid_client | Issue related to Marketplace instance. |
temporarily_unavailable | Microsoft Exchange app issue on the server side. Please
reinstall. |
Errors in fetching sample assets and activities (warning
messages only) | |
accessDenied | Access is denied for ${user}. |
activityLimitReached | App's API limit reached. Try after sometime. |
invalidRange | You don't have any thing to get for this entity. |
invalidRequest | Request is invalid. |
itemNotFound | No data associated with this entity. |
notAllowed | Authentication failure while retrieving the entity. |
notSupported | Getting entity with required information no longer supported. |
serviceNotAvailable | Microsoft Exchange server is not responding. |
quotaLimitReached | Quota for app request has been exhausted for now. |
unauthenticated | Microsoft Exchange app issue from server side. |
If the issue persists, contact SaaS Security Technical Support.
Customize Microsoft Exchange App
- (Optional) Give a descriptive name to this app instance.
- Select the Exchangen link on the Cloud Apps list.
- Enter a descriptiveNameto differentiate this instance of Exchange from other instances you are managing.
- ClickDoneto save your changes.
- Next step: Proceed to Identify Risks.
Identify Risks
When you add a new cloud app and enable scanning,
Data Security
automatically scans the cloud app against the
default data patterns and displays the match occurrences. You can
take action now to improve your scan results and identify risks.- Start scanning the new Exchange app for risks.All email attachments in Exchange are scanned based on defined policy rules. Email content is scanned based on defined policy rules only if the sender or receiver of the email is from an external domain. Scanning only starts on installation, and assets without risks are not stored.
- During the discovery phase,Data Securityscans files and matches them against enabled default policy rules.Verify that your default policy rules are effective. If the results don’t capture all risks or you see false positives, improve the results.
- (Optional) Modify match criteria for existing policy rules.
- (Optional) Add new policy rules.Consider the business use of your cloud app, then identify risks unique to your enterprise. As necessary, add new:
- (Optional) Configure or edit a data pattern.You can Configure Data Patterns to identify specific strings of text, characters, words, or patterns to make it possible to find all instances of text that match a data pattern you specify.