Store Credentials in Keyring — formr_store

Securely stores formr credentials in the system keyring. This function supports two modes:

Classic Mode: Stores email/password (and optional 2FA) for a specific account name.
API Mode: Stores OAuth credentials or Access Tokens for a specific host.

Usage

formr_store_keys(
  account_name = NULL,
  email = NULL,
  password = NULL,
  secret_2fa = NULL,
  host = "https://rforms.org",
  client_id = NULL,
  client_secret = NULL,
  access_token = NULL,
  account = NULL,
  verbose = TRUE
)

Arguments

account_name: (Classic) A shorthand name for the account. If provided, Classic mode is triggered.
email: (Classic) Email address for the account. Will be prompted if omitted.
password: (Classic) Optional. Provide to skip interactive prompt (useful for scripts/tests).
secret_2fa: (Classic) A 2FA secret. Set to NULL to be prompted, or "" if not used.
host: (API) The API URL (e.g., https://rforms.org). Defaults to rforms.org.
client_id: (API) OAuth Client ID.
client_secret: (API) OAuth Client Secret.
access_token: (API) Direct Personal Access Token (alternative to OAuth).
account: (API) Optional string identifier for multiple accounts on the same host.
verbose: Logical. If TRUE (default), reports progress via message().

Value

Invisibly NULL; called for its side effect of storing the password and 2FA seed in the system keyring.

Examples

if (FALSE) { # \dontrun{
# Not run: prompts interactively and writes to the system keyring.
# --- Classic EXAMPLES ---
# Prompts for password interactively
formr_store_keys("formr_diary_study_account")

# --- NEW API EXAMPLES ---

# Store OAuth Credentials for a custom host
formr_store_keys(host = "http://localhost",
                 client_id = "my-id",
                 client_secret = "my-secret")
                 
# Store token for a specific secondary account
formr_store_keys(host = "http://localhost",
                 client_id = "my-id",
                 client_secret = "my-secret",
                 account = "project_b")
} # }