From 9218f80c21f4bd8f30e58a80f7fc46a468dab894 Mon Sep 17 00:00:00 2001 From: Athanasius Date: Mon, 18 Jan 2021 22:48:33 +0000 Subject: [PATCH] New User: Expanded on how Frontier Authorization works Key thing is it's a two stage process, and you might only need stage one. --- New-user-guide.md | 33 ++++++++++++++++++++++++--------- 1 file changed, 24 insertions(+), 9 deletions(-) diff --git a/New-user-guide.md b/New-user-guide.md index a10bca5..9016b72 100644 --- a/New-user-guide.md +++ b/New-user-guide.md @@ -30,12 +30,28 @@ other expansion) and log all the way in (i.e. select 'Open Play', 'Private Group', or 'Solo' mode and end up in space, docked at a station, or on a planet/moon surface). - -## Some Frontier Authentication Quirks +##The Frontier Authorization Flow Once this application knows your Commander name it will prompt you to authorize it to use the Frontier CAPI service by opening a web browser -window/tab. +window/tab. This will use your system's default web browser. +There are two stages to Approving this Application on the Frontier site. + +1. Login on the site, using the correct email address and password for the + Cmdr name shown in the Application window. +2. If prompted, press the 'Approve' button to add this Application to the + Approved list for your account. + +If you had previously Approved the Application on the Frontier auth site then +after pressing the 'Login' button in step 1 this Application should +show 'Authentication Successful', and you are finished. + +If you had not previously Approved this Application (or had removed it +from the Approved list) then after pressing 'Login' you will go to the second +screen to Approve the Application. After pressing the 'Approve' button +the Application will show 'Authentication Successful', and you are finished. + +## Some Frontier Authentication Quirks *There is a known bug where the browser tab/window for this might open twice. Just ignore the first tab/window and use the second.* See [Issue #583](https://github.com/EDCD/EDMarketConnector/issues/583). @@ -49,17 +65,16 @@ installed and active on your system and the contents of your the issue. ## After you have Authorized the Application -Once you've entered your Frontier Account credentials and approved this -application's request for access with the 'Approve' button the browser -tab will not change, just close it once you've confirmed it worked as -below. +Once the Application shows 'Authentication Successful' the web browser tab will +not change further. Just close it once you've confirmed it worked as below. -You should see this application's window update to show: +Press the 'Update' button in the Application. You should see this +application's window update to show: 1. Your Commander name. 1. The name of your Ship. 1. The name of the (star) System you're currently in. -1. The name of the Station you're currently docked at. +1. The name of the Station you're currently docked at, if applicable. ### Setting up EDSM If you wish to make use of [Elite Dangerous Star