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. |
64 | | |
65 | | OAuth has two major advantages over basic authentication: |
66 | | 1. Your OSM password doesn't have to be saved in clear text in the JOSM preferences file. |
67 | | 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. |
68 | | |
69 | | Information about the use of OAuth is [wikitr:/Help/Dialog/OAuthAuthorisationWizard here] |
70 | | |
71 | | Once initialized the access token is represented with the following options: |
72 | | |
73 | | [[Image(oauth-authentication.png,500,link=)]] |
74 | | |
75 | | * 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 | | * 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. |
77 | | * Click on **New Access Token** to generate a new Access Token. |
78 | | * Selecting the checkbox "Display advanced OAuth parameters" to get the [wikitr:/Help/Dialog/OAuthAuthorisationWizard#AdvancedOAuthparameters advanced OAuth parameters] displayed. |
79 | | |
101 | | == Overpass server == #OverpassServer |
102 | | Configure 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]. |
| 79 | == New OSM account messages and max age of closed OSM Notes == |
| 80 | === New OSM account messages === |
| 81 | JOSM, 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. |
| 82 | |
| 83 | === Max age of closed OSM Notes ===#OSMNotes |
| 84 | The 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. |
| 85 | |
| 86 | |
| 87 | == Overpass server ==#OverpassServer |
| 88 | ''**([wikitr:/Help/ExpertMode Expert mode] only)**'' \\ |
| 89 | Configure 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]. \\ |
| 90 | With 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`). |