Exports and receipts with encryption
For an instance with encryption, the server cannot write names into files and emails. An unlocked browser fills them in when you download a file or trigger an email. Otherwise pseudonyms stand there, that is, codes of 4 characters such as “K7Q2”.
Which information is encrypted is described in Encrypted data, how to unlock in Unlocking and connected devices.
Exports
This applies to the participant list and the attendance list as PDF, XLSX and DOCX, and to export templates with One row per Child.
- Beside the file of the job, fepli keeps the encrypted names, dates of birth, Important information and answers. Only the person who started the export can fetch them.
- The browser fills in a DOCX file itself. The server builds a PDF or XLSX file again with the decrypted values, sorts it by the names and hands it out for download without storing it.
- A record your browser may not open keeps its pseudonym. A record that is masked for you stays masked.
- If the date of birth is encrypted, the PDF gives the age stored with the registration.
In the same way, the unlocked browser fills the values into further exports: the Excel files of the lists Participants, Accounts and Receipts, the List of payments, the consents overview, the access report, the data export, Erasure list as CSV and Proof as CSV. Without unlocking, these columns stay empty or show pseudonyms.
If you searched a list by name beforehand, the export of the lists Participants, Accounts and Receipts contains whom the browser found. The cash report gives “{count} people by name” under Search.
Emails
- An email names people only if a person triggers it in an unlocked browser, e.g. a newsletter, the admission notices or a comment. Their browser then sends the first names along with Send.
- A comment names only the first name of the participant the conversation is about.
- If no name came along, the email to a family says “your child”, with the avatar if the app Avatars is on. A comment email to the team or to organizers then gives the pseudonym.
- The outbox and an account's messages show the names only after unlocking. Emails already sent keep their pseudonym.
- The email Copy of your consent gives under Concerns the first name the family's browser sent along with the consent, otherwise “your child”.
- The email Receipt created attaches no PDF. Open receipt leads to the receipt in the family's account. Without a paying account the button is missing, and the family gets the PDF from the team.
Receipts and billing address
The server encrypts the billing address of a receipt before it stores it. It is readable only at the moment it is saved: for the payment with pmPayment and for a receipt that arises with it. This applies to the family's payment, booking in the admin panel, Adjust afterwards, Reverse and the API.
| Place | What happens |
|---|---|
| Payment link | The page asks for the billing address again on every visit, filled in with the account's name and postal address as far as the server can read them. |
| Receipt page in the admin panel | The unlocked browser shows name and address under Pays and Billing address. |
| List Receipts | Unlocked, the column Pays shows the first line of the address, otherwise the receipt's email address. |
| Adjust afterwards, Reverse | Only with an unlocked browser. The browser decrypts the address of the original, and the new receipt takes it over. |
| Receipt as PDF, made later | Contains no address, except through the receipt in the family's account. |
| Search | Does not find a receipt by its address, not through the API either. The preview shows the first line, decrypted in the browser. |
| Data access report | The unlocked browser fills in the billing address. Otherwise it is missing. |
| End of the retention period | fepli deletes the encrypted address with its keys. |
| API | billingAddress is null. A reversal or correction through the API has an empty address if the client sends none (Receipts). |
Receipt in the family's account
- The receipt is a page under Payments. If the family's browser is connected, it shows the address. Otherwise “On file” stands there with a lock.
- Download as PDF opens the key first if needed, as the lock does, and saves the receipt.
- Team members who view the website as the family do not get the PDF.
Receipts and proofs in the archive
A receipt or proof of consent gives names in plain text. The server therefore files it only once an unlocked browser of the team has sent the names decrypted. It uses them only for this file and does not store them.
- Every page of the admin panel does this in the background once a team member has unlocked. If the team opens a document that is not filed yet, its browser files it first.
- A family's browser, the background worker and the nightly run file no documents with encrypted names.
- The server refuses a date of birth that does not match the known year of birth.
- If the person is erased before their proof of consent is filed, the consent's record itself stays the proof.
- In the admin panel, a link to an encrypted document, e.g. PDF of a receipt or Document of a consent, shows Unlock first until the browser is unlocked.
Messages
| Message | Meaning |
|---|---|
| “{file} is being downloaded.” | The unlocked browser has filled in the names. The file is listed under Notifications for 24 hours. |
| “{file} with pseudonyms instead of names.” | The browser is not unlocked. Unlock and download the file again. |
| “{file} with pseudonyms: the names could not be decrypted.” | The browser could not open the names. The file contains pseudonyms. |
| “Stored encrypted. Decrypt it first to download.” | The address of an encrypted file was opened directly. Download it in the admin panel with an unlocked browser. |
| “The address of the receipt is encrypted. Decrypt it first to reverse it.” | Reverse needs an unlocked browser. With Adjust afterwards, the message ends “… Decrypt it first to adjust it.” |
| “Please complete your billing address” | On the payment link: the encrypted address counts as missing. The family enters it again. |
| “This receipt cannot be opened here. You can get it from the team.” | In the family's account: the browser is not connected, or its key does not open the receipt. |