Nothing
# This file contains ready-to-use provider constructors
# Used for creating common provider configurations with endpoints and defaults
# already filled in
# 1 Provider constructors ------------------------------------------------------
## 1.1 Generic OIDC construction -----------------------------------------------
#' @title
#' Create a generic OpenID Connect (OIDC) [OAuthProvider]
#'
#' @description
#' Helper for providers that follow a standard OpenID Connect endpoint layout.
#' It builds the usual OIDC endpoints from one base URL and then calls
#' [oauth_provider()] with OIDC-friendly defaults.
#'
#' @param name Friendly name for the provider
#' @param base_url Base URL for OIDC endpoints
#' @param auth_path Authorization endpoint path (default: "/authorize")
#' @param token_path Token endpoint path (default: "/token")
#' @param userinfo_path User info endpoint path (default: "/userinfo")
#' @param introspection_path Token introspection endpoint path (default: "/introspect")
#' @param use_nonce Logical, whether to use OIDC nonce. Defaults to TRUE
#' @param id_token_validation Logical, whether to validate ID tokens automatically
#' for this provider. Defaults to TRUE
#' @param jwks_host_issuer_match When TRUE (default), enforce that the JWKS host
#' discovered from the provider matches the issuer host exactly. For
#' providers that serve JWKS from a different host (e.g., Google), set
#' `jwks_host_allow_only` to the exact hostname instead of disabling this.
#' Disabling (`FALSE`) is not recommended unless you also pin JWKS via
#' `jwks_host_allow_only` or `jwks_pins`
#' @param allowed_token_types Character vector of allowed token types for
#' access tokens issued by this provider. Defaults to 'Bearer'
#' @param ... Additional arguments passed to [oauth_provider()]
#'
#' @return [OAuthProvider] object
#'
#' @example inst/examples/oauth_provider.R
#'
#' @export
oauth_provider_oidc <- function(
name,
base_url,
auth_path = "/authorize",
token_path = "/token",
userinfo_path = "/userinfo",
introspection_path = "/introspect",
use_nonce = TRUE,
id_token_validation = TRUE,
jwks_host_issuer_match = TRUE,
allowed_token_types = c('Bearer'),
...
) {
base_url <- sub("/+$", "", base_url)
auth_url <- paste0(base_url, auth_path)
token_url <- paste0(base_url, token_path)
userinfo_url <- paste0(base_url, userinfo_path)
introspection_url <- paste0(base_url, introspection_path)
oauth_provider(
name = name,
auth_url = auth_url,
token_url = token_url,
userinfo_url = userinfo_url,
introspection_url = introspection_url,
issuer = base_url,
use_nonce = use_nonce,
id_token_validation = id_token_validation,
token_auth_style = "header",
allowed_token_types = allowed_token_types,
jwks_host_issuer_match = jwks_host_issuer_match,
...
)
}
## 1.2 Direct-configured provider presets --------------------------------------
#' Create a GitHub [OAuthProvider]
#'
#' @description
#' Ready-to-use OAuth 2.0 provider settings for GitHub.
#'
#' @details
#' You can register a new GitHub OAuth 2.0 app in your
#' ['Developer Settings'](https://github.com/settings/apps).
#'
#' @param name Optional provider name (default "github")
#'
#' @return [OAuthProvider] object for use with a GitHub OAuth 2.0 app
#'
#' @example inst/examples/oauth_provider.R
#'
#' @export
oauth_provider_github <- function(name = "github") {
oauth_provider(
name = name,
auth_url = "https://github.com/login/oauth/authorize",
token_url = "https://github.com/login/oauth/access_token",
userinfo_url = "https://api.github.com/user",
introspection_url = NA_character_,
issuer = NA_character_,
use_nonce = FALSE,
use_pkce = TRUE,
pkce_method = "S256",
token_auth_style = "body",
extra_auth_params = list(),
extra_token_params = list(),
extra_token_headers = c(Accept = "application/json"),
userinfo_required = TRUE,
userinfo_id_token_match = FALSE,
userinfo_id_selector = function(userinfo) as.character(userinfo$id)
)
}
#' Create a Google [OAuthProvider]
#'
#' @description
#' Ready-to-use [OAuthProvider] settings for Google.
#'
#' @param name Optional provider name (default "google")
#'
#' @return [OAuthProvider] object for use with a Google OAuth 2.0 app
#'
#' @details
#' You can register a new Google OAuth 2.0 app in the
#' [Google Cloud Console](https://console.cloud.google.com/apis/credentials).
#' Configure the client ID & secret in your [OAuthClient].
#'
#' @example inst/examples/oauth_provider.R
#'
#' @export
oauth_provider_google <- function(name = "google") {
# Route through oauth_provider() so a reusable JWKS cache is initialized
oauth_provider(
name = name,
auth_url = "https://accounts.google.com/o/oauth2/v2/auth",
token_url = "https://oauth2.googleapis.com/token",
revocation_url = "https://oauth2.googleapis.com/revoke",
userinfo_url = "https://openidconnect.googleapis.com/v1/userinfo",
issuer = "https://accounts.google.com",
use_nonce = TRUE,
token_auth_style = "header",
extra_auth_params = list(access_type = "offline"),
userinfo_required = TRUE,
userinfo_id_token_match = TRUE,
id_token_required = TRUE,
id_token_validation = TRUE,
# Pin JWKS to Google's host; allow-only normalized to host
jwks_host_allow_only = "www.googleapis.com"
)
}
#' Create a Microsoft (Entra ID) [OAuthProvider]
#'
#' @description
#' Ready-to-use [OAuthProvider] settings for Microsoft Entra ID (formerly Azure
#' AD) using the v2.0 endpoints. Accepts a tenant identifier and configures the
#' authorization, token, and userinfo endpoints directly.
#'
#' @details
#' Most users only need to choose the tenant and decide whether to keep ID
#' token validation enabled. The remaining details below explain how the helper
#' behaves for Microsoft's different tenant styles.
#'
#' The `tenant` can be one of the special values "common", "organizations",
#' or "consumers", or a specific directory (tenant) ID GUID
#' (e.g., "00000000-0000-0000-0000-000000000000").
#'
#' When `tenant` is a specific GUID, the provider enables strict ID token
#' validation with the tenant-specific issuer.
#'
#' For `tenant = "common"` or `tenant = "organizations"`, the helper enables
#' Microsoft Entra's tenant-independent validation mode by default: ID tokens
#' are checked against Microsoft's `{tenantid}` issuer template and the signing
#' key's own `issuer` scope, as documented by Microsoft for multi-tenant
#' metadata. Runtime JWKS discovery for these aliases also uses host-only
#' discovery issuer matching because Microsoft's tenant-independent metadata
#' publishes a templated issuer rather than echoing the alias URL exactly.
#'
#' For `tenant = "consumers"`, the helper resolves the stable consumer tenant
#' issuer (`9188040d-6c67-4c5b-b112-36a304b66dad`) and performs normal exact-
#' issuer validation.
#'
#' Set `id_token_validation = FALSE` to opt out of ID token and nonce
#' validation for these aliases, which falls back to OAuth 2.0 plus userinfo
#' identity only.
#'
#' Microsoft issues RS256 ID tokens; `allowed_algs` is restricted accordingly.
#' The userinfo endpoint is provided by Microsoft Graph
#' (https://graph.microsoft.com/oidc/userinfo).
#'
#' When configuring your [OAuthClient], if you do not have the option to
#' register an app or simply wish to test during development, you may be able
#' to use the default Azure CLI public app, with `client_id`
#' '04b07795-8ddb-461a-bbee-02f9e1bf7b46' (uses `redirect_uri`
#' 'http://localhost:8100').
#'
#' @param name Optional friendly name for the provider. Defaults to "microsoft"
#' @param tenant Tenant identifier ("common", "organizations", "consumers",
#' or directory GUID). Defaults to "common"
#' @param id_token_validation Optional override (logical). If `NULL` (default),
#' it's enabled automatically when `tenant` looks like a GUID or one of the
#' Microsoft alias tenants (`common`, `organizations`, `consumers`).
#' `common` and `organizations` use Microsoft's tenant-independent issuer and
#' signing-key validation rules; `consumers` uses the stable consumer tenant
#' issuer
#'
#' @return [OAuthProvider] object configured for Microsoft identity platform
#'
#' @example inst/examples/oauth_provider_microsoft.R
#'
#' @export
oauth_provider_microsoft <- function(
name = "microsoft",
tenant = c("common", "organizations", "consumers"),
id_token_validation = NULL
) {
tenant <- tenant[1]
if (!is_valid_string(tenant)) {
err_input("tenant must be a non-empty string")
}
consumer_tenant_guid <- "9188040d-6c67-4c5b-b112-36a304b66dad"
tenant_independent_alias <- tenant %in% c("common", "organizations")
consumer_alias <- identical(tenant, "consumers")
is_guid <- is_guid_like(tenant)
if (is.null(id_token_validation)) {
id_token_validation <- is_guid || tenant_independent_alias || consumer_alias
}
base <- sprintf("https://login.microsoftonline.com/%s/oauth2/v2.0", tenant)
auth_url <- paste0(base, "/authorize")
token_url <- paste0(base, "/token")
userinfo_url <- "https://graph.microsoft.com/oidc/userinfo"
issuer <- if (is_guid) {
sprintf("https://login.microsoftonline.com/%s/v2.0", tenant)
} else if (!isTRUE(id_token_validation)) {
NA_character_
} else if (tenant_independent_alias) {
sprintf("https://login.microsoftonline.com/%s/v2.0", tenant)
} else if (consumer_alias) {
sprintf("https://login.microsoftonline.com/%s/v2.0", consumer_tenant_guid)
} else {
NA_character_
}
issuer_match <- if (tenant_independent_alias && isTRUE(id_token_validation)) {
"host"
} else {
"url"
}
oauth_provider(
name = name,
auth_url = auth_url,
token_url = token_url,
userinfo_url = userinfo_url,
introspection_url = NA_character_,
issuer = issuer,
issuer_match = issuer_match,
use_nonce = isTRUE(id_token_validation),
use_pkce = TRUE,
pkce_method = "S256",
token_auth_style = "body",
extra_auth_params = list(),
extra_token_params = list(),
extra_token_headers = character(),
allowed_algs = c("RS256"),
userinfo_required = TRUE,
userinfo_id_token_match = isTRUE(id_token_validation),
userinfo_id_selector = function(userinfo) userinfo$sub,
id_token_required = isTRUE(id_token_validation),
id_token_validation = isTRUE(id_token_validation)
)
}
#' Create a Spotify [OAuthProvider]
#'
#' @description
#' Ready-to-use OAuth 2.0 provider settings for Spotify.
#' It uses `/v1/me` as the user profile endpoint and does not expect ID tokens.
#'
#' @param name Optional provider name (default "spotify")
#' @details
#' Spotify requires scopes to be included in the authorization request.
#' Set requested scopes on the client with `oauth_client(..., scopes = ...)`.
#'
#' @return [OAuthProvider] object for use with a Spotify OAuth 2.0 app
#'
#' @example inst/examples/oauth_provider.R
#' @seealso
#' For an example application which using Spotify OAuth 2.0 login to
#' display the user's listening data, see `vignette("example-spotify")`.
#'
#' @export
oauth_provider_spotify <- function(
name = "spotify"
) {
oauth_provider(
name = name,
auth_url = "https://accounts.spotify.com/authorize",
token_url = "https://accounts.spotify.com/api/token",
userinfo_url = "https://api.spotify.com/v1/me",
introspection_url = NA_character_,
issuer = NA_character_,
use_nonce = FALSE,
use_pkce = TRUE,
pkce_method = "S256",
extra_auth_params = list(),
extra_token_params = list(),
extra_token_headers = character(),
token_auth_style = "header",
userinfo_id_selector = function(userinfo) as.character(userinfo$id),
userinfo_required = TRUE,
userinfo_id_token_match = FALSE,
id_token_required = FALSE,
id_token_validation = FALSE
)
}
## 1.3 Discovery-backed provider presets ---------------------------------------
#' Create a Slack [OAuthProvider] (via OIDC discovery)
#'
#' @param name Optional provider name (default "slack")
#'
#' @return [OAuthProvider] object configured for Slack
#'
#' @example inst/examples/oauth_provider.R
#'
#' @export
oauth_provider_slack <- function(name = "slack") {
oauth_provider_oidc_discover(issuer = "https://slack.com", name = name)
}
#' Create a Keycloak [OAuthProvider] (via OIDC discovery)
#'
#' @param base_url Base URL of the Keycloak server, e.g.,
#' "http://localhost:8080"
#' @param realm Keycloak realm name, e.g., "myrealm"
#' @param name Optional provider name. Defaults to `paste0('keycloak-', realm)`
#' @param token_auth_style Optional override for token endpoint authentication
#' method. One of "header" (client_secret_basic), "body"
#' (client_secret_post), "public" (send `client_id` only; `"none"` alias also
#' accepted), "private_key_jwt", or "client_secret_jwt". Defaults
#' to "body" for Keycloak, which works for many common setups. Use `"public"`
#' if you need to suppress `client_secret` even when it is set in the
#' environment. If you pass `NULL`, discovery will infer the method from the
#' provider's `token_endpoint_auth_methods_supported` metadata.
#'
#' @return [OAuthProvider] object configured for the specified Keycloak realm
#'
#' @example inst/examples/oauth_provider.R
#'
#' @export
oauth_provider_keycloak <- function(
base_url,
realm,
name = paste0("keycloak-", realm),
token_auth_style = "body"
) {
if (!is_valid_string(base_url)) {
err_input("base_url must be a non-empty string")
}
if (!is_valid_string(realm)) {
err_input("realm must be a non-empty string")
}
issuer <- paste0(rtrim_slash(base_url), "/realms/", realm)
oauth_provider_oidc_discover(
issuer = issuer,
name = name,
token_auth_style = token_auth_style
)
}
#' Create an Okta [OAuthProvider] (via OIDC discovery)
#'
#' @param domain Your Okta domain, e.g., "dev-123456.okta.com"
#' @param auth_server Authorization server ID (default "default")
#' @param name Optional provider name (default "okta")
#'
#' @return [OAuthProvider] object configured for the specified Okta domain
#'
#' @example inst/examples/oauth_provider.R
#'
#' @export
oauth_provider_okta <- function(
domain,
auth_server = "default",
name = "okta"
) {
if (!is_valid_string(domain)) {
err_input("domain must be a non-empty string")
}
base <- if (grepl("^https?://", domain)) {
domain
} else {
paste0("https://", domain)
}
issuer <- paste0(rtrim_slash(base), "/oauth2/", auth_server)
oauth_provider_oidc_discover(
issuer = issuer,
name = name
)
}
#' Create an Auth0 [OAuthProvider] (via OIDC discovery)
#'
#' @param domain Your Auth0 domain, e.g., "your-domain.auth0.com"
#' @param name Optional provider name (default "auth0")
#' @param audience Optional audience value to send in authorization requests.
#'
#' @return [OAuthProvider] object configured for the specified Auth0 domain
#'
#' @example inst/examples/oauth_provider.R
#'
#' @export
oauth_provider_auth0 <- function(domain, name = "auth0", audience = NULL) {
if (!is_valid_string(domain)) {
err_input("domain must be a non-empty string")
}
base <- if (grepl("^https?://", domain)) {
domain
} else {
paste0("https://", domain)
}
issuer <- rtrim_slash(base)
extra_auth <- if (!is.null(audience)) list(audience = audience) else list()
oauth_provider_oidc_discover(
issuer = issuer,
name = name,
extra_auth_params = extra_auth
)
}
# 2 Helpers --------------------------------------------------------------------
## 2.1 Microsoft-specific helpers ----------------------------------------------
#' Check whether a value looks like a GUID
#'
#' Used by [oauth_provider_microsoft()] and tenant-independent ID token
#' validation helpers.
#'
#' @param value Candidate tenant identifier.
#' @return `TRUE` when `value` is a single GUID-like string; otherwise `FALSE`.
#' @keywords internal
#' @noRd
is_guid_like <- function(value) {
is.character(value) &&
length(value) == 1L &&
!is.na(value) &&
grepl(
"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
value
)
}
#' Detect a tenant-independent Microsoft issuer
#'
#' Used by Microsoft-specific issuer handling when tenant-independent
#' authorities are configured.
#'
#' @param issuer Issuer URL to inspect.
#' @return A normalized tenant-independent issuer path, or `NULL` when `issuer`
#' is not one of the supported Microsoft tenant-independent authorities.
#' @keywords internal
#' @noRd
microsoft_tenant_independent_issuer <- function(issuer) {
if (!is_valid_string(issuer)) {
return(NULL)
}
parsed <- try(httr2::url_parse(issuer), silent = TRUE)
if (inherits(parsed, "try-error")) {
return(NULL)
}
host <- tolower(parsed$hostname %||% "")
path <- tolower(gsub("^/+|/+$", "", parsed$path %||% ""))
if (!identical(host, "login.microsoftonline.com")) {
return(NULL)
}
if (path %in% c("common/v2.0", "organizations/v2.0")) {
return(path)
}
NULL
}
#' Resolve the expected ID token issuer
#'
#' Used before issuer comparison during Microsoft tenant-independent token
#' validation.
#'
#' @param provider_issuer Configured provider issuer.
#' @param token_payload Parsed ID token payload.
#' @return A list containing `expected_issuer`, `enforce_key_issuer`, and
#' `token_tid`.
#' @keywords internal
#' @noRd
resolve_expected_id_token_issuer <- function(provider_issuer, token_payload) {
if (is.null(microsoft_tenant_independent_issuer(provider_issuer))) {
return(list(
expected_issuer = provider_issuer,
enforce_key_issuer = FALSE,
token_tid = NULL
))
}
token_tid <- token_payload$tid %||% NULL
if (!is_guid_like(token_tid)) {
err_id_token(c(
"x" = "Microsoft ID token missing or invalid tid claim",
"i" = paste(
"Tenant-independent Microsoft authorities require a GUID tid claim"
)
))
}
list(
expected_issuer = sprintf(
"https://login.microsoftonline.com/%s/v2.0",
token_tid
),
enforce_key_issuer = TRUE,
token_tid = token_tid
)
}
#' Filter Microsoft JWKS keys by token issuer
#'
#' Used only for tenant-independent Microsoft authorities after candidate keys
#' have been selected.
#'
#' @param keys Candidate JWKS keys.
#' @param provider_issuer Configured provider issuer.
#' @param token_issuer Issuer claim from the token being validated.
#' @param token_tid Tenant id claim from the token being validated.
#' @return The subset of `keys` that matches the token issuer context.
#' @keywords internal
#' @noRd
filter_microsoft_jwks_for_token_issuer <- function(
keys,
provider_issuer,
token_issuer,
token_tid
) {
if (
is.null(microsoft_tenant_independent_issuer(provider_issuer)) ||
length(keys) == 0L ||
!is_valid_string(token_issuer) ||
!is_guid_like(token_tid)
) {
return(keys)
}
keep <- vapply(
keys,
function(key) {
key_issuer <- key$issuer %||% NULL
if (!is_valid_string(key_issuer)) {
return(FALSE)
}
if (grepl("\\{tenantid\\}", key_issuer, ignore.case = TRUE)) {
key_issuer <- gsub(
"\\{tenantid\\}",
token_tid,
key_issuer,
ignore.case = TRUE
)
}
identical(key_issuer, token_issuer)
},
logical(1)
)
keys[keep]
}
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.