Authentication functions


This basic function authenticates users.


Validate(user, pwd, api="agave", print.curl=FALSE)



iPlant Discovery Environment username


iPlant Discovery Environment password


The API to be interfaced with. The only supported API is "agave"


Prints the curl statement that can be used in the terminal, if curl is installed on your computer


All that is necessary for the Validate function is for the user to provide the username and password combination; then it will verify that they are a valid pair for iPlant. To get a valid pair of credentials go to and register.

Sometimes the API will have trouble validating. If this is the case, you will receive the following message from 'rPlant': "API Error, please retry". This only seems to occur in a new R session. If this occurs, please try the validation a second time. If it does not work the second time, then there may be a problem with your account.


The Validate function will create a new R environment that stores variables that communicate automatically with the API. These include, an access token (foundation) or an API consumer key and secret (agave), the expiration, the user name and password, and a few other variables. To see the entire list of environmental variables, see ls(rplant.env).

The function will print the error "Authentication failed" if if fails. Sometimes the API will require a second validation, in which case 'rPlant' will report an error asking you to retry. If it is successful, nothing will print to screen, however you can check that validation occurred by checking rplant.env$consumer_key and rplant.env$consumer_secret.

Validation will have to occur at every new R session. If a session times out and expires, you do not have to renew validation. If the rplant.env is an object found within the workspace, your token will be auto-renewed by using one of 'rPlant's' functions (ie. SubmitJob, CheckJobStatus, etc.).


## Not run: Validate("username", "password")
comments powered by Disqus