Skip to contents

Generate a LoginStudio object for the IQB Studio Lite

login_studio.Rd

Provides a routine to login to an instance of the IQB Studio Lite.

Usage

login_studio(
  base_url = "https://www.iqb-studio.de/",
  app_version = "16.0.0",
  keyring = FALSE,
  change_key = FALSE,
  dialog = TRUE,
  verbose = FALSE
)

Arguments

base_url

Character. Base URL of the hosted instance of the IQB Studio Lite. Default is the https://www.iqb-studio.de/.

app_version

Character. App version of the IQB Studio instance. Defaults to "16.0.0"; the server version is not detected automatically. Set this explicitly to the version used by your Studio instance.

keyring

Logical. Should the keyring::keyring package be used to save the passkey? This saves your credentials to your local machine. Defaults to FALSE.

change_key

Logical. If your password on the domain has changed - should the keyring::keyring password be changed? Defaults to FALSE.

dialog

Logical. Should credentials be entered using a GUI dialog with masked password input (TRUE) or using the console (FALSE). Defaults to TRUE.

verbose

Logical. If TRUE, additional information is printed. Defaults to FALSE.

Value

An object of the LoginStudio class.

Details

The login request sends the username and password as a JSON body to {base_url}/api/login. An equivalent curl request is:

curl --request POST '{base_url}/api/login' \
  --header 'app-version: {app_version}' \
  --header 'Content-Type: application/json' \
  --data '{"username":"{name}","password":"{password}"}'

The returned LoginStudio object contains workspace information and a request function that uses the access token for subsequent API calls. It does not retain the password. With keyring = TRUE, credentials are saved separately in the local credential store and reused on later logins.