Validate: Authentication functions

Description Usage Arguments Details Value Examples


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")

Search within the rPlant package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.