Charter Lottery
Language / Idioma

IT staff and managed service providers

IT and MSP guide

Last updated November 10, 2026

For IT staff and managed service providers who support schools using Charter Lottery: what to set up, what to allowlist, how staff accounts work, and how data is handled.

Charter Lottery is a hosted web application at https://charterlottery.com. There is nothing to install on school computers or servers. Families and staff use an ordinary web browser.

Every statement here was checked against the application in October and November 2026.

For the first-run steps with full-window screenshots, see the MSP onboarding walkthrough.

In this guide


Roles

Each account belongs to one organization (the school or charter network) and has one role. Permissions come from Charter Lottery's database, not from the identity provider, and are rechecked on every request.

RoleScopeTypical user
Organization admin (ORG_ADMIN)Every school in the organization, users, settings, billingHead of school, operations lead
School admin (SCHOOL_ADMIN)Only the schools assigned to themEnrollment coordinator, front office
Parent (PARENT)Their own children and applicationsFamilies

A separate platform role (site owner) is held by the Charter Lottery operator only. The admin guide lists exactly what organization and school admins can each do.

Create and invite staff accounts

Only an organization admin can invite staff.

  1. Choose Manage Users. The page lists organization admins, school admins (with their schools) and parents.

    The Users page
  2. Select Invite User.

  3. Choose the role. For a School Admin, tick at least one school.

  4. Enter the person's full name and email address.

  5. Select Send Invitation.

Inviting a school admin

What happens next:

  • Charter Lottery creates the account in its identity provider (Amazon Cognito, AWS us-east-2) and emails the invitee from noreply@charterlottery.com. The email, titled "You're invited to organization on Charter Lottery", contains a temporary password and a link to the sign-in page.
  • At first sign-in the user must choose a new password, then (staff only) set up two-step sign-in.
  • If the email cannot be sent, the account is still created and the admin is told so.
  • Invitations are in English only.

Resend an invitation. Open the user (Edit). For someone who has never signed in, a resend option issues a new temporary password. Limits: 10 resends per hour per admin; per invitee, 1 every 5 minutes and 3 per hour. For anyone who has already signed in, use password reset instead.

Change a role or school assignments. Open the user, change Role and tick the schools, then Update User. Saving replaces the user's school list. Changing a school admin to another role removes all their school assignments. The email address cannot be changed.

Editing a user's role and schools

The emailed temporary password stays valid for 7 days. After that, an admin resends the invitation.

Sign-in methods

The sign-in page
MethodWhoNotes
Email and passwordEveryonePassword: at least 12 characters with uppercase, lowercase, a number and a symbol
Continue with GoogleShown on the main sign-in pageGoes through the Cognito hosted sign-in page and Google
School portal sign-inParents, on /portal/<school>/sign-inEmail and password only

Invited staff can use Google. An invited organization or school admin who has not signed in yet can choose Continue with Google instead of the temporary password, as long as the Google account uses the same email address as the invitation and Google has verified it. The first Google sign-in connects Google to the invited account. It does not work (the person is taken to "complete sign-up" instead) if the invitation has already been used, if two invitations share that email, or if the Google account's email differs or is unverified. In those cases, use the emailed temporary password.

Connect Google later. Staff who already use email and password can open Account security (their name at the bottom of the menu), choose Connect Google and sign in with a Google account that has the same email address. Disconnect Google removes it again, provided the account has a password; it also signs out any session that came in through Google. Connecting and disconnecting are recorded in the organization's audit log.

Forgotten password. Forgot your password? on the sign-in page emails a verification code; the user enters it with a new password. The page never reveals whether an account exists.

Reset your password

New parent accounts confirm their email with a six-digit code before they can sign in.

Idle timeout. Signed-in users are signed out after 30 minutes without mouse or keyboard activity, with a warning 5 minutes before. Signing in again does not end sessions on other devices.

Two-step sign-in (MFA) for staff

Organization admins and school admins use an authenticator app (any app that supports time-based codes, such as Microsoft Authenticator, Google Authenticator, 1Password or Authy). Parents do not use two-step sign-in.

It applies to email-and-password sign-ins and personal Google accounts (such as @gmail.com), and to the Charter Lottery operator's own accounts. Once a staff member has set it up, they must use it at every new sign-in.

Google Workspace accounts are not asked. When staff sign in with a school Google Workspace account (a Google account managed by the school's domain), Charter Lottery does not ask for its authenticator code, offer the one-time skip, or ask again before sensitive actions. The school's own Google 2-Step Verification is the control, so IT should enforce 2-Step Verification for staff in the Google Admin console. This applies to that Google sign-in only: the same person signing in with email and password still gets two-step. Each staff sign-in is recorded in the audit log with its method and whether it was a Workspace sign-in.

Sign-inCharter Lottery two-step
Email and passwordYes
Google, personal accountYes
Google, school Workspace accountNo (Google's 2-Step Verification applies)

When Charter Lottery requires two-step sign-in for staff, a staff member who has not set it up yet:

Sign-inWhat happens
First sign-in without two-stepTaken to Account security. They can set it up now or choose Skip for now once and carry on working for the rest of that sign-in.
Any later sign-inSetup is required. No staff page, report or action works until it is set up. Skip for now is not offered again.

The one skip is per person, not per browser or device, and is recorded in the organization's audit log. Reloading pages or opening new tabs in the same sign-in does not use it up again; signing out and back in, or signing in on another device, counts as a new sign-in. If the setting is off, staff are not prompted at all, but anyone who has set up an authenticator still has to use it.

Set it up

  1. Sign in. You are taken to Account security (or open your name at the bottom of the menu and choose Account security).

    Account security: start
  2. Select Set up an authenticator.

  3. Scan the QR code with the authenticator app. If you cannot scan it, enter the setup key shown below it, or use Open in an authenticator app on a phone. The setup expires after 10 minutes. The QR code is drawn in the browser, so the key is not sent to any outside service.

  4. Enter the six-digit code from the app and select Verify code.

    Adding an authenticator with the QR code or setup key (both masked)
  5. Save the 10 recovery codes. They are shown once. Each can be used once instead of an authenticator code. Download them or copy them into a password manager, separate from the phone.

    Recovery codes (values masked)
  6. Tick the confirmation. Continue to your dashboard stays unavailable until you do.

A verification lasts 12 hours on that browser. After 5 wrong codes in 10 minutes, verification is blocked for 15 minutes.

Lost phone

  • Sign in and choose Use a recovery code. The page shows how many codes remain. Then set up the new phone.
  • To get a fresh set of codes, verify first (within the last 5 minutes), then regenerate them on Account security.
  • Lost both the phone and every recovery code: there is no self-service or school-admin reset. Contact Charter Lottery support; recovery requires an identity check and is recorded. Password reset and personal Google sign-in do not bypass two-step sign-in.

Offboarding: suspend or remove staff

Organization admins can suspend school admins themselves. Deleting a staff account, or suspending another organization admin, still goes through Charter Lottery support.

To offboard a school admin:

  1. Open Manage Users, select Edit on the person, and under Suspend account select Suspend account, then Yes, suspend. Suspension takes effect on the person's next request: they are signed out and cannot sign in again. Reinstate account undoes it. Both are recorded in the audit log.
  2. To delete the account, or to offboard an organization admin, email support@charterlottery.com.

Notes:

  • Suspension blocks the account in Charter Lottery; it does not disable the login in the identity provider. Deleting a staff account removes it from Charter Lottery's database but not from the identity provider.
  • The Users list marks suspended accounts Suspended next to the role.
  • You cannot suspend yourself, another organization admin, or a parent account.
  • Audit history keeps the person's actions after they leave.

Email and SMS: what to allowlist

Ask your mail administrator to make sure these reach staff and families.

ItemValueStatus
Sender addressnoreply@charterlottery.comConfirmed (production configuration)
Reply-tosupport@charterlottery.comConfirmed (production configuration)
Sending serviceAmazon SES, us-east-2, domain charterlottery.com (DKIM verified)Confirmed
SPF and DMARCMail is DKIM-signed by Amazon SES; bounces use mail.charterlottery.com; charterlottery.com publishes a DMARC policyConfirmed
Password-reset and sign-up code emailssupport@charterlottery.com ("Charter Lottery"), sent by Amazon Cognito through SESConfirmed
Sign-in page for Googlecharterlottery.auth.us-east-2.amazoncognito.comConfirmed
Text messages (SMS)+1 844 586 1238 (US toll-free, registered)Confirmed

Emails sent include: staff invitations, application submitted, verified or ineligible, document approved or rejected, lottery result (accepted or waitlisted), results replaced after a redraw, late applicant added to the waitlist, waitlist promotion, seat-deadline reminders, seat confirmed, and a receipt when staff record a family's answer for them. Families receive them in English or Spanish.

Texts are only sent when the organization has SMS on and the parent has added and verified their mobile number and agreed to the SMS terms. Replies STOP, UNSUBSCRIBE, CANCEL, QUIT or END opt out; HELP returns help text. Texts follow the parent's language.

If parents report missing email, ask them to check spam, and check whether the school's filters quarantine charterlottery.com.

Browsers and devices

  • Charter Lottery is tested on current desktop Chrome and mobile Chrome on Android (automated tests). It is built for current versions of Chrome, Edge, Firefox and Safari, but Safari and Firefox are not part of the main automated tests and there is no published supported-browser list. The one exception is portal embedding, which has an automated check in Chromium, Firefox and WebKit (Safari's engine).
  • Parents can do everything on a phone. One known layout problem: on narrow phones the Confirm Seat button can sit partly off the edge of the results card (see the parent guide).
  • Accessibility target: WCAG 2.1 A/AA, checked automatically in English and Spanish.
  • JavaScript and cookies must be enabled. A cookie banner appears on public pages; Google Analytics runs only on public marketing pages after a visitor accepts, never inside the signed-in app or school portals.
The cookie banner on public pages

Each school (or the whole organization) can have an application portal: a branded page where families create an account and apply. An organization admin creates it under Application Portals in the menu and must set its status to Active.

Open the portal to find three ways to publish it:

A portal's embed code and direct link
OptionHowNotes
Direct link (recommended)Link a button such as "Apply for enrollment" to https://charterlottery.com/portal/<portal-slug>Works everywhere; best on phones
Simple iframePaste the iframe snippet into the websiteFixed height (600 px by default); families may need to scroll inside the frame
JavaScript widgetPaste the script snippetIt does not resize itself yet; treat it like the iframe

What works inside an iframe (checked 2026-10-24 in Chromium, Firefox and WebKit/Safari with an automated cross-site test):

StepInside the iframeWhat families see
Portal welcome page, open enrollment periods, how it worksWorks in all threeThe page renders in the frame
Create AccountOpens in a new tabThe sign-up form, full window
Sign InOpens in a new tabThe sign-in form, full window
Applying, results, dashboardNever in the frameContinues in the new tab after sign-in

Signing in cannot work inside a frame on another site in any current browser: the sign-in and session cookies are SameSite=Lax, which browsers do not send in a cross-site frame (Safari and Firefox would also block them as third-party cookies). The portal therefore detects when it is framed and opens account creation and sign-in in a new tab; if a sign-up or sign-in page is framed directly, it shows an Open in a new tab button instead of the form. The school's page stays open in the original tab.

Headers: portal pages (/portal/...) send Content-Security-Policy: frame-ancestors 'self' * and no X-Frame-Options, so any website may frame them. Every other page (staff sign-in, the parent and staff apps, the marketing site) sends X-Frame-Options: DENY and frame-ancestors 'none' and cannot be framed. The portal's Allowed Origins setting restricts the portal API, not which websites can frame the page.

If your site's own Content-Security-Policy has a frame-src or child-src directive, add https://charterlottery.com to it, or the embed will be blank. Because families have to move to a new tab to do anything, the direct link remains the better choice for most schools.

The public directory Find Schools (https://charterlottery.com/find-schools) lists a school only while it has an open enrollment period. It shows the school name, city and state, never the full address, phone, staff or student data.

Data handling, FERPA and retention

TopicSummary
HostingAmazon Web Services, US East (Ohio, us-east-2). Database on the application server; files in private S3 storage
EncryptionTLS in transit; AES-256 at rest
BackupsNightly encrypted, restore-tested backups, kept up to 90 days (plus up to 30 days as superseded versions)
FERPACharter Lottery acts as a "school official" with a legitimate educational interest. A FERPA data processing addendum is available as a draft template; have counsel review it before signing
Tenant separationEvery query is scoped to the organization; staff only see their organization (school admins only their schools)
LogsAudit entries record IDs, not names, birth dates or emails
Sub-processorsAWS (hosting, email, SMS, sign-in), Stripe (payments)
Breach noticeWithin 72 hours under the draft addendum

Retention policy (the automatic deletion job is not yet switched on; until it is, nothing is deleted automatically):

DataKept for
Uploaded documents3 years after the cycle ends
Applications never entered in a lottery3 years after the cycle ends
Applications entered in a lottery, draws and results7 years after the cycle ends
Audit log7 years
Admin exports (downloaded files in storage)30 days
AccountsUntil deletion is requested

Parent self-service. Parents can download their own data (ZIP with a readable page and JSON, plus copies of their uploaded documents; up to 3 times a day) and delete their account. Lottery records the school must keep are de-identified instead of deleted.

Staff accounts cannot be self-deleted. An organization admin can suspend a school admin; to delete a staff account, ask support.

Exports and audit logs

  • Exports (Applications, Lottery Results, Waitlist, Notification Log, Audit Trail) are generated as CSV or PDF per school. Download links expire after 15 minutes; every export is logged and carries who generated it, when and for which organization. Stored copies are removed after 30 days. Once downloaded, the file is the school's responsibility: store it according to your records policy.

  • Audit logs exist per school and for the whole organization. Entries cannot be edited or deleted. Filter by date, person, action and school, and export to CSV.

    The organization audit log
  • Selection Audit Packet (PDF) per lottery cycle: the evidence an authorizer or auditor needs, watermarked on every page. See the admin guide.

  • Org Settings also has an Export All Data button (not exercised for this guide).

Support

NeedContact
Product help, sign-in problems, deleting staff accounts, MFA recoverysupport@charterlottery.com
Legal, privacy, data processing addendumlegal@charterlottery.com
Security reportssecurity@charterlottery.com
Sales, adding SMSsales@charterlottery.com

Write to the address for your need, or use the form on the contact page; replies come by email. Charter Lottery does not publish support hours or a response time. Product troubleshooting and billing help are included in the subscription; optional setup, training and custom work is $175 per hour, agreed in advance. There is no written service-level agreement.