Electronic signatures on logbook entries (AC 120-78B chapter 2)

- Sign an entry: review exactly what's certified, choose a current
  certificate (eligibility checked: pilot only for preventive maintenance,
  inspections need their result and time), re-enter the password or sign
  in again with SSO (prompt=login, within 5 minutes), and confirm the
  "Certified by" statement (43.9 return to service, 43.11(a)(5) for
  inspections, preventive maintenance for pilots)
- The signature stores signer, certificate, statement, UTC time, how they
  authenticated, IP/browser, a SHA-256 fingerprint of the entry's content
  and a readable snapshot; an HMAC seal covers the signature record. Status
  shows Valid / Superseded / Altered since signing. The signer is emailed
- Signed entries (and their sub-components) can't be edited or deleted;
  a correction entry, once signed, supersedes the original (kept)
- Owners invite an outside mechanic by email to sign one entry: one-time,
  14-day link; they create or use their own account and certificate and
  see only that entry
- Admins can disable accounts (signed out, can't sign in or sign; past
  signatures kept); users with signatures can't be deleted
- Printouts show the electronic signature and fingerprint; archives carry
  signatures (marked imported, with their origin) and corrections

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rickyandClaude Opus 5.5 committed 2026-11-07 13:12:04 -05:00
1 parent 7caa213e7a
commit d719f663bc
47 files changed
+1059 -17

No files matched your search

+45
View File
@@ -0,0 +1,45 @@
# The signing steps shared by aircraft users and invited signers.
module EntrySigning
extend ActiveSupport::Concern
private
def signing_certificates = current_user.certificates.reject(&:expired?)
def prepare_signing(entry)
@certificates = signing_certificates
session[:after_reauth] = signing_page_path # where single sign-on returns after signing in again
end
# Password re-entered now, or single sign-on completed in the last few minutes.
def reauthenticated_method
if params[:password].present?
return "password" if current_user.authenticate_password(params[:password])
elsif current_user.sso_uid? && (at = session[:reauthenticated_at]) && Time.zone.at(at) > EntrySigner::REAUTH_WINDOW.ago
return "sso"
end
nil
end
def sign_entry(entry)
certificate = current_user.certificates.find_by(id: params[:certificate_id])
method = reauthenticated_method
unless params[:confirm] == "1"
return signing_failed(entry, "Tick the box to confirm you're signing this entry.")
end
return signing_failed(entry, "Re-enter your password (or sign in again with #{Sso.label}) to sign.") unless method
signature = EntrySigner.new(entry, user: current_user, certificate: certificate, auth_method: method, request: request).sign!
session.delete(:reauthenticated_at)
SignatureMailer.signed(signature).deliver_later if MailSettings.configured?
yield signature
rescue EntrySigner::Error => e
signing_failed(entry, e.message)
end
def signing_failed(entry, message)
prepare_signing(entry)
@signing_error = message
render :new, status: :unprocessable_entity
end
end