Changes between Version 24 and Version 25 of Help/Dialog/OAuthAuthorisationWizard
- Timestamp:
- 2012-08-13T04:47:45+02:00 (13 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Dialog/OAuthAuthorisationWizard
v24 v25 38 38 The easiest way to get an Access Token is to let JOSM fully automatically retrieve one from the OSM server. 39 39 40 40 1. '''Step 1/3''' - Open the preferences dialog 41 41 42 42 Click on the '''Preferences''' button in the toolbar. In the dialog, select the '''Connection Setting''' tab. 43 43 44 44 2. '''Step 2/3''' - Get the Access Token 45 45 46 46 Enter your OSM username and your OSM password and click on '''Authorise now'''. 47 47 48 48 [[Image(fully-authomatic-1.png)]] 49 49 50 50 3. '''Step 3/3''' - Accept the Access Token 51 51 52 Click on '''Accept Access Token''' to accept it.52 JOSM displays the retrieved Access Token. 53 53 54 [[Image(fully-authomatic-2.png)]] 54 [[Image(fully-authomatic-2.png)]] 55 56 * Deselect the checkbox Save to preferences if you don't want to save the Access Token in the JOSM preferences. If you don't save it the Access Token will be lost when you close JOSM. If you later startup JOSM again you will have to retrieve a new Access Token to work with OAuth based authentication again. 57 * Click on ''Test Access Token" to test the token 58 * Click on '''Accept Access Token''' to accept it. 55 59 56 60 ==== Restricting the granted privileges ==== 57 61 When JOSM fully-automatically requests and authorises an Access Token, it grants it five privileges: 58 59 60 61 62 62 * the right to upload data to the OSM server 63 * the right to upload GPS traces to the OSM server 64 * the right to download private GPS traces from the OSM server 65 * the right to read the preferences stored on the OSM server 66 * the right to write preferences stored on the OSM server 63 67 64 68 These are the default settings. If you want to restrict the granted privileges: 65 69 66 67 70 1. Click the tab '''Granted rights''' 71 1. Deselect each privilege which should not be granted to the requested Access Token 68 72 69 73 [[Image(fully-authomatic-privileges.png)]] 70 74 71 75 ==== Advanced OAuth parameters ==== #FullyAutomaticAdvanced 72 When JOSM fully-automatically requests and authorises an Access Token, it uses default values for the OAuth parameters. Advanced users may want to change these parameters 73 74 76 When JOSM fully-automatically requests and authorises an [https://oauth.net/core/1.0/#anchor3 Access Token], it uses default values for the OAuth parameters. Advanced users may want to change these parameters 77 * in order to use a different Consumer Token (consisting of a Consumer Key and a Consumer Secret). This allows you to create your own Consumer Token for JOSM and then use it in JOSM. 78 * in order to use it on a different than the standard OSM server. For instance, this allows users to use OAuth with an OSM development server or with a local installation of the OSM server application. 75 79 76 80 In order to edit the Advanced OAuth parameters 77 81 78 79 80 82 1. Click the tab '''Advanced OAuth parameters''' 83 1. Deselect the checkbox '''Use default settings''' 84 1. Enter your values for the five OAuth parameters 81 85 82 86 [[Image(fully-automatic-advanced.png)]] 83 87 84 88 === Semi-automatic authorisation process === … … 86 90 87 91 88 92 1. '''Step 1/3''' - Get the Request Token 89 93 90 94 Click on '''Retrieve Request Token''' to retrieve an OAuth Request Token. 91 95 92 96 [[Image(semi-automatic-step-1.png)]] 93 97 94 98 2. '''Step 2/3''' - Authorise the Request Token in an external browser 95 99 96 100 JOSM now launches an external browser with the OSM website. Please login and follow the instructions. Then switch back to the OAuth Authorisation Wizard and click on '''Retrieve Access Token'''. 97 101 98 102 [[Image(semi-automatic-step-2.png)]] 99 103 100 104 3. '''Step 3/3''' - Accept the Access Token 101 105 102 106 JOSM displays the retrieved Access Token. Click on '''Accept Access Token''' to accept it. 103 107 104 108 [[Image(semi-automatic-step-3.png)]] 105 109 106 110 107 111 ==== Advanced OAuth parameters ==== 108 112 When JOSM semi-automatically requests and authorises an Access Token, it uses default values for the OAuth parameters. Advanced users may want to change these parameters 109 110 113 * in order to use a different Consumer Token (consisting of a Consumer Key and a Consumer Secret). This allows you to create your own Consumer Token for JOSM and then use it in JOSM. 114 * in order to use it on a different than the standard OSM server. For instance, this allows users to use OAuth with an OSM development server or with a local installation of the OSM server application. 111 115 112 116 In order to edit the Advanced OAuth parameters 113 117 114 115 118 1. Select the checkbox '''Display Advanced OAuth Parameters''' 119 1. Enter your values for the five OAuth parameters 116 120 117 121 [[Image(semi-automatic-advanced.png)]] 118 122 119 123 === Manual authorisation process === 120 124 The manual authorisation process allows you to enter an arbitrary Access Token. You can use this process 121 125 122 123 126 * to enter an Access Token you have kept in a secure place, for instance in a secure store for credentials 127 * to enter an Access Token you have received from somebody else, for instance from another mapper who granted you restricted account access 124 128 125 129 1. '''Step 1/1''' - Enter the Access Token and accept it 126 130 127 131 Enter the Access Token and click on '''Accept Access Token'''. 128 132 129 133 [[Image(manual.png)]] 130 134 131 135 132 136 ==== Advanced OAuth parameters ==== 133 137 * See [wiki:/Help/Dialog/OAuthAuthorisationWizard#FullyAutomaticAdvanced advanced preferences in the fully automatic process]. 134 138
