Integration documentation for: OneDrive

OneDrive Integration Documentation for DataMapper 

 

1. Overview 

Description:

The DataMapper OneDrive integration enables seamless data extraction and analysis from Microsoft OneDrive environments using the Microsoft Graph API. This integration allows users to scan, analyze, and manage data within their OneDrive accounts, enhancing data governance and compliance.

 

Purpose:

This integration is useful for organizations looking to streamline their data discovery processes within OneDrive. It solves the problem of manually managing and assessing data for compliance and risk by automating the scanning and reporting of sensitive information within OneDrive storage. 

 

2. Installation and Setup 

Prerequisites: 

  • Microsoft 365 subscription with OneDrive access. 
  • Administrator privileges in Microsoft Azure Active Directory (Azure AD) and OneDrive. 
  • DataMapper account with administrative rights. 

Step-by-Step Guide: 

  1. Admin Authentication: 
  • An administrator logs into the DataMapper account. 
  • Navigate to the integration settings and select OneDrive. 
  • Click on the "Authenticate" button to start the authentication process. 
  • The admin will be redirected to the Microsoft login page. 
  • Log in with administrative credentials and grant the required permissions for DataMapper to access OneDrive on behalf of the organization. 

  1. Invite Users: 
  • From the DataMapper dashboard, invite users to authenticate with their OneDrive credentials. 
  • Users will receive an email invitation to authenticate and authorize DataMapper. 

Screenshots/Diagrams: 

  • Screenshots and diagrams can be included to visually guide users through each step (e.g., admin authentication, user invitation). 

 

3. Functionality 

Core Features: 

  • Automated Data Scanning: Automatically scans selected OneDrive accounts. 
  • Risk Identification: Identifies and reports files containing sensitive or risky data. 
  • Monitoring: Continuously monitors OneDrive storage and updates results daily. 
  • Detailed Reports: Generates comprehensive reports for data governance and compliance. 

How it Works: 

  • Admin authenticates the integration, granting organization-wide access. 
  • Users authenticate and select OneDrive folders for scanning. 
  • DataMapper uses Microsoft Graph API to access and analyze the selected data. 
  • Results are displayed in the DataMapper dashboard, highlighting files with potential risks. 
  • The integration continuously monitors the selected OneDrive accounts and updates the analysis results daily. 

Use Cases: 

  • Compliance Audits: Regularly scan OneDrive accounts for compliance with data protection regulations (e.g., GDPR, HIPAA). 
  • Data Management: Identify and manage sensitive information within OneDrive storage. 
  • Risk Mitigation: Proactively address data security risks by identifying sensitive files. 

 

4. Usage Instructions 

Daily Operations: 

  • Log into DataMapper and check the dashboard for recent scan results. 
  • Review flagged items and take necessary actions (e.g., move, delete, or secure sensitive files). 

Best Practices: 

  • Regularly update permissions and review access controls in OneDrive. 
  • Schedule frequent scans to ensure up-to-date data analysis. 
  • Educate users on the importance of data governance and compliance.

Troubleshooting: 

  • Authentication Issues: Ensure users have proper OneDrive permissions and that the app is registered correctly in Azure AD. 
  • Scan Errors: Check API permissions and ensure that DataMapper has the necessary access. 
  • Support: Contact DataMapper support for assistance with integration issues. 

 

5. Limitations 

Known Limitations: 

  • The integration relies on Microsoft Graph API, which may have rate limits affecting scan frequency. 
  • Only scans data accessible via the authenticated user's permissions. 

Compatibility Issues: 

  • Ensure compatibility with the latest versions of OneDrive and Microsoft 365. 

Performance Considerations: 

  • Large OneDrive accounts may experience longer scan times. 

 

6. Security and Compliance 

Data Security: 

  • DataMapper uses secure authentication and encrypted connections to protect data during integration.
  • Access permissions are managed through Azure AD, ensuring secure and controlled access. 

Compliance: 

  • Integration adheres to GDPR, HIPAA, and other relevant data protection regulations. 
  • Regular updates and audits are recommended to maintain compliance. 

 

7. Costs 

Additional Costs: 

  • No additional costs for the integration itself, but users must have appropriate Microsoft 365 and OneDrive subscriptions. 

Licensing: 

  • DataMapper and Microsoft 365 licensing requirements must be met. 

Cost Management Tips: 

  • Monitor and optimize usage to avoid unnecessary expenses. 
  • Review and adjust licensing needs periodically. 

 

8. Updates and Maintenance 

Update Process: 

  • DataMapper and Microsoft regularly release updates; ensure both are kept up-to-date. 
  • Follow update instructions provided by DataMapper and Microsoft. 

Maintenance Requirements: 

  • Regularly review integration settings and permissions. 
  • Schedule periodic scans and audits. 

Support: 

  • DataMapper offers support through its customer service portal. 
  • Microsoft provides support for Azure and OneDrive through their respective channels. 

 

9. FAQs 

Common Questions: 

  • Q: What permissions are required for the integration? 
  • A: The integration requires delegated permissions such as Files.Read.All and Files.ReadWrite.All.

 

  • Q: How often should scans be scheduled? 
  • A: It depends on the organization's needs; regular weekly scans are recommended. 

Further Resources: 

 

10. Contact Information 

Questions? Please do reach out at support@safeonline.dk if you have any questions regarding integrations for DataMapper.

Still need help? Contact Us Contact Us