Files
openproject/app/models/token/base.rb
T
Jan Sandbrink 4d305df714 Allow to use API Tokens as Bearer tokens
We generate those tokens with a prefix, so that we
can decide by looking at a token, whether it's an API Token
or a different kind of token, so that we can decide which
code path to choose for validating the token.

The usage of access tokens as Bearer token has the usability advantage,
that you can paste them as plaintext into tools that expect you
to specify the token as a header.

Also the Basic auth approach for our old tokens usually rather caused
issues, such as browsers prompting for credentials in surprising situations.
If we were to deprecate basic authentication one day, this change today could've
been the first step towards that.
2026-02-05 08:07:04 +01:00

128 lines
3.8 KiB
Ruby

# frozen_string_literal: true
#-- copyright
# OpenProject is an open source project management software.
# Copyright (C) the OpenProject GmbH
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License version 3.
#
# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
# Copyright (C) 2006-2013 Jean-Philippe Lang
# Copyright (C) 2010-2013 the ChiliProject Team
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
#
# See COPYRIGHT and LICENSE files for more details.
#++
# Redmine - project management software
# Copyright (C) 2006-2009 Jean-Philippe Lang
# Adapted to fit needs for mOTP
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
module Token
class Base < ApplicationRecord
self.table_name = "tokens"
serialize :data, coder: ::Serializers::IndifferentHashSerializer
# Tokens belong to a user and are unique per type
belongs_to :user, optional: false
# Create a plain and hashed value when creating a new token
after_initialize :initialize_values
# Ensure uniqueness of the token value
validates :value, presence: true
validates :value, uniqueness: true
# Delete previous token of this type upon save
before_save :delete_previous_token
class << self
##
# A DSL method allowing to define a prefix for all generated tokens, making it possible to recognize
# the purpose of a token by looking at the token value.
#
# class MyToken < HashedToken
# prefix :my
# end
def prefix(value = nil)
@prefix = value.to_s if value
@prefix
end
##
# Find a token from the token value
def find_by_plaintext_value(input)
find_by(value: input)
end
##
# Find tokens for the given user
def for_user(user)
where(user:)
end
##
# Generate a random hex token value
def generate_token_value
[prefix, SecureRandom.hex(32)].compact.join("-")
end
end
##
# Get the value for the token.
def display_value
value
end
protected
##
# Allows only a single value of the token?
def single_value?
true
end
# Removes obsolete tokens (same user and action)
def delete_previous_token
if single_value? && user
self.class.where(user_id: user.id, type:).delete_all
end
end
def initialize_values
if new_record? && !value.present?
self.value = self.class.generate_token_value
end
end
end
end