[[TranslatedPages]]
= Preferencias > Ajustes de Conexión = 

[[TOC(inline)]]

== La dirección URL del servidor de OSM == #ApiUrl

=== Subir y descargar en el servidor por defecto ===

[[Image(use-default-api-url.png)]]

La mayoría de los usuarios de JOSM desean intercambiar datos geográficos con el servidor de OSM estándar operado por la comunidad de OSM.

Marque la casilla correspondiente con el fin de descargar y subir en el servidor estándar (ver imagen superior). Esta es la configuración por defecto.

=== Opción avanzada: Descargar y subir a un servidor personalizado === 
Algunos usuarios de JOSM necesitan configurar la dirección URL de la API de un servidor de OSM porque están trabajando con un servidor personalizado:
  * Algunos usuarios están trabajando con las instalaciones locales del servidor de OSM
  * Algunos usuarios están trabajando con instancias de desarrollo y de pruebas del servidor de OSM (por ejemplo, con [http://api06.dev.openstreetmap.org]).

[[Image(use-custom-api-url.png)]]

Para utilizar una URL personalizada:
  1. Quitar la marca de la casilla de verificación de dirección URL de la API estándar (ver imagen superior)
  2. Introduzca la dirección URL de la API

Haga clic en '''Validar''' para comprobar si un servidor de la API de OSM está disponible en la URL. Si es así, JOSM mostrará el icono [[Image(source:/trunk/images/dialogs/changeset/valid.png)]] a la derecha de la caja de texto para la dirección URL de la API. Si la dirección no es válida, JOSM mostrará el icono [[Image(source:/trunk/images/warning-small.png)]].

== Preferencias de Autenticación ==#AuthenticationSettings

=== Trabajo de forma anónima o con una cuenta de OSM ===

No es necesario identificarse y autenticarse siempre y cuando no suba datos al servidor de OSM ni descargue datos para lo cual debe autenticarse primero.

Si usted trabaja de '''forma anónima''' se le permite
  * para descargar datos geográficos desde el servidor de OSM y guardarlos en un archivo local
  * para descargar las trazas públicas de GPS desde el servidor de OSM
  * para cargar datos geográficos desde un archivo, editarlo y volver a guardarlo en un archivo

Sin embargo, no puede
  * subir datos geográficos al servidor de OSM. No se pueden crear, actualizar, o cerrar cualquier conjunto de cambios.
  * descargar sus trazas privados de GPS

Se recomienda [http://www.openstreetmap.org/user/new?referer=%2F crear una cuenta de usuario de OSM]. Al utilizar [http://www.openstreetmap.org/user/new?referer=%2F este formulario], usted puede elegir un '''nombre de usuario de OSM''' y una '''contraseña de OSM''', ambos de los cuales se van a utilizar a continuación.

=== Autenticación básica ===
La autenticación básica es el mecanismo básico para autenticarse en el servidor de OSM.

Aquí hay una captura de pantalla del panel de preferencias para la autenticación básica:

[[Image(basic-authentication.png)]]

Para utilizar la Autenticación Básica

  1. Ir a la ficha de '''Autenticación''' en los Ajustes de Conexión
  2. Seleccione el método de autenticación llamado '''Autenticación Básica'''
  3. Introduzca su nombre de usuario de OSM y su contraseña de OSM

{{{
#!html
<p style="background-color:rgb(253,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px;">
<strong>Advertencia!</strong><br/>
La contraseña es almacenada en texto plano en el archivo de preferencias de JOSM.
Por otra parte, se transfiere <strong>sin cifrar</strong> en cada solicitud enviada al servidor de OSM.
<strong>No utilice claves valiosas.</strong>
</p>
}}}

=== Autenticación basada en OAuth ===
[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. 

OAuth has two major advantages over basic authentication:
  1. Your OSM password doesn't have to be saved in clear text in the JOSM preferences file.
  2. Your OSM password has to be transferred '''only once''' over the Internet, in contrast to basic authentication where your OSM password is transferred as part of every request sent from JOSM to the OSM server. 

{{{
#!html
<p style="background-color:rgb(253,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px;">
<strong>Warning!</strong><br/>
Currently, the OSM server doesn't offer a secure communication channel. Even if you use OAuth your password is therefore transferred <strong>once in clear text</strong> over the Internet. <strong>Do not use a valuable password</strong> until the OSM server provides a secure communication channel (HTTPS).
</p>
}}}

For advanced users, OAuth has additional advantages:
  * 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'''. 

To use OAuth based Authentication

  1. In the Connection Preferences go to the tab '''Authentication'''
  2. Select the authentication method '''OAuth based authentication'''
  3. Click on '''Authorise now''' to launch the [wiki:/Help/Dialog/OAuthAuthorisationWizard OAuth Authorisation Wizard] (see screenshot below)

[[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}}}

----
Volver a [wiki:Es:Help/Action/Preferences Preferencias][[Br]]
Volver a [wiki:Es:Help Ayuda principal]