Bearer

Read sessions from Authorization bearer tokens.

This page documents the current Ruby port behavior. Ruby uses snake_case option names and auth.api method names; HTTP paths and JSON keys keep the upstream wire shape where implemented.

Configure

config/auth.rb
require "better_auth"

auth = BetterAuth.auth(
  secret: ENV.fetch("BETTER_AUTH_SECRET"),
  base_url: ENV.fetch("BETTER_AUTH_URL", "http://localhost:3000"),
  plugins: [
    BetterAuth::Plugins.bearer
  ]
)

Usage

server.rb
sign_in = auth.api.sign_in_email(body: { email: "ada@example.com", password: "password123" })
session = auth.api.get_session(headers: { "authorization" => "Bearer #{sign_in[:token]}" })

Routes

This plugin does not add public routes.

Options

Current Ruby options accepted by BetterAuth::Plugins.bearer:

  • require_signature

Support Notes

  • The examples above are based on Ruby plugin source and tests in packages/better_auth.
  • If an upstream section is not represented here, treat it as not yet documented or not yet supported by the Ruby port until the matching Ruby implementation exists.

On this page