Changes between Version 29 and Version 30 of Help/Preferences/Connection


Ignore:
Timestamp:
2012-08-11T16:30:16+02:00 (13 years ago)
Author:
DiGro
Comment:

removed superfluous info on OAuth which is offered at separate page

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Connection

    v29 v30  
    1 [[TranslatedPages(outdated=This page contains information about OAuth which should be moved to [wiki:Help/Dialog/OAuthAuthorisationWizard])]]
     1[[TranslatedPages]]
    22= Preferences > Connection settings =
    33
    … …  
    7070
    7171=== 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. 
     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.
    7373
    7474OAuth has two major advantages over basic authentication:
    … …  
    7676  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.
    7777
    78 For advanced users, OAuth has additional advantages:
    79   * With OAuth you can generate restricted Access Tokens which you given somebody else such that another mapper can act on your behalf. For instance, a mapper could generate an Access Token which grants somebody else the right to download its private GPS traces. Even if he gives this Access Token to somebody else, his OSM password is kept private. In addition, he can revoke the special Access Token at any time. JOSM supports this kind of advanced configuration in the [wiki:/Help/Dialog/OAuthAuthorisationWizard OAuth Authorisation Wizard] with the authorisation procedure '''Manual authorization'''.
    80 
    81 To use OAuth based Authentication
    82 
    83   1. In the Connection Preferences go to the tab '''Authentication'''
    84   1. Select the authentication method '''OAuth based authentication'''
    85   1. Click on '''Authorise now''' to launch the [wiki:/Help/Dialog/OAuthAuthorisationWizard OAuth Authorisation Wizard] (see screenshot below)
    86 
    87 [[Image(oauth-preferences-step-1.png)]]
    88 
    89 This will launch the [wiki:/Help/Dialog/OAuthAuthorisationWizard OAuth Authorisation Wizard]. Use one of the available authorization procedures in this dialog to get a valid '''Access Token'''.
    90 
    91 JOSM displays the retrieved Access Token in the preferences panel (see screenshot below):
    92 
    93 [[Image(oauth-preferences-step-2.png)]]
    94 
    95 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.
    96 
    97 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.
    98 
    99 Click on '''New Access Token''' to generate a new Access Token.
    100 
    101 ==== Advanced OAuth parameters ====
    102 Select the checkbox '''Display Advanced OAuth parameters''' to display the important OAuth parameters
    103   * the [http://oauth.net/core/1.0/#anchor3 Consumer Key] and the [http://oauth.net/core/1.0/#anchor3 Consumer Secret] identifying JOSM as OAuth consumer
    104   * the Request Token URL where JOSM can retrieve [http://oauth.net/core/1.0/#anchor3 Request Tokens]
    105   * the Access Token URL where JOSM can retrieve [http://oauth.net/core/1.0/#anchor3 Access Tokens]
    106   * the Authorise URL where JOSM users are redirected to to authorise a Request Token
    107 
    108 [[Image(oauth-advanced.png)]]
     78Information about the use of OAuth is [wiki:/Help/Dialog/OAuthAuthorisationWizard here]
    10979
    11080== Proxy Settings == #ProxySettings