3rd party integrations (Google, Microsoft)

Modified on Tue, 27 Aug at 12:02 PM

This knowledge base will not be updated after 27 August. You can find the new knowledge base on: knowledgebase.portflow.app


TABLE OF CONTENTS


Google Drive integration

Description

Functionality 

Users can add files to their portfolio directly from their Google Drive (personal/work/school) cloud storage.

Advantage 

This makes it easy to directly upload files from Google Drive to the portfolio without the need to download it to the local machine and upload it afterward.

Location 

In a collection, or on the ‘My evidence’ tab > ‘Add evidence’ > ‘File upload’ > ‘Open Google Drive’

Availability 

This is a feature option. Portflow admins can enable or disable this feature in the admin panel. Disabling the feature does not impact previously imported files from Google Drive.


Data

The integration processes the following data:

DataSourceDestinationStorage
User e-mail address for Google AccountUser (direct input)GoogleN/A
User password for Google AccountUser (direct input)GoogleN/A
Selected file metadataGooglePortflowNot stored by Drieam, only file URL used to request the file object.
Selected files (objects)GooglePortflowOnly selected files are stored in Portflow storage.
Authorization token to access the cloud storageGooglePortflowThis is not stored by Drieam, can be stored in the browser’s cache by Google.

Portflow’s use and transfer of information received from Google APIs (to any other app) will adhere to Google API Services User Data Policy, including the Limited Use requirements.


Protocol/API 

For this integration, we make use of the following Google Drive API Scopes:

  • https://www.googleapis.com/auth/drive.readonly - View and download all your Drive files.


End of use

  • Access from Portflow to your Google Account and Google Drive can be revoked in Google's My Account settings under Security > Your Connections to Third-Party Apps and Services (https://myaccount.google.com/connections)

Microsoft OneDrive integration

Description

Functionality 

Users can add files to their portfolio directly from their OneDrive (personal/work/school) cloud storage.

Advantage 

This makes it easy to directly upload files from OneDrive to the portfolio without the need to download it to the local machine and upload it afterward.

Location 

In a collection, or on the ‘My evidence’ tab > ‘Add evidence’ > ‘File upload’ > ‘Open OneDrive’

Availability 

This is a feature option. Portflow admins can enable or disable this feature in the admin panel. Disabling the feature does not impact previously imported files from OneDrive.


Data

The integration processes the following data:

DataSourceDestinationStorage
User e-mail address for Microsoft AccountUser (direct input)MicrosoftN/A
User password for Microsoft AccountUser (direct input)MicrosoftN/A
Selected file metadataMicrosoft (OneDrive)PortflowNot stored by Drieam, only file URL used to request the file object.
Selected files (objects)Microsoft (OneDrive)PortflowOnly selected files are stored in Portflow storage.
Authorization token to access the cloud storageMicrosoftPortflowThis is not stored by Drieam, can be stored in the browser’s cache by Microsoft.

 

Protocol/API 

For this integration, we make use of the following Microsoft API permissions


Microsoft Graph (used for personal OneDrive accounts):

  • Files.Read.All - Read all files that the user can access (own files and files that are shared with them)

SharePoint (used for professional/institution OneDrive/SharePoint accounts):

  • MyFiles.Read - Read user files
  • AllSites.Read - Read items in all site collections (required to access files that are shared with the user)

End of use

  • Personal OneDrive permissions can be revoked by users by removing Portflow from the apps and services they have given acces to in their Microsoft account (account.live.com/consent/Manage).
  • Professional OneDrive permissions can be revoked by organization admins in Microsoft Entra admin center (entra.microsoft.com) under Enterprise applications (look for Portflow).




Google OAuth for Alumnus Login

Description

Functionality 

Users can link their personal Google account to Portflow to allow them to sign in to Portflow after graduation.

Advantage 

Keep access to your portfolio after graduation, also see Log in to Portflow.

Location 

In the main menu, click the user avatar and choose 'Alumnus Login'.

Availability 

This is a feature option. Portflow admins can enable or disable this feature in the admin panel. Disabling the feature will disallow access from linked Google accounts to Portflow.


Data

The integration processes the following data:

DataSourceDestinationStorage
User e-mail address for Google Account
User (direct input)GoogleN/A
PortflowOnly used to send an email to notify that the account has been linked to Portflow. This is not stored in the Portflow database.
User password for Google AccountUser (direct input)GoogleN/A
UID (OAuth Unique Identifier)GooglePortflowStored in Portflow database as long as it is not disabled, linked to the user in Portflow.

No data is transferred from the institution towards Google. Google does not get any information about the institution or user apart from the fact that they have authorized Google to be used to sign in at Portflow. 


Protocol

Google OAuth


End of use

  • Users can unlink Google from their Portflow account by unlinking Google as their alumnus login provider. This removes the stored data in Portflow.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article