Your first time using draw.io with Google Drive


When you select Google Drive as your storage mechanism in draw.io the next splash screen you'll be faced with is
 


Click the Authorize button to allow draw.io to access your Google Drive account (read down for more about permissions and privacy). Select the Remember me tickbox if you want the authorization to Google Drive to be remembered on your current browser (as a cookie). If you want draw.io to forget your Google Drive authorization later on,  when logged in your name appears in the top right pull down.
 



Selecting Sign Out will de-authorize your current login to Google (it won't disconnect the application from your Drive).
 

After clicking authorize you'll be presented with the Google Accounts chooser if you're currently logged into more than Google account. Click on the account you wish to use. Note that the Accounts chooser has a bug (and it's Google's bug) that requires you to click the user, wait for a reload and then click the user again. Google are aware of the issue; free feel to vote on the bug.

draw.io and Google Drive permissions

 

If you have not previously authorized the application against your Google Drive you'll see this screen:
 

You must accept these permissions in order to use Google Drive as your storage for draw.io, but you'll only need to accept them once per account. Much effort was focused on getting these permissions down to the absolute minimum. The details of each permission are:
 

  1. View your basic profile info. This is provides your name, Google ID, gender, timezone, language, country, profile image and profile URL. We display your name and profile image on the client. We do not pass any of this information up to our servers, ever. 
  2. View and manage Google Drive files that you have opened or created with this app. This means if you created the file with draw.io, draw.io has the permission to open it again. It also means if you open a draw.io diagram with the picker in the application, or open someone else's diagram in drive.google.com, the diagram opens and draw.io has access permissions to the file from now on.
        This permission is important because it means (unlike most other Drive linked applications) that we do not have access, read or write, to all the rest of your Drive files. This strictly limits the security scope of the application. It does have the downside that if you are sent a link to a draw.io file in Drive and click on it, it won't open. This is because if you didn't create it, and have not previously opened it, you need to go to drive.google.com, select Shared with me and open the file. The solution to this would be to allow draw.io access to your entire Drive; however we believe that the security benefits of the current method outweigh this inconvenience. 
  3. Add itself to Google Drive. The permission is implicit to the whole permissions operation, it means add the application as one that is able to interact with your Drive using the above permissions, it's not a new permission in it's own right.

Changing your storage settings
 


Once you are authorized you'll see the new/open dialog. See the Starting draw.io section for a description of how to use this.
 

If you decide to switch default storage mechanism at any later point, navigate to the application web page and you'll see this dialog. Click on Not using Google Drive and your storage selection will be forgotten and the initial storage splash displayed. If you want to change Google user, either log out using the pull down at the top right, or click on Change user in the new/open dialog.

Working with files in Google Drive
 

In the Google Drive Management Screen you can create and open draw.io diagram files as you would native Google files. You can select a folder on the left-hand side and then select NEW -> More to be offered draw.io options.



 

The application will open at the new diagram dialog. The file will exist in the folder you initially selected.
 

To open an existing file, either double click the file in the user interface, or right click the file and select Open with to pick the draw.io version to use.