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

+12 -2
View File
@@ -55,7 +55,7 @@ module AircraftArchive
document_images: a.documents.includes(pages_attachments: :blob).flat_map do |d|
d.pages.map { |page| { id: id(page), document_id: id(d), notes: "", image: file(page, "health/documents") } }
end,
logbook_entries: a.logbook_entries.includes(:parts).map { logbook_hash(_1) },
logbook_entries: a.logbook_entries.includes(:parts, :signature).map { logbook_hash(_1) },
squawks: a.squawks.includes(:reported_by, attachments_attachments: :blob).map { squawk_hash(_1) },
inspection_types: inspection_types.map { inspection_type_hash(_1, component_ids) },
inspection_records: a.inspection_records.map do |r|
@@ -131,6 +131,15 @@ module AircraftArchive
picture: file(a.picture, "aircraft_pictures"), icao_type: a.icao_type }
end
# Carried as a record of the signature; the importing system can't re-check
# this server's seal, so it marks the signature as imported.
def signature_hash(sig)
{ signer_name: sig.signer_name, signer_email: sig.signer_email, certificate_kind: sig.certificate_kind,
certificate_number: sig.certificate_number, statement: sig.statement, signed_at: sig.signed_at.utc.iso8601(6),
content_digest: sig.content_digest, content_snapshot: sig.content_snapshot, auth_method: sig.auth_method,
origin: sig.origin.presence || @source }
end
def component_hash(c)
{ id: id(c), aircraft_id: id(c.aircraft_id), parent_component_id: id(c.parent_component_id), component_type_id: id(c.component_type_id),
manufacturer: c.manufacturer, model: c.model, serial_number: c.serial_number, install_location: c.install_location,
@@ -153,7 +162,8 @@ module AircraftArchive
.reject { |k, v| k.nil? || v.nil? },
component_since_overhaul: { id(e.component_id) => dec(e.component_since_overhaul_at_entry) }
.merge(e.parts.to_h { [ id(_1.component_id), dec(_1.since_overhaul_at_entry) ] }).reject { |k, v| k.nil? || v.nil? },
related_documents: [] }
related_documents: [], supersedes_id: id(e.supersedes_id), superseded_at: e.superseded_at&.iso8601,
signature: e.signature && signature_hash(e.signature) }
end
def squawk_hash(s)
+19
View File
@@ -247,8 +247,11 @@ module AircraftArchive
e.parts.build(component_id: @map[:component][r.to_s], hours_at_entry: num(hash_value(data["component_hours"], r)),
since_overhaul_at_entry: num(hash_value(data["component_since_overhaul"], r)))
end
e.superseded_at = time(data["superseded_at"])
e.save!(validate: false)
@map[:logbook][data["id"].to_s] = e.id
(@supersedes ||= []) << [ e.id, data["supersedes_id"].to_s ] if data["supersedes_id"].present?
import_signature(e, data["signature"]) if data["signature"].is_a?(Hash)
tick("logbook_entries")
end
@@ -383,6 +386,22 @@ module AircraftArchive
tick("major_records")
end
import_weight_balance
Array(@supersedes).each do |entry_id, ref|
target = @map[:logbook][ref]
LogbookEntry.where(id: entry_id).update_all(supersedes_id: target) if target
end
end
def import_signature(entry, sig)
kind = LogbookEntry::CERTIFICATE_TYPES.key?(sig["certificate_kind"]) ? sig["certificate_kind"] : "OTHER"
EntrySignature.new(
logbook_entry: entry, signer_name: sig["signer_name"].to_s.presence || "Unknown", signer_email: sig["signer_email"],
certificate_kind: kind, certificate_number: sig["certificate_number"].to_s.presence || "unknown",
statement: sig["statement"].to_s.presence || "—", signed_at: time(sig["signed_at"]) || Time.current,
content_digest: sig["content_digest"].to_s.presence || "unknown", content_snapshot: sig["content_snapshot"].to_s.presence || "{}",
auth_method: EntrySignature::AUTH_METHODS.key?(sig["auth_method"]) ? sig["auth_method"] : "imported",
origin: sig["origin"].to_s.presence || "another system"
).save!(validate: false)
end
def import_weight_balance
+41
View File
@@ -0,0 +1,41 @@
# Signs a logbook entry for a user with one of their certificates
# (AC 120-78B 2.1.2 / 2.2): the entry's signer fields are set from the
# certificate, then the signature records exactly what was signed. Signing a
# correction marks the entry it corrects as superseded (2.2.8).
class EntrySigner
REAUTH_WINDOW = 5.minutes
class Error < StandardError; end
def initialize(entry, user:, certificate:, auth_method:, request: nil)
@entry = entry
@user = user
@certificate = certificate
@auth_method = auth_method
@request = request
end
def sign!
raise Error, "Your account is disabled" if @user.disabled?
raise Error, "That certificate isn't yours" unless @certificate && @certificate.user_id == @user.id
problems = @entry.signing_problems(@certificate)
raise Error, "This entry can't be signed: #{problems.to_sentence}" if problems.any?
LogbookEntry.transaction do
@entry.update!(signoff_person: @user.display_name, signoff_certificate_type: @certificate.kind,
signoff_certificate_number: @certificate.number)
@entry.reload
signature = @entry.create_signature!(
user: @user, signer_name: @user.display_name, signer_email: @user.email_address,
certificate_kind: @certificate.kind, certificate_number: @certificate.number,
statement: @entry.certification_statement(@certificate.kind), signed_at: Time.current,
content_digest: @entry.content_digest, content_snapshot: @entry.content_snapshot.to_json,
auth_method: @auth_method, ip_address: @request&.remote_ip, user_agent: @request&.user_agent.to_s.first(255)
)
@entry.supersedes&.update_column(:superseded_at, signature.signed_at)
@entry.aircraft.log_event!("logbook", "Logbook entry signed electronically (#{@entry.date})",
notes: "#{signature.signer_name}, #{signature.certificate_label} #{signature.certificate_number}", user: @user)
signature
end
end
end
+20
View File
@@ -195,6 +195,7 @@ class LogbookEntryPdf
def signature_block_height(small) = (small + 3) * 3 + 6
def signature_block(entry, w, height, small, more:)
return electronic_signature_block(entry, w, height, small, more: more) if entry.signature
@pdf.bounding_box([ 0, height ], width: w, height: height) do
if more
@pdf.text_box "Continued on the next #{more}.", at: [ 0, height ], width: w, height: small + 2, size: small,
@@ -212,6 +213,24 @@ class LogbookEntryPdf
end
end
# Signed entries: who certified it, when, and the fingerprint to check it by.
def electronic_signature_block(entry, w, height, small, more:)
sig = entry.signature
@pdf.bounding_box([ 0, height ], width: w, height: height) do
top = height
if more
@pdf.text_box "Continued on the next #{more}.", at: [ 0, top ], width: w, height: small + 2, size: small, style: :italic, overflow: :truncate
end
top -= small + 3
@pdf.text_box clean("#{EntrySignature::LABEL} #{sig.signer_name}, #{sig.certificate_label} #{sig.certificate_number}" \
"#{' (SUPERSEDED BY A CORRECTION)' if entry.superseded?}"),
at: [ 0, top ], width: w, height: small + 2, size: small, style: :bold, overflow: :shrink_to_fit, min_font_size: 5
top -= small + 3
@pdf.text_box clean("Signed electronically #{sig.signed_at.utc.strftime('%Y-%m-%d %H:%M UTC')} · fingerprint #{sig.content_digest.first(16)}"),
at: [ 0, top ], width: w, height: small + 2, size: small - 1, overflow: :shrink_to_fit, min_font_size: 5
end
end
def certificate(entry)
kind = { "AP" => "A&P", "IA" => "A&P/IA", "A" => "A", "P" => "P", "REPAIR_STATION" => "Repair station", "REPAIRMAN" => "Repairman",
"PILOT" => "Pilot", "OTHER" => "" }[entry.signoff_certificate_type].to_s
@@ -223,6 +242,7 @@ class LogbookEntryPdf
# result is recorded but whose text doesn't already certify it.
def body_text(entry)
text = entry.text.to_s.strip
return "#{text}\n\n#{entry.signature.statement}" if entry.signature
return text unless entry.entry_type == "INSPECTION" && entry.inspection_result.present? && !text.match?(/I certify/i)
type = inspection_kind(entry, text)
statement =