diff --git a/docs/images/authorise_client_after_paste_hashed_out.png b/docs/images/authorise_client_after_paste_hashed_out.png index 8519e180..a4b0bce7 100644 Binary files a/docs/images/authorise_client_after_paste_hashed_out.png and b/docs/images/authorise_client_after_paste_hashed_out.png differ diff --git a/docs/images/authorise_client_before_copy_with_arrow.png b/docs/images/authorise_client_before_copy_with_arrow.png index 1d80e4ab..890c122e 100644 Binary files a/docs/images/authorise_client_before_copy_with_arrow.png and b/docs/images/authorise_client_before_copy_with_arrow.png differ diff --git a/docs/images/authorise_client_now_authorised_hashed_out.png b/docs/images/authorise_client_now_authorised_hashed_out.png index 901493ed..30315ed7 100644 Binary files a/docs/images/authorise_client_now_authorised_hashed_out.png and b/docs/images/authorise_client_now_authorised_hashed_out.png differ diff --git a/docs/images/initial_auth_url_access_redacted.png b/docs/images/initial_auth_url_access_redacted.png index b0a91134..f606e7ab 100644 Binary files a/docs/images/initial_auth_url_access_redacted.png and b/docs/images/initial_auth_url_access_redacted.png differ diff --git a/docs/images/microsoft-auth-display-message.png b/docs/images/microsoft-auth-display-message.png new file mode 100644 index 00000000..4614ff0b Binary files /dev/null and b/docs/images/microsoft-auth-display-message.png differ diff --git a/docs/usage.md b/docs/usage.md index 71db4544..e9faf700 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -362,7 +362,11 @@ This client supports the following methods to authenticate the application with #### Interactive Authentication using OAuth2 and a redirect URI When you run the application for the first time, you'll be prompted to open a specific URL in your web browser. This URL takes you to the Microsoft login page, where you’ll sign in with your Microsoft Account and grant the application permission to access your files. -After granting permission, your browser will redirect you to a blank page. This is expected behaviour. +After granting permission, your browser will redirect you to a blank page, or a page that displays this message: + +![microsoft-auth-display-message](./images/microsoft-auth-display-message.png) + +This is expected behaviour. At this point, copy the full redirect URI shown in your browser's address bar and paste it into the terminal where prompted. @@ -391,7 +395,7 @@ user@hostname:~$ ``` -**Interactive Authentication Process Illustrated:** +**Interactive OAuth2 Authentication Process Illustrated:** ![initial_auth_url_access_redacted](./images/initial_auth_url_access_redacted.png) ![copy_redirect_uri_to_application](./images/authorise_client_before_copy_with_arrow.png)