Changes between Version 8 and Version 9 of udg/ecoms/RPackage/authentication

Timestamp:

Feb 14, 2014 1:31:01 PM (8 years ago)

Author:

juaco

Comment:

--

udg/ecoms/RPackage/authentication

@@ -1 +1 @@
 == Authentication
 
-The SPECS-EUPORIAS Data Portal is based on a password-protected THREDDS data server providing metadata and data access to a set of geo-referenced atmospheric variables using OPeNDAP and other remote data access protocols. Therefore, before accessing the data, authentication is required at the SPECS-EUPORIAS Data Portal. To this aim, user's must be registered and activate their role as EUPORIAS/SPECS users, following [wiki:EcomsUdg/DataServer/Registration these steps].
+The '''ECOMS-UDG''' is based on a password-protected THREDDS using OPeNDAP and other remote data access protocols. Therefore, before accessing the data, authentication is required. To this aim, user's must be registered and activate the required roles, as described in the [wiki:EcomsUdg/DataServer/Registration Registration section].
 
-Once registered as users, the registration within the R session can be easily accomplished assuming that we already have a valid username, role and password. To this aim, in the following lines we illustrate how to proceed using the R-to-Java interface provided by the package `rJava` (For more information on the authentication procedure click on [http://www.unidata.ucar.edu/software/netcdf-java/v4.3/javadocAll/ucar/nc2/util/net/HTTPBasicProvider.html the help page]).
+Once registered as users, the registration within the R session can be easily accomplished assuming that we already have a valid username, role and password, with a simple call to the function `loginECOMS_UDG`, providing HTPP authentication:
 
+{{{#!comment  To this aim, in the following lines we illustrate how to proceed using the R-to-Java interface provided by the package `rJava` (For more information on the authentication procedure click on [http://www.unidata.ucar.edu/software/netcdf-java/v4.3/javadocAll/ucar/nc2/util/net/HTTPBasicProvider.html the help page]).
+}}}
 
 {{{
 > username <- "myUsername" # This is a character string with the username
 > password <- "myPassword" # This is a character string with the password
-> aux <- .jnew("ucar/nc2/util/net/HTTPBasicProvider", username, password)
-> J("ucar.nc2.util.net.HTTPSession")$setGlobalCredentialsProvider(aux)
-
+> loginECOMS_UDG("myUsername", "myPassword")
 }}}
-
-
-== IMPORTANT: proxy server connections
 
 In case the connection is performed via a proxy, it is necessary to set up the proxy prior to the authentication step, in order to connect to the server.
@@ -22 +19 @@
 > proxyHost <- "proxy.host.com" # Your institution Proxy configuration: host
 > proxyPort <- as.integer(1234) # and port
-> J("ucar.nc2.util.net.HTTPSession")$setGlobalProxy(proxyHost,proxyPort)
-
+> loginECOMS_UDG("myUsername", "myPassword", proxy.host = proxyHost, proxy.port = proxyPort)
 }}}