Changes between Version 2 and Version 3 of Nl:Help/Dialog/OAuthAuthorisationWizard
- Timestamp:
- Aug 2, 2012 8:57:10 PM (10 months ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Nl:Help/Dialog/OAuthAuthorisationWizard
v2 v3 31 31 * een Toegangstoken zou alleen geldig kunnen zijn voor een bepaalde periode, d.i. alleen vandaag, maar dit wordt nog niet ondersteund door de server van OSM 32 32 33 In aanvulling op de paren gebruikersnaam/wachtwoord accepteert de server van OSM ook Toegangstokens van OAuth om een gebruiker te authenticeren en te autoriseren. Meer specifiek, hij accepteert verzoeken ''die zijn ondertekend door een dergelijk token'', maar dat ligt buiten het bereik van deze online help.33 In aanvulling op de paren gebruikersnaam/wachtwoord accepteert de server van OSM ook Toegangstokens van OAuth om een gebruiker te authenticeren en te autoriseren. Meer specifiek, hij accepteert verzoeken ''die zijn ondertekend door een dergelijk token'', maar dat ligt buiten het bereik van deze online help. 34 34 35 De OAuth-assistent voor autorisatie maakt het u mogelijk een geldig Toeg nagstoken voor OAuth te ontvangen, vooropgesteld dat u een gebruikersnaam en wachtwoord voor OSM hebt, of om een Toegangstoken van OAuth in JOSM in te voeren en te gebruiken, vooropgesteld dat u er een heeft van iemand die een gebruikersnaam en wachtwoord voor OSM heeft.35 De OAuth-assistent voor autorisatie maakt het u mogelijk een geldig Toegangstoken voor OAuth te ontvangen, vooropgesteld dat u een gebruikersnaam en wachtwoord voor OSM hebt, of om een Toegangstoken van OAuth in JOSM in te voeren en te gebruiken, vooropgesteld dat u er een heeft van iemand die een gebruikersnaam en wachtwoord voor OSM heeft. 36 36 37 === Fully automatic authorisation process===38 The easiest way to get an Access Token is to let JOSM fully automatically retrieve one from the OSM server.37 === Volledig automatisch proces voor autorisatie === 38 De eenvoudigste manier om een Toegangstoken te krijgen is door JOSM er volledig automatisch een te laten ophalen vanaf de server van OSM. 39 39 40 1. '''St ep 1/3''' - Open the preferences dialog40 1. '''Stap 1/3''' - Open het dialoogvenster Voorkeuren 41 41 42 Click on the '''Preferences''' button in the toolbar. In the dialog, select the '''Connection Setting''' tab.42 Klik op de knop '''Voorkeuren''' op de werkbalk. Selecteer, in het dialoogvenster, de tab '''Verbindingsinstellingen'''. 43 43 44 2. '''St ep 2/3''' - Get the Access Token44 2. '''Stap 2/3''' - Het Toegangstoken verkrijgen 45 45 46 Enter your OSM username and your OSM password and click on '''Authorise now'''.46 Voer uw gebruikersnaam voor OSM en uw wachtwoord voor OSM in en klik op '''Nu autoriseren'''. 47 47 48 48 [[Image(fully-authomatic-1.png)]] 49 49 50 3. '''St ep 3/3''' - Accept the Access Token50 3. '''Stap 3/3''' - Accepteer het Toegangstoken 51 51 52 JOSM displays the retrieved Access Token. Click on '''Accept Access Token''' to accept it.52 JOSM geeft het verkregen Toegangstoken weer. Klik op '''Toegangstoken accepteren''' om het te accepteren. 53 53 54 54 [[Image(fully-authomatic-2.png)]] 55 55 56 ==== Restricting the grantedprivileges ====57 W hen JOSM fully-automatically requests and authorises an Access Token, it grants it five privileges:58 * the right to upload data to the OSM server59 * the right to upload GPS traces to the OSM server60 * the right to download private GPS traces from the OSM server61 * the right to read the preferences stored on the OSM server62 * the right to write preferences stored on the OSM server56 ==== Beperken van de toegekende privileges ==== 57 Wanneer JOSM volledig automatisch verzoekt om een Toegangstoken en dat autoriseert, kent het vijf privileges toe: 58 * het recht om gegevens te uploaden naar de server van OSM 59 * het recht om GPS-sporen te uploaden naar de server van OSM 60 * het recht om privé GPS-sporen te downloaden vanaf de server van OSM 61 * het recht om de voorkeuren te lezen die zijn opgeslagen op de server van OSM 62 * het recht om voorkeuren te schrijven die zijn opgeslagen op de server van OSM 63 63 64 These are the default settings. If you want to restrict the granted privileges:64 Dit zijn de standaard instellingen. Als u de toegekende privileges wilt beperken: 65 65 66 1. Click the tab '''Granted rights'''67 1. Deselect each privilege which should not be granted to the requested Access Token66 1. Klik op de tab '''Toegewezen rechten''' 67 1. Deselecteer elk privilege dat niet zou moeten wordne toegekend aan het verzochte Toegangstoken 68 68 69 69 [[Image(fully-authomatic-privileges.png)]] 70 70 71 ==== Advanced OAuth parameters==== #FullyAutomaticAdvanced72 W hen JOSM fully-automatically requests and authorises an Access Token, it uses default values for the OAuth parameters. Advanced users may want to change these parameters73 * in order to use a different Consumer Token (consisting of a Consumer Key and a Consumer Secret). This allows you to create your own Consumer Token for JOSM and then use it in JOSM.74 * in order to use it on a different than the standard OSM server. For instance, this allows users to use OAuth with an OSM development server or with a local installation of the OSM server application.71 ==== Uitgebreide eigenschappen voor OAuth ==== #FullyAutomaticAdvanced 72 Wanneer JOSM volledig automatisch een Toegangstoken verzoekt en autoriseert, gebruikt het standaard waarden voor de parameters van OAuth. Gevorderde gebruikers zouden deze parameters misschien willen wijzigen 73 * om een ander Gebruikerstoken (bestaande uit een Sleutel van gebruikers en een Geheime code van gebruiker) te maken. Dit stelt u in staat om uw eigen Gebruikerstoken voor JOSM te maken en het in JOSM te gebruiken. 74 * om het op een andere dan de standaard server voor OSM te gebruiken. Dit stelt bijvoorbeeld gebruikers in staat om OAuth te gebruiken met een ontwikkelingsserver voor OSM of met een locale installatie van de servertoepassing van OSM. 75 75 76 In order to edit the Advanced OAuth parameters76 Om de uitgebreide eigenschappen van OAuth te bewerken 77 77 78 1. Click the tab '''Advanced OAuth parameters'''79 1. Deselect the checkbox '''Use default settings'''80 1. Enter your values for the five OAuth parameters78 1. Klik op de tab '''Uitgebreide eigenschappen voor OAuth''' 79 1. Deselecteer het keuzevak '''Gebruik standaard instellingen''' 80 1. Voer uw waarden in voor de vijf parameters van OAuth 81 81 82 82 [[Image(fully-automatic-advanced.png)]] 83 83 84 === Semi-automati c authorisation process===85 You can also retrieve an Access Token semi-automatically. If you use this process you have to use both dialogs in JOSM and the OSM website launched in an external browser to create and authorise the Access Token. In contrast to the fully automatic process you never have to enter your OSM username or your OSM password into a JOSM dialog. This process is therefore suitable for a user which - for whatever reason - never wants to use their OSM password outside of the secure login page of the OSM website. The fully automatic process runs exactly the same steps that would run manually in the semi-automatic process, just without your intervention.84 === Semi-automatisch proces voor autorisatie === 85 U kunt ook semi-automatisch een Toegangstoken verkrijgen. Als u dit proces gebruikt moet u beide dialoogvensters gebruiken in zowel JOSM als de website van OSM die is gestart in een externe browser om het Toegangstoken te maken en te autoriseren. In tegenstelling tot het volledig automatische proces hoeft u nooit uw gebruikersnaam voor OSM of uw wachtwoord voor OSM in een dialoogvenster van JOSM in te voeren. Dit proces is daarom geschikt voor een gebruiker die - om welke reden dan ook - nooit zijn wachtwoord van OSM wil gebruiken buiten de beveiligde loginpagina van de website van OSM. Het volledig automatische proces voert exact dezelfde stappen uit die handmatig in het semi-automatische proces worden uitgevoerd, maar zonder interventie van u. 86 86 87 87 88 1. '''St ep 1/3''' - Get the Request Token88 1. '''Stap 1/3''' - Het Verzoektoken verkrijgen 89 89 90 Click on '''Retrieve Request Token''' to retrieve an OAuth Request Token.90 Klik op '''Verzoektoken verkrijgen''' om een Verzoektoken voor OAuth te verkrijgen. 91 91 92 92 [[Image(semi-automatic-step-1.png)]] 93 93 94 2. '''St ep 2/3''' - Authorise the Request Token in an externalbrowser94 2. '''Stap 2/3''' - Autoriseer het Verzoektoken in een externe browser 95 95 96 JOSM now launches an external browser with the OSM website. Please login and follow the instructions. Then switch back to the OAuth Authorisation Wizard and click on '''Retrieve Access Token'''.96 JOSM start nu een externe browser met de website van OSM. Log alstublieft in en volg de instructies. Schakel dan terug naar de OAuth-assistent voor autorisatie en klik op '''Verzoektoken verkrijgen'''. 97 97 98 98 [[Image(semi-automatic-step-2.png)]] 99 99 100 3. '''Step 3/3''' - Accept the Access Token100 3. '''Step 3/3''' - Accepteer het Toegangstoken 101 101 102 JOSM displays the retrieved Access Token. Click on '''Accept Access Token''' to accept it.102 JOSM geeft het verkregen Toegangstoken weer. Klik op '''Toegangstoken accepteren''' om het te accepteren. 103 103 104 104 [[Image(semi-automatic-step-3.png)]] 105 105 106 106 107 ==== Advanced OAuth parameters====108 W hen JOSM semi-automatically requests and authorises an Access Token, it uses default values for the OAuth parameters. Advanced users may want to change these parameters109 * in order to use a different Consumer Token (consisting of a Consumer Key and a Consumer Secret). This allows you to create your own Consumer Token for JOSM and then use it in JOSM.110 * in order to use it on a different than the standard OSM server. For instance, this allows users to use OAuth with an OSM development server or with a local installation of the OSM server application.107 ==== Uitgebreide eigenschappen voor OAuth ==== 108 Wanneer JOSM semi-automatisch een Toegangstoken verzoekt en autoriseert, gebruikt het standaard waarden voor de parameters van OAuth. Gevorderde gebruikers zouden deze parameters misschien willen wijzigen 109 * om een ander Gebruikerstoken (bestaande uit een Sleutel van gebruikers en een Geheime code van gebruiker) te maken. Dit stelt u in staat om uw eigen Gebruikerstoken voor JOSM te maken en het in JOSM te gebruiken. 110 * om het op een andere dan de standaard server voor OSM te gebruiken. Dit stelt bijvoorbeeld gebruikers in staat om OAuth te gebruiken met een ontwikkelingsserver voor OSM of met een locale installatie van de servertoepassing van OSM. 111 111 112 In order to edit the Advanced OAuth parameters112 Om de uitgebreide eigenschappen van OAuth te bewerken 113 113 114 1. Select the checkbox '''Display Advanced OAuth Parameters'''115 1. Enter your values for the five OAuth parameters114 1. Selecteer het keuzevak '''Uitgebreide eigenschappen voor OAuth weergeven''' 115 1. Voer uw waarden in voor de vijf parameters van OAuth 116 116 117 117 [[Image(semi-automatic-advanced.png)]] 118 118 119 === Manual authorisation process===120 The manual authorisation process allows you to enter an arbitrary Access Token. You can use this process 119 === handmatig proces voor autorisatie === 120 Het handmatige proces voor autorisatie stelt u in staat een ander Toegangstoken in te voeren. U kunt dit proces gebruiken 121 121 122 * to enter an Access Token you have kept in a secure place, for instance in a secure store for credentials123 * to enter an Access Token you have received from somebody else, for instance from another mapper who granted you restricted account access122 * om een Toegangstoken in te voeren dat u op een veilige plaats hebt bewaard, bijvoorbeeld in een kluis voor wachtwoorden 123 * om een Toegangstoken in te voeren dat u van iemand anders hebt gekregen, bijvoorbeeld van een andere mapper die u beperkte toegang tot zijn account heeft toegestaan 124 124 125 1. '''St ep 1/1''' - Enter the Access Token and accept it125 1. '''Stap 1/1''' - Voer het Toegangstoken in en accepteer het 126 126 127 Enter the Access Token and click on '''Accept Access Token'''.127 Voer het Toegangstoken in en klik op '''Toegangstoken accepteren'''. 128 128 129 129 [[Image(manual.png)]] 130 131 130 132 =============== 131 ==== Uitgebreide eigenschappen voor OAuth ==== 132 * Bekijk [wiki:/Help/Dialog/OAuthAuthorisationWizard#FullyAutomaticAdvanced uitgebreide eigenschappen in het volledig automatische proces]. 133 133 134 === Op OAuth gebaseerde authenticatie === 135 De server van OSM ondersteunt OAuth in aanvulling op de basis authenticatie. 136 137 138 139 140 141 Op OAuth gebaseerde authenticatie gebruiken 142 143 1. In Verbindingsinstellingen, ga naar de tab '''Authenticatie''' 144 1. Selecteer de authenticatiemethode '''OAuth gebaseerde authenticatie''' 145 1. Klik op '''Nu autoriseren''' om de [wiki:/Help/Dialog/OAuthAuthorisationWizard OAuth Autorisatie Wizard] te starten (zie schermafdruk hieronder) 146 147 [[Image(Help/Preferences/Connection:oauth-preferences-step-1.png)]] 148 149 Dit zal de [wiki:/Help/Dialog/OAuthAuthorisationWizard OAuth Autorisatie Wizard] starten. Gebruik één van de beschikbare authorisatieprocedures in dit dialoogvenster om een geldig '''Access Token''' te verkrijgen. 150 151 JOSM geeft het gevonden Access Token weer in het paneel van de voorkeuren (zie schermafdruk hieronder): 152 153 [[Image(Help/Preferences/Connection:oauth-preferences-step-2.png)]] 154 155 Deselecteer het keuzevak '''Save to preferences''' als u het Access Token niet wilt opslaan in de voorkeuren van JOSM. Als u het niet bewaart zal het Access Token verloren gaan als u JOSM afsluit. Als u later JOSM opnieuw start zult u een nieuw Access Token moeten ophalen om opnieuw met op OAuth gebaseerde authenticatie te werken. 156 157 Klik op '''Test Access Token''' om een testverzoek door te voeren met het token naar de server van OSM. JOSM zal analyseren of dit token geautoriseerd is om toegang te krijgen tot de server van OSM. 158 159 Klik op '''New Access Token''' om een nieuw Access Token te genereren. 160 161 ==== Gevorderde parameters voor OAuth ==== 162 Selecteer het keuzevak '''Display Advanced OAuth parameters''' om de belangrijke parameters voor OAuth weer te geven 163 * de [http://oauth.net/core/1.0/#anchor3 Consumer Key] en de [http://oauth.net/core/1.0/#anchor3 Consumer Secret] identificeren JOSM als een gebruiker van OAuth 164 * de Request Token URL waar JOSM [http://oauth.net/core/1.0/#anchor3 Request Tokens] kan ophalen 165 * de Access Token URL waar JOSM [http://oauth.net/core/1.0/#anchor3 Access Tokens] kan ophalen 166 * de Authorise URL waarnaar gebruikers van JOSM worden geleid om een Request Token te autoriseren 167 168 [[Image(Help/Preferences/Connection:oauth-advanced.png)]] 169 170 == Proxy-instellingen == #ProxySettings 171 JOSM communiceert met de server van OSM met behulp van het Hypertext Transfer Protocol ([http://en.wikipedia.org/wiki/Http HTTP]). Indien vereist kan het zijn verzoeken leiden langs een [http://en.wikipedia.org/wiki/Http_proxy HTTP proxy] of een [http://en.wikipedia.org/wiki/SOCKS SOCKS proxy]. 172 173 1. Ga naar de tab '''Proxy settings''' in de Verbindingsinstellingen 174 1. Selecteer één van de beschikbare opties en voor aanvullende parameters in voor de configuratie 175 1. Sla de voorkeuren op 176 177 [[Image(Help/Preferences/Connection:proxy-settings.png)]] 178 179 180 === Gebruiken van de standaard systeemproxy === 181 Indien u altijd de proxy wilt gebruiken die is gedefinieerd als standaard proxy op uw computer moet u JOSM opstarten met een speciale opdracht. De opdrachtregel moet de parameter {{{-Djava.net.useSystemProxies=true}}} bevatten, bijvoorbeeld 182 183 {{{java -Djava.net.useSystemProxies=true -jar josm.jar}}} 184 185 === Gebruiken van de handmatig geconfigureerde proxy === 186 Indien er geen noodzaak is voor persoonlijke authenticatie voor uw proxy, onthoud dan om het NT-domein in uw gebruikersnaam op te nemen, bijv. ''domein\gebruikersnaam''. Dit probleem vindt zijn oorsprong in de implementatie van de proxy in java.net.HttpURLConnection. 187 188 ==== Advanced OAuth parameters ==== 189 * See [wiki:/Help/Dialog/OAuthAuthorisationWizard#FullyAutomaticAdvanced advanced preferences in the fully automatic process]. 190 134 ---- 135 Terug naar [wiki:/Nl:Help/Action/Preferences Voorkeuren][[Br]] 136 Terug naar [wiki:Nl:Help Help]


