Changes between Version 41 and Version 42 of Help/Preferences/Connection
- Timestamp:
- 2021-03-22T23:47:06+01:00 (4 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Preferences/Connection
v41 v42 1 [[TranslatedPages(outdated= Check if anon usage is still allowed. Overpass can be added.)]]1 [[TranslatedPages(outdated=Page needs rework and better structure. Overpass is missing. Screenshot is outdated.)]] 2 2 3 = Preferences > Connection settings=4 [[PageOutline(2- 2,Tabs)]]3 = Preferences > Connection = 4 [[PageOutline(2-4,Table of content)]] 5 5 6 [[JOSMImage(preferences/connection,48,link=,middle,margin-right=20)]] 6 7 7 === Downloading and uploading to the default server === #ApiUrl 8 Connection Settings for the OSM server 8 9 9 [[Image(use-default-api-url.png)]] 10 == Downloading and uploading to the default server == #ApiUrl 11 [[Image(use-default-api-url.png,link=)]] 10 12 11 13 Most JOSM users want to exchange geo data with the standard OSM server operated by the OSM community. … … 13 15 Tick the respective checkbox in order to download from and upload to the standard server (see screenshot above). This is the default setting. 14 16 15 == = Advanced option: Downloading and uploading to a custom server ===17 == Advanced option: Downloading and uploading to a custom server == 16 18 Some JOSM users need to configure the API URL of an OSM server because they are working with a custom server: 17 19 * Some users are working with local installations of the OSM server 18 * Some users are working with development and test instances of the OSM server (for instance with [http ://api06.dev.openstreetmap.org]).20 * Some users are working with development and test instances of the OSM server (for instance with [https://api06.dev.openstreetmap.org]). 19 21 20 [[Image(use-custom-api-url.png )]]22 [[Image(use-custom-api-url.png,link=)]] 21 23 22 24 In order to use a custom URL: … … 24 26 1. Enter the API URL 25 27 26 Click on '''Validate''' to test whether an OSM API server is available at the given URL. If so, JOSM will display the icon [[JOSMImage(misc/green_check,middle)]] to the right of the input field for the API URL. If the URL isn't valid, JOSM will display the icon [[JOSMImage(warning-small,middle)]].28 Click on **Validate** to test whether an OSM API server is available at the given URL. If so, JOSM will display the icon [[JOSMImage(misc/green_check)]] to the right of the input field for the API URL. If the URL isn't valid, JOSM will display the icon [[JOSMImage(warning-small)]]. 27 29 28 30 29 31 == Authentication ==#Authentication 30 31 32 === Working anonymously or with an OSM account === 32 33 33 You don't need to identify and authenticate yourself provided that you neither upload data to the OSM server nor download data for which you must authenticate first. 34 34 35 If you work '''anonymously'''you are allowed35 If you work **anonymously** you are allowed 36 36 * to download geo-data from the OSM server and save it to a local file 37 37 * to download public GPS traces from the OSM server … … 42 42 * download your private GPS traces 43 43 44 You are recommended to [osmwww:user/new?referer=%2F create an OSM user account]. By using [osmwww:user/new?referer=%2F this form] you can choose an '''OSM username''' and an '''OSM password''' both of which you will use below. 44 You are recommended to [osmwww:user/new?referer=%2F create an OSM user account]. By using [osmwww:user/new?referer=%2F this form] you can choose an **OSM username** and an **OSM password** both of which you will use below. 45 45 46 46 47 === Basic authentication === 47 48 48 Basic authentication is the basic mechanism to authenticate yourself at the OSM server. 49 49 50 50 Here's a screenshot of the preferences panel for basic authentication: 51 51 52 [[Image(basic-authentication.png )]]52 [[Image(basic-authentication.png,link=)]] 53 53 54 54 To use Basic Authentication 55 55 56 1. Go to the tab '''Authentication''' in the Connection Preferences57 1. Select the authentication method '''Basic authentication'''56 1. Go to the register **OSM Server** in Preferences 57 1. Select the authentication method **Basic authentication** 58 58 1. Enter your OSM username and your OSM password 59 59 60 60 === OAuth based authentication === 61 [http ://oauth.net/ OAuth] is an open protocol to allow secure API authorization in a simple and standard method from desktop and web applications. The OSM server supports OAuth in addition to basic authentication.61 [https://oauth.net/ OAuth] is an open protocol to allow secure API authorization in a simple and standard method from desktop and web applications. The OSM server supports OAuth in addition to basic authentication. 62 62 63 63 OAuth has two major advantages over basic authentication: 64 64 1. Your OSM password doesn't have to be saved in clear text in the JOSM preferences file. 65 1. Your OSM password has to be transferred encrypted '''only once'''over the Internet, in contrast to basic authentication where your OSM password is transferred unencrypted as part of every request sent from JOSM to the OSM server.65 1. Your OSM password has to be transferred encrypted **only once** over the Internet, in contrast to basic authentication where your OSM password is transferred unencrypted as part of every request sent from JOSM to the OSM server. 66 66 67 67 Information about the use of OAuth is [wikitr:/Help/Dialog/OAuthAuthorisationWizard here] … … 69 69 Once initialized the access token is represented with the following options: 70 70 71 [[Image(oauth-authentication.png,500 )]]71 [[Image(oauth-authentication.png,500,link=)]] 72 72 73 73 * 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. … … 76 76 * Selecting the checkbox "Display advanced OAuth parameters" to get the [wikitr:/Help/Dialog/OAuthAuthorisationWizard#AdvancedOAuthparameters advanced OAuth parameters] displayed. 77 77 78 79 == New OSM account messages == 78 80 At the bottom there are settings for new osm account messages and [wikitr:/Help/Dialog/Notes Notes]. 79 80 == Proxy settings == #ProxySettings81 JOSM communicates with the OSM server using the Hypertext Transfer Protocol ([https://en.wikipedia.org/wiki/Http HTTP]). If required it can relay its requests through a [https://en.wikipedia.org/wiki/Http_proxy HTTP proxy] or a [https://en.wikipedia.org/wiki/SOCKS SOCKS proxy].82 83 1. Go to the tab '''Proxy settings''' in the Connection Preferences84 1. Select one of the available options and enter additional configuration parameters85 1. Save the preferences86 87 [[Image(proxy-settings.png,500)]]88 89 90 === Using the standard system proxy ===91 If you always want to use the proxy defined as standard proxy on your computer you have to start up JOSM with a special command. The command line has to include the parameter {{{-Djava.net.useSystemProxies=true}}}, for instance92 93 {{{java -Djava.net.useSystemProxies=true -jar josm.jar}}}94 95 === Using the manually configured proxy ===96 If there is a need for personal authentication for your proxy, remember to include the NT-domain with your username, e.g. ''domain\username''. This issue is due to proxy implementation in java.net.HttpURLConnection.97 81 98 82 == Overpass server == #OverpassServer … … 100 84 101 85 ---- 102 Back to [wikitr:/Help/Action/Preferences Preferences][[Br]] 86 Back to [wikitr:/Help/Action/Preferences Preferences] \\ 87 Back to [wikitr:/Help/Menu/Edit Edit Menu] \\ 88 Back to [wikitr:/Help/Menu Main Menu] \\ 103 89 Back to [wikitr:/Help Main Help]