Invitation codes: a link that gives an account and roles

Ported from the original (InvitationCode), adapted to configurable roles.

- Admin → Invitations: a label, optionally one email address (only it can
  use the link, and it's emailed) and a name, how many uses (or
  unlimited), an expiry (or never), and a role on any aircraft (or none,
  for an account only).
- An aircraft's Access page: whoever manages its people invites to that
  aircraft, with only the roles they can give; they see and revoke its
  invitations.
- /join/<code>: shows what it gives; create an account (when password
  sign-in is on) or sign in, then accept. Existing accounts and SSO users
  accept too. A role someone already has on an aircraft stays.
- Roles are given as the invitation's creator (AircraftAccess), and only
  while they can still manage that aircraft's people. Codes are kept as
  digests and shown once; uses are counted under a lock; account creation
  and accepting are rate-limited; any invalid link gets the same answer.
- Docs: guide (Administration, Access & sharing), README, and why /join
  isn't on the Authentik bypass list. The README's not-yet-ported list
  now names Prometheus metrics, and no longer claims oil analysis import
  as new.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rickyandClaude Opus 5.5 committed 2026-11-15 18:50:58 -05:00
1 parent a645778f26
commit b4c7aaa3ff
34 files changed
+822 -7

No files matched your search

@@ -0,0 +1,34 @@
# Invitation codes for one aircraft (AccessInvitation), from its Access page,
# by whoever manages its people: only the roles they can give (AircraftAccess).
class AircraftInvitationsController < ApplicationController
include AircraftScoped
requires_permission :manage_people
def create
role = AircraftAccess.new(@aircraft, actor: current_user).assignable_roles.find { _1.id == params[:role_id].to_i }
return back(alert: t("services.aircraft_access.owner_only")) unless role
attributes = params.permit(:label, :email, :name, :max_uses, :expires_at).to_h.symbolize_keys
attributes[:label] = t("flash.aircraft_invitations.default_label", tail_number: @aircraft.tail_number) if attributes[:label].blank?
@invitation = AccessInvitation.create_for(current_user, attributes, [ [ @aircraft, role ] ])
return back(alert: @invitation.errors.full_messages.to_sentence) unless @invitation.persisted?
log_event("role", t("flash.aircraft_invitations.created_event", role: role.name), notes: @invitation.label)
render :created
end
# Only invitations for this aircraft alone; others are managed in Admin → Invitations.
def destroy
invitation = AccessInvitation.where(id: self.class.only_for(@aircraft)).find(params[:id])
invitation.update!(revoked_at: Time.current)
log_event("role", t("flash.aircraft_invitations.revoked_event"), notes: invitation.label)
back(notice: t("flash.aircraft_invitations.revoked"))
end
# Ids of the invitations that give a role on this aircraft and no other.
def self.only_for(aircraft)
AccessInvitationRole.group(:access_invitation_id).having("COUNT(*) = 1 AND MAX(aircraft_id) = ?", aircraft.id).select(:access_invitation_id)
end
private
def back(flash) = redirect_to(aircraft_aircraft_roles_path(@aircraft, anchor: "invitations"), flash)
end