Skip to content

Commit

Permalink
Updating documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
KoenZomers committed Oct 28, 2019
1 parent dc856db commit ed6a4c8
Show file tree
Hide file tree
Showing 5 changed files with 21 additions and 1 deletion.
19 changes: 19 additions & 0 deletions Faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,25 @@ It utilizes the Microsoft Graph oAuth Device Code Flow. If you want the deep tec

If you just want to understand the basic idea, it works as follows. When you choose this option when setting up the synchronization of your KeePass database with your OneDrive Consumer or OneDrive for Business site, the KeePass plugin will connect to the Microsoft Graph API to request a device login session. This will return a short unique identifier which will be shown to you by this plugin in your KeePass. You then open any internet browser you would like and navigate to the internet address shown in the KeePass dialog, which will typically be https://microsoft.com/devicelogin. You can even do this from any other device such as your tablet or phone. Enter the ID that is shown to you by the plugin in KeePass and go through the normal authentication process for your OneDrive Consumer or OneDrive for Business site. This process has full support for multi factor authentication and other identity providers you or your school or organization may have put in place such as AD FS, Ping Federate or one of the many others. Once authenticated, it may ask you to confirm granting the permission to access your files without you having to log on again to my plugin which will identify itself as "Koen Zomers OneDrive Sync v2". Once you grant it these rights, depending on how you have set up your account, it can be that you get a push notification on your phone, a text message on your phone and/or an e-mail stating that a new logon has just taken place under your account to the application "Koen Zomers OneDrive Sync v2". From here on the sync process works exactly like before.

### What shortcut keys can I use in the OneDriveSync dialog box ###

As of version 2.0.8.0 you can use these shortcut keys to quickly find your way in the OneDriveSync dialog box

- F1: Opens the sync details screen. Only works when one KeePass database is selected.
- F2: Allows renaming of the storage name for the KeePass database(s) you have selected
- F4: Starts syncing the selected entries, if those databases are currently open in KeePass
- F5: Refreshes the list with configuration entries
- F7: Open the local file locations of the KeePass database(s) you have selected
- F8: Open the selected KeePass database(s) in KeePass (new feature)
- DEL: Remove the KeePass OneDriveSync configuration entries for the selected KeePass database(s). It will not remove the KeePass database itself, just the KeePass OneDriveSync configuration for it.
- CTRL+A: Select all KeePass databases
- CTRL+SHIFT+A: Select all KeePass databases that no longer exist locally (red colored background)
- CTRL+Click: Select another KeePass database
- SHIFT+Click: Select all KeePass databases between the currently selected one and the one you're clicking on
- Use the right click menu to select all KeePass databases that haven't synced in either the last 24 hours, last week, last 2 weeks or last month

![](./Screenshots/KeePassOneDriveSyncConfigurationOptions.png)

### Other questions ###

Feel free to e-mail me at koen@zomers.eu or [open a GitHub Issue](https://github.com/KoenZomers/KeePassOneDriveSync/issues/new)
Binary file modified KeeOneDriveSync.plgx
Binary file not shown.
1 change: 1 addition & 0 deletions KoenZomers.KeePass.OneDriveSync.sln
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Screenshots", "Screenshots"
Screenshots\ConfigurationsOverview.png = Screenshots\ConfigurationsOverview.png
Screenshots\CredentialManagerControlPanel.png = Screenshots\CredentialManagerControlPanel.png
Screenshots\KeePassCheckForUpdates.png = Screenshots\KeePassCheckForUpdates.png
Screenshots\KeePassOneDriveSyncConfigurationOptions.png = Screenshots\KeePassOneDriveSyncConfigurationOptions.png
Screenshots\KeePassOneDriveSyncOptions.png = Screenshots\KeePassOneDriveSyncOptions.png
Screenshots\KeePassPluginUpToDate.png = Screenshots\KeePassPluginUpToDate.png
Screenshots\KeePassProxyOptions.png = Screenshots\KeePassProxyOptions.png
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ public partial class OneDriveGraphDeviceLoginForm : Form
/// <summary>
/// URL to link the More information link to
/// </summary>
private const string _moreInformationUrl = "https://github.com/KoenZomers/KeePassOneDriveSync/blob/master/Faq.md";
private const string _moreInformationUrl = "https://github.com/KoenZomers/KeePassOneDriveSync/blob/master/Faq.md#how-does-the-microsoft-graph-any-browser-option-work";

/// <summary>
/// URL to send a POST request to in order to retrieve a Device ID Code from Microsoft Graph
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit ed6a4c8

Please sign in to comment.