Changes between Version 37 and Version 55 of Help/Preferences/Connection


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Connection

    v37 v55  
    1 [[TranslatedPages]]
    2 [[PageOutline(1-10,Table of Contents)]]
    3 = Preferences > Connection settings =
     1[[TranslatedPages(outdated=Page needs rework and better structure. Some screenshots are outdated.)]]
    42
    5 == The URL to the OSM server == #ApiUrl
     3= Preferences > OSM Server =
     4[[PageOutline(2-4,Table of content)]]
    65
    7 === Downloading and uploading to the default server ===
     6[[JOSMImage(preferences/connection,48,link=,middle,margin-right=20)]]
    87
    9 [[Image(use-default-api-url.png)]]
     8Connection Settings for the OSM server
     9
     10== Downloading and uploading to the default server ==#ApiUrl
     11[[Image(use-default-api-url.png,link=)]]
    1012
    1113Most JOSM users want to exchange geo data with the standard OSM server operated by the OSM community.
    … …  
    1315Tick the respective checkbox in order to download from and upload to the standard server (see screenshot above). This is the default setting.
    1416
    15 === Advanced option: Downloading and uploading to a custom server ===
     17== Advanced option: Downloading and uploading to a custom server ==
    1618Some JOSM users need to configure the API URL of an OSM server because they are working with a custom server:
    1719* 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]).
    1921
    20 [[Image(use-custom-api-url.png)]]
     22[[Image(use-custom-api-url.png,link=)]]
    2123
    2224In order to use a custom URL:
    … …  
    24261. Enter the API URL
    2527 
    26 Click on '''Validate''' to test whether an OSM API server is available at the given URL. If so, JOSM will display the icon [[Image(source:/trunk/images/misc/green_check.svg,middle)]] to the right of the input field for the API URL. If the URL isn't valid, JOSM will display the icon  [[Image(source:/trunk/images/warning-small.png,middle)]].
     28Click 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)]].
    2729
    2830
    29 == Authentication Settings ==#AuthenticationSettings
    30 
     31== Authentication ==#Authentication
    3132=== Working anonymously or with an OSM account ===
    32 
    3333You 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.
    3434
    35 If you work '''anonymously''' you are allowed
     35If you work **anonymously** you are allowed
    3636* to download geo-data from the OSM server and save it to a local file
    3737* to download public GPS traces from the OSM server
    … …  
    4242* download your private GPS traces
    4343
    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.
     44You 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.
    4545
    4646=== Basic authentication ===
    47 
    4847Basic authentication is the basic mechanism to authenticate yourself at the OSM server.
    4948
    5049Here's a screenshot of the preferences panel for basic authentication:
    5150
    52 [[Image(basic-authentication.png)]]
     51[[Image(basic-authentication.2.png,link=)]]
    5352
    5453To use Basic Authentication
    5554
    56 1. Go to the tab '''Authentication''' in the Connection Preferences
    57 1. Select the authentication method '''Basic authentication'''
     551. Go to the register **OSM Server** in Preferences
     561. Select the authentication method **Basic authentication**
    58571. Enter your OSM username and your OSM password
    5958
    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.
     59=== OAuth 2.0 based authentication ===#oauth2
     60[https://oauth.net/2 OAuth 2.0] 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 2.0 in addition to basic authentication.
    6261
    6362OAuth has two major advantages over basic authentication:
    64631. 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.
     641. 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.
    6665
    67 Information about the use of OAuth is [wiki:/Help/Dialog/OAuthAuthorisationWizard here]
     66OAuth 2.0 uses [wikitr:RemoteControl Remote Control] to receive the token from the OAuth server. If Remote Control is disabled in preferences (default setting) it is temporally enabled to receive the token and then disabled again.
     67**Note**: If you have issues authenticating, you can disable remote control in other running instances of JOSM and disable ''then'' re-enable it in the JOSM instance you are trying to authenticate.
    6868
    6969Once initialized the access token is represented with the following options:
    7070
    71 [[Image(oauth-authentication.png,500)]]
     71[[Image(oauth-2-authentication.png,500,link=)]]
    7272
    7373* 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.
    74 * Click on **Test Access Token** to submit a test request with the token to the OSM server. JOSM will analyse whether this token is authorized to access the OSM server.
    75 * Click on **New Access Token** to generate a new Access Token.
    76 * Selecting the checkbox "Display advanced OAuth parameters" to get the [wiki:Help/Dialog/OAuthAuthorisationWizard#AdvancedOAuthparameters advanced OAuth parameters] displayed.
    77 
    78 At the bottom there are settings for new osm account messages and [wiki:Help/Dialog/Notes Notes].
    79 
    80 == Proxy Settings == #ProxySettings
    81 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 Preferences
    84 1. Select one of the available options and enter additional configuration parameters
    85 1. Save the preferences
    86 
    87 [[Image(proxy-settings.png,500)]]
     74* Click on **Test Access Token** to submit a test request with the token to the OSM server. JOSM will analyze whether this token is authorized to access the OSM server.
     75* Click on **Remove token** to remove the current token. The `Authorise now` button will reappear.
     76* Selecting the checkbox "Display Advanced OAuth Parameters" to get the [wikitr:/Help/Dialog/OAuthAuthorisationWizard#AdvancedOAuthparameters advanced OAuth parameters] displayed.
    8877
    8978
    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 instance
     79== New OSM account messages and max age of closed OSM Notes ==
     80=== New OSM account messages ===
     81JOSM, by default, periodically checks for unread OSM account messages. Unchecking ''**Periodically check for new messages**'' will disable the check (''advanced preference'': `message.notifier.enabled`). Below the checkbox the interval in minutes can be set (''advanced preference'': `message.notifier.interval`). The default value is `5` minutes.
    9282
    93   {{{java -Djava.net.useSystemProxies=true -jar josm.jar}}}
     83=== Max age of closed OSM Notes ===#OSMNotes
     84The maximum age in days of closed [wikitr:/Help/Dialog/Notes OSM Notes] can be set (''advanced preference'': `osm.notes.daysClosed`). The default value is `7` days. See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Advanced preferences for notes] for details.
    9485
    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.
     86
     87== Overpass server ==#OverpassServer
     88''**([wikitr:/Help/ExpertMode Expert mode] only)**'' \\
     89Configure the Overpass API instance used for downloading OSM data (for instance in [wikitr:/Help/Action/Download#DownloadfromOverpassAPI Download from Overpass API]) (''advanced preference'': `download.overpass.server`). See [osmwiki:Overpass_API#Public_Overpass_API_instances for a list of servers]. \\
     90With a checked ''**Use Overpass server for object downloads**'' the overpass server is used for all actions which request to download specified objects like [wikitr:/Help/Action/DownloadObject Download Object], [wikitr:/Help/Action/DownloadParentWaysAndRelation Download parent ways/relations …] or downloading (incomplete) members of relations (''advanced preference'': `download.overpass.for-multi-fetch`).
    9791
    9892----
    99 Back to [wiki:/Help/Action/Preferences Preferences][[Br]]
    100 Back to [wiki:Help Main Help]
     93Back to [wikitr:/Help/Action/Preferences Preferences] \\
     94Back to [wikitr:/Help/Menu/Edit Edit Menu] \\
     95Back to [wikitr:/Help/Menu Main Menu] \\
     96Back to [wikitr:/Help Main Help]