Changes between Version 33 and Version 48 of Help/Preferences/Connection


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Connection

    v33 v48  
    1 [[TranslatedPages]]
    2 = Preferences > Connection settings =
     1[[TranslatedPages(outdated=Page needs rework and better structure. Screenshot is outdated.)]]
    32
    4 [[TOC(inline)]]
     3= Preferences > OSM Server =
     4[[PageOutline(2-4,Table of content)]]
    55
    6 == The URL to the OSM server == #ApiUrl
     6[[JOSMImage(preferences/connection,48,link=,middle,margin-right=20)]]
    77
    8 === Downloading and uploading to the default server ===
     8Connection Settings for the OSM server
    99
    10 [[Image(use-default-api-url.png)]]
     10== Downloading and uploading to the default server == #ApiUrl
     11[[Image(use-default-api-url.png,link=)]]
    1112
    1213Most JOSM users want to exchange geo data with the standard OSM server operated by the OSM community.
    … …  
    1415Tick the respective checkbox in order to download from and upload to the standard server (see screenshot above). This is the default setting.
    1516
    16 === Advanced option: Downloading and uploading to a custom server ===
     17== Advanced option: Downloading and uploading to a custom server ==
    1718Some JOSM users need to configure the API URL of an OSM server because they are working with a custom server:
    18   * Some users are working with local installations of the OSM server
    19   * Some users are working with development and test instances of the OSM server (for instance with [http://api06.dev.openstreetmap.org]).
     19* Some users are working with local installations of the OSM server
     20* Some users are working with development and test instances of the OSM server (for instance with [https://api06.dev.openstreetmap.org]).
    2021
    21 [[Image(use-custom-api-url.png)]]
     22[[Image(use-custom-api-url.png,link=)]]
    2223
    2324In order to use a custom URL:
    24   1. Remove the tick in the checkbox for the standard API URL (see screenshot above)
    25   1. Enter the API URL
     251. Remove the tick in the checkbox for the standard API URL (see screenshot above)
     261. Enter the API URL
    2627 
    27 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/dialogs/changeset/valid.png)]] 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)]].
     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)]].
    2829
    2930
    30 == Authentication Settings ==#AuthenticationSettings
    31 
     31== Authentication ==#Authentication
    3232=== Working anonymously or with an OSM account ===
    33 
    3433You 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.
    3534
    36 If you work '''anonymously''' you are allowed
    37   * to download geo-data from the OSM server and save it to a local file
    38   * to download public GPS traces from the OSM server
    39   * to load geo data from a file, edit it, and save it back to a file
     35If you work **anonymously** you are allowed
     36* to download geo-data from the OSM server and save it to a local file
     37* to download public GPS traces from the OSM server
     38* to load geo data from a file, edit it, and save it back to a file
    4039
    4140However, you can't
    42   * upload geo-data to the OSM server. You can't created, update, or close changesets either.
    43   * download your private GPS traces
     41* upload geo-data to the OSM server. You can't created, update, or close changesets either.
     42* download your private GPS traces
    4443
    45 You are recommended to [http://www.openstreetmap.org/user/new?referer=%2F create an OSM user account]. By using [http://www.openstreetmap.org/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.
     45
    4646
    4747=== Basic authentication ===
    48 {{{
    49 #!html
    50 <p style="background-color:rgb(253,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px;">
    51 <strong>Warning!</strong><br/>
    52 Basic authentication methode is quite unsecure. Please consider to use OAuth.
    53 The password is stored in plain text in the JOSM preferences file.
    54 Furthermore, it is transferred <strong>unencrypted</strong> in every request sent to the OSM server.
    55 <strong>Do not use a valuable password.</strong>
    56 </p>
    57 }}}
    58 
    5948Basic authentication is the basic mechanism to authenticate yourself at the OSM server.
    6049
    6150Here's a screenshot of the preferences panel for basic authentication:
    6251
    63 [[Image(basic-authentication.png)]]
     52[[Image(basic-authentication.2.png,link=)]]
    6453
    6554To use Basic Authentication
    6655
    67   1. Go to the tab '''Authentication''' in the Connection Preferences
    68   1. Select the authentication method '''Basic authentication'''
    69   1. Enter your OSM username and your OSM password
     561. Go to the register **OSM Server** in Preferences
     571. Select the authentication method **Basic authentication**
     581. Enter your OSM username and your OSM password
    7059
    71 === OAuth based authentication ===
    72 [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.
     60=== OAuth 1.0a based authentication ===
     61**OAuth 1.0a is deprecated. Please use OAuth 2.0 or later instead!**
     62
     63[https://oauth.net/1 OAuth 1.0a] 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.
    7364
    7465OAuth has two major advantages over basic authentication:
    75   1. Your OSM password doesn't have to be saved in clear text in the JOSM preferences file.
    76   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.
     661. Your OSM password doesn't have to be saved in clear text in the JOSM preferences file.
     671. 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.
    7768
    78 Information about the use of OAuth is [wiki:/Help/Dialog/OAuthAuthorisationWizard here]
     69Information about the use of OAuth is [wikitr:/Help/Dialog/OAuthAuthorisationWizard here]
    7970
    8071Once initialized the access token is represented with the following options:
    8172
    82 [[Image(oauth-authentication.png,500)]]
     73[[Image(oauth-authentication.png,500,link=)]]
    8374
    8475* 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.
    85 * 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.
     76* 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.
    8677* Click on **New Access Token** to generate a new Access Token.
    87 * Selecting the checkbox "Display advanced OAuth parameters" to get the [wiki:Help/Dialog/OAuthAuthorisationWizard#AdvancedOAuthparameters advanced OAuth parameters] displayed.
     78* Selecting the checkbox "Display advanced OAuth parameters" to get the [wikitr:/Help/Dialog/OAuthAuthorisationWizard#AdvancedOAuthparameters advanced OAuth parameters] displayed.
    8879
    89 == Proxy Settings == #ProxySettings
    90 JOSM communicates with the OSM server using the Hypertext Transfer Protocol ([http://en.wikipedia.org/wiki/Http HTTP]). If required it can relay its requests through a [http://en.wikipedia.org/wiki/Http_proxy HTTP proxy] or a [http://en.wikipedia.org/wiki/SOCKS SOCKS proxy].
     80=== OAuth 2.0 based authentication ===#oauth2
     81[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.
    9182
    92   1. Go to the tab '''Proxy settings''' in the Connection Preferences
    93   1. Select one of the available options and enter additional configuration parameters
    94   1. Save the preferences
     83OAuth has two major advantages over basic authentication:
     841. Your OSM password doesn't have to be saved in clear text in the JOSM preferences file.
     851. 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.
    9586
    96 [[Image(proxy-settings.png,500)]]
     87OAuth 2.0 uses [wikitr:RemoteControl Remote Control] to receive the token from the OAuth server. 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.
    9788
     89Once initialized the access token is represented with the following options:
    9890
    99 === Using the standard system proxy ===
    100 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
     91[[Image(oauth-2-authentication.png,500,link=)]]
    10192
    102   {{{java -Djava.net.useSystemProxies=true -jar josm.jar}}}
     93* 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.
     94* 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.
     95* Click on **Remove token** to remove the current token. The `Authorise now` button will reappear.
     96* Selecting the checkbox "Display Advanced OAuth Parameters" to get the [wikitr:/Help/Dialog/OAuthAuthorisationWizard#AdvancedOAuthparameters advanced OAuth parameters] displayed.
    10397
    104 === Using the manually configured proxy ===
    105 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.
     98== New OSM account messages ==
     99At the bottom there are settings for new osm account messages and [wikitr:/Help/Dialog/Notes Notes].
     100
     101== Overpass server == #OverpassServer
     102Configure the Overpass API instance used for downloading OSM data (for instance in [wikitr:/Help/Action/Download#DownloadfromOverpassAPI Download from Overpass API]). See [osmwiki:Overpass_API#Public_Overpass_API_instances for a list of servers].
    106103
    107104----
    108 Back to [wiki:/Help/Action/Preferences Preferences][[Br]]
    109 Back to [wiki:Help Main Help]
     105Back to [wikitr:/Help/Action/Preferences Preferences] \\
     106Back to [wikitr:/Help/Menu/Edit Edit Menu] \\
     107Back to [wikitr:/Help/Menu Main Menu] \\
     108Back to [wikitr:/Help Main Help]