[[TranslatedPages]] = Voorkeuren > Verbindingsinstellingen = [[TOC(inline)]] == De URL naar de server van OSM == #ApiUrl === Downloaden en uploaden van/naar de standaard server === [[Image(use-default-api-url.png)]] De meeste gebruikers van JOSM willen geo-gegevens uitwisselen met de standaard server van OSM die wordt beheerd door de OSM-gemeenschap. Vink het respectievelijke keuzevak aan om te downloaden vanaf en te uploaden naar de standaard server (zie schermafdruk hierboven). Dit is de standaard instelling. === Opties voor gevorderden: Downloaden en uploaden naar een aangepaste server === Sommige gebruikers van JOSM moeten de API URL van een server van OSM configureren omdat zij werken met een aangepaste server: * Sommige gebruikers werken met lokale installaties van de server van OSM * Sommige gebruikers werken met ontwikkelings- en testinstanties van de server van OSM (bijvoorbeeld met [http://api06.dev.openstreetmap.org]). [[Image(use-custom-api-url.png)]] Om een aangepaste URL te kunnen gebruiken: 1. Verwijder het vinkje in het keuzevak voor de standaard API URL (zie schermafdruk boven) 2. Voer de API URL in Klik op '''Valideren''' om te testen of een OSM API server beschikbaar is op de opgegeven URL. Als dat zo is zal JOSM het pictogram [[Image(source:/trunk/images/dialogs/changeset/valid.png)]] weergeven rechts van het invoerveld voor de API URL. Indien de URL niet geldig is zal JOSM het pictogram [[Image(source:/trunk/images/warning-small.png)]] weergeven. == Instellingen voor authenticatie ==#AuthenticationSettings === Anoniem werken of met een account van OSM === U hoeft zichzelf niet te identificeren en te authenticeren vooropgesteld dat u noch gegevens upload naar de server van OSM noch gegevens download waarvoor u zich eerst moet authenticeren. Indien u '''anoniem''' werkt, is het u toegestaan * geo-gegevens te downloaden vanaf de server van OSM en dat op te slaan naar een lokaal bestand * publieke GPS-traces te downloaden vanaf de server van OSM * geo-gegevens te laden vanaf een bestand, het bewerken en het terug op te slaan naar een bestand U kunt echter niet * geo-gegevens uploaden naar de server van OSM. U kunt ook geen wijzigingensets maken, bijwerken of sluiten. * uw private GPS-traces downloaden Het wordt aanbevolen om [http://www.openstreetmap.org/user/new?referer=%2F een gebruikersaccount voor OSM te maken]. Door [http://www.openstreetmap.org/user/new?referer=%2F dit formulier] te gebruiken kunt u een '''gebruikersnaam voor OSM''' en een '''wachtwoord voor OSM''' kiezen die u beide hieronder zult gebruiken. === Basis authenticatie === Basis authenticatie is het basismechanisme om uzelf te authenticeren bij de server van OSM. Hier is een schermafdruk van het paneel met voorkeuren voor de basis authenticatie: [[Image(basic-authentication.png)]] Basis authenticatie gebruiken 1. Ga naar de tab '''Authenticatie''' in het venster Verbindingsinstellingen 2. Selecteer de methode voor authenticatie '''Basis authenticatie''' 3. Voer uw gebruikersnaam voor OSM en uw wachtwoord voor OSM in {{{ #!html

Waarschuwing!
Het wachtwoord wordt in platte tekst opgeslagen in het voorkeurenbestand van JOSM. Verder wordt het niet versleuteld overgedragen bij elk verzoek dat naar de server van OSM wordt verzonden. Gebruik geen waardevol wachtwoord.

}}} === Op OAuth gebaseerde authenticatie === [http://oauth.net/ OAuth] is een open protocol om veilige API-autorisatie mogelijk te maken als een eenvoudige en standaard methode vanaf het bureaublad en vanuit webtoepassingen. De server van OSM ondersteunt OAuth in aanvulling op de basis authenticatie. OAuth heeft twee belangrijke voordelen op basis authenticatie: 1. Uw wachtwoord voor OSM hoeft niet in heldere tekst te worden opgeslagen in het voorkeurenbestand van JOSM. 2. Uw wachtwoord voor OSM behoeft slechts '''eenmaal''' te worden overgedragen over het internet, in tegenstelling tot de basis authenticatie waar uw wachtwoord voor OSM wordt overgedragen als deel van elk verzonden verzoek van JOSM aan de server van OSM. {{{ #!html

Waarschuwing!
Momenteel biedt de server van OSM geen veilig communicatiekanaal aan. Zelfs als u OAuth gebruikt wordt uw wachtwoord daarom éénmaal in heldere tekst over het internet verzonden. Gebruik geen waardevol wachtwoord totdat de server van OSM een veilig communicatiekanaal verschaft (HTTPS).

}}} Voor gevorderde gebruikers heeft OAuth aanvullende voordelen: * Met OAuth kunt u Access Tokens met beperkingen genereren waarmee u iemand anders, zodat die andere mapper ten behoeve van u kan handelen. Een mapper zou bijvoorbeeld een Access Token kunnen genereren waarbij hij aaniemand anders het recht gunt om zijn private GPS-traces te downloaden. Zelfs als hij dit Access Token aan iemand anders geeft bijlft zijn wachtwoord voor OSM privé gehouden. In aanvulling daarop kan hij het speciale Access Token op elk moment intrekken. JOSM ondersteunt dit soort gevorderde configuratie in de [wiki:/Help/Dialog/OAuthAuthorisationWizard OAuth Autorisatie Wizard] met de authorisatieprocedure '''Handmatige authorisatie'''. Op OAuth gebaseerde authenticatie gebruiken 1. In Verbindingsinstellingen, ga naar de tab '''Authenticatie''' 2. Selecteer de authenticatiemethode '''OAuth gebaseerde authenticatie''' 3. Klik op '''Nu autoriseren''' om de [wiki:/Help/Dialog/OAuthAuthorisationWizard OAuth Autorisatie Wizard] te starten (zie schermafdruk hieronder) [[Image(oauth-preferences-step-1.png)]] 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'''. JOSM displays the retrieved Access Token in the preferences panel (see screenshot below): [[Image(oauth-preferences-step-2.png)]] 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. 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. Click on '''New Access Token''' to generate a new Access Token. ==== Advanced OAuth parameters ==== Select the checkbox '''Display Advanced OAuth parameters''' to display the important OAuth parameters * 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 * the Request Token URL where JOSM can retrieve [http://oauth.net/core/1.0/#anchor3 Request Tokens] * the Access Token URL where JOSM can retrieve [http://oauth.net/core/1.0/#anchor3 Access Tokens] * the Authorise URL where JOSM users are redirected to to authorise a Request Token [[Image(oauth-advanced.png)]] == Proxy Settings == #ProxySettings 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]. 1. Go to the tab '''Proxy settings''' in the Connection Preferences 2. Select one of the available options and enter additional configuration parameters 3. Save the preferences [[Image(proxy-settings.png)]] === Using the standard system proxy === 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 {{{java -Djava.net.useSystemProxies=true -jar josm.jar}}} === Using the manually configured proxy === 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. ---- Back to [wiki:/Help/Action/Preferences Preferences][[Br]] Back to [wiki:Help Main Help]