connect: Connect to a openeEO service
In flahn/openeo-r-client: openEO client interface

Description Usage Arguments Details See Also Examples

Connects to openEO service. If the backend provides a well-known endpoint that allows for redirecting to specific versions, then you should provide the versions parameter.

connect(
  host,
  version = NULL,
  user = NULL,
  password = NULL,
  login_type = NULL,
  exchange_token = "access_token",
  provider = NULL,
  config = NULL
)

`host`	URL pointing to the openEO server service host
`version`	the version number as string (optional)
`user`	the user name (optional)
`password`	the password (optional)
`login_type`	either NULL, 'basic' or 'oidc'. This refers to the login mechanism that shall be used. NULL disables authentication.
`exchange_token`	'access_token' or 'id_token' defines in the OIDC case the bearer token use
`provider`	provider object as obtained by 'list_oidc_providers()'
`config`	named list containing 'client_id' and 'sercret' or a path to the configuration file (type JSON)

You can explore several already available openEO web services by using the openEO hub (https://hub.openeo.org/). There you have an overview about their status, connection details like the URL and supported features. You can always explore the service for free, meaning you have access to publicly available metadata of data collections as well as the offered processing functions. For any computations and the creation of webservices you need to register the openEO partner of your choice. Then you will get further information on credentials and the login procedure.

Especially the login_type and the authType suggested by the client development guidelines are confusing. Here the login_type deals just with considered login. Meaning 'basic' allows you to use username and password directly in the call, whereas 'oidc' will open up a browser window, where you enter you credentials. The authentication against all protected endpoints will later use the bearer token that the client has obtained after the login, unless the authentication was dropped with NULL anyways.

The parameter version is not required. If the service offers a well-known document of the service the client will choose an appropriate version (default the most recent production ready version).

When calling this function the OpenEOClient is also stored in a variable in the package which marks the latest service that was connected to.

active_connection

## Not run: 
# The following examples show different configuration settings and point 
# to imaginary URLs. Please obtain a valid URL via the openEO hub and 
# register with one of the provider if required.

# connect to a host with specific version and without authentication
con = connect(host='http://example.openeo.org',version='1.0.0-rc.2')

# connect to a host by direct url and basic login
con = connect(host='http://example.openeo.org/v1.0',
              user='user',
             password='password',
             login_type='basic')

# connect to a host with open id connect authentication
con = connect(host='http://example.openeo.org',
              version='1.0.0-rc.2',
              login_type='oidc')

## End(Not run)