Overview
- OneDrive from the M365 suite of products contains important documents that need to be frequently backed up.
- Using the LegacyFlo OneDrive-S3-ZIP request type, you can now backup files from any user's OneDrive to a S3 bucket in your AWS account.
Step 1: Preparing your S3 bucket
A. Create an S3 bucket on AWS
Create your S3 bucket in a supported region and allow list and write access to LegacyFlo. The steps for the same are given in the links below:
- Get an AWS account.
- Create an S3 bucket in a region supported by Mithi.
- Set a temporary bucket policy to allow LegacyFlo to get the name and region of the buckets as mentioned here.
- When the S3 bucket is used as a source, give list and read access to the objects on the bucket and when the S3 bucket is used as a destination, allow list and write access to LegacyFlo. The steps to do so are mentioned here.
B. Register your S3 bucket as a source/destination S3 bucket on LegacyFlo
For LegacyFlo to upload data to your S3 bucket, it needs to be added to as a destination S3 bucket in LegacyFlo. The steps for doing the same are as given below:
- Login to LegacyFlo
- Click on the Initials icon on the top of the left-most pane.
- Select Register S3 bucket
- Click on Add S3 bucket button. A dialog box will pop-up
- On the Prepare Bucket page, you will be shown the list of steps to be completed to create and grant access to the S3 bucket. Confirm that you have done as instructed and click on I confirm that the above configuration is complete.
- Click Continue
- On the Configure, Verify & Save page, give the Bucket Name and select the Bucket Region.
- Click Verify. LegacyFlo will check the access to the bucket.
- If LegacyFlo cannot access the bucket, you will be shown an error message similar to All access to this object has been disabled. Check S3 access rights and name and retry.
- If the connection is successful then click on Save. LegacyFlo will remember this S3 for further requests.
Step 2: Getting access to the OneDrive data
This is a two-step process, in which you generate the API key (one time) and grant OneDrive access for all the accounts whose OneDrive data needs to be accessed
Step 1: Get access to the M365 Graph API
Step 2: Make the user's OneDrive content available for access via the API(This step has to be done for all users whose OneDrive data needs to be accessed.)
Step 3: Submitting a LegacyFlo request
You can submit requests to back up OneDrive data using the LegacyFlo interface.
The request type to be used is OneDrive-S3-ZIP.
The parameters for the request are as follows:
Source Information
| FIELD NAME | DESCRIPTION | SAMPLE VALUE |
|---|---|---|
| User ID | User id on OneDrive domain whose data needs to be imported (Note: The id should not contain the domain name.) | "john" |
| Domain | Source domain on M365 | "baya.com" |
| OneDrive Folder name | The folder from which data needs to backed up on the destination. All the contents of this folder and its subfolders will be backed up. Note that the folder name should not start with a /. If all the OneDrive data is to be backed up, leave this value empty | "23-Jun-2020" |
Filter Information
| FIELD NAME | DESCRIPTION | SAMPLE VALUE |
|---|---|---|
| Since (DD-MMM-YYYY) | If this field is left blank, all the files in the source will be added to the backup. If this field has a valid input, then all files which were created or modified since the date specified will be added to the backup. | "31-JAN-2022" |
Other Information
| FIELD NAME | DESCRIPTION | SAMPLE VALUE |
|---|---|---|
| Send report to | A valid email id to which status reports are sent | john@baya.com |
Destination Information
| FIELD NAME | DESCRIPTION |
|---|---|
| S3 bucket name | The S3 bucket for the destination file. Select the S3 bucket name from the drop-down list. The list will show
|
| S3 folder path | If the file has to be created on the Vaultastic Open Store, then this parameter will have the name of your Vaultastic domain. Example: baya-com.vaultastic.com If the file is to be created on your own bucket, give the folder which will contain the file. Leave this value empty if the destination file has to be created on the root of the S3 bucket. NOTE: S3 folder path should not start or end with a "/" |
| File name | The destination filename. The file that will contain the results of the LegacyFlo command NOTE: Filenames should not start or end with a "/" |
Step 3 (optional): Submitting multiple LegacyFlo requests to backup data for multiple users
To upload multiple jobs using a CSV, create a CSV file with a list of all the users and other details required to upload data.