Open ICAP.
CLOUDFLARE WORKERS + D1
Deploy under your school's control.
Self-hosted software is FREE: $0 software fee. Your school
pays its own infrastructure costs. Open ICAP is being prepared for an
source-available release under its District Use License. Register your public school district and import its signed receipt before production use.
The repository contains a dependency-free Worker build, a D1 migration,
security tests and local SQLite development. Cloudflare and the school identity provider are configured by the district operator. No production secrets are
included in source.
Local development
npm test
npm run dev
The local server listens on loopback at port 8787. Read the generated
.dev-access-key file and use Operator access key on the login
page. Local records persist in .local-dev.sqlite. Both files
are ignored by Git. The fictional-data demo is available at
/demo.
Production database and identity
Create a D1 database with the intended jurisdiction, set its ID in
wrangler.jsonc and apply all migrations in drizzle/ through Wrangler migrations.
Provision the district, school and administrator membership with the
documented SQL in the repository. The app denies access until identity,
membership and database are configured.
For school sign-in, put the app behind Cloudflare Access, connect the
district IdP, require MFA and configure
ACCESS_TEAM_DOMAIN and ACCESS_AUD. Membership
subjects use the verified issuer and subject. Microsoft can be connected
through this identity boundary later.
Temporary operator access
Set a randomly generated token of at least 48 characters as the
BOOTSTRAP_TOKEN secret, configure
BOOTSTRAP_MEMBERSHIP_ID and explicitly set
ENABLE_BOOTSTRAP=true. Sessions last 30 minutes and require
active membership. Rotating the token invalidates existing operator
sessions. Disable this mode after school identity is available. Never put
the token in source, a URL or browser JavaScript.
Register the district license
Read the District Use License. Obtain a signed district receipt from Advocate and import it at District license setup after provisioning named administrator access. Apply every migration through 0006_district_license.sql. Production requires DISTRICT_LICENSE_MODE=required, the receipt’s DISTRICT_LICENSE_REGISTRATION_ID, and DISTRICT_LICENSE_JURISDICTION. Your own cloud account is permitted; a hosted subscription and Stripe configuration are not required.
Verification happens locally. Retain the receipt and accepted license with your deployment records. There are no routine licensing network calls. Account setup and scoped record retrieval remain available while a receipt is missing.
Before using real education records
Complete district/vendor agreements and a deployment-specific notice. Set
school access, service purpose, retention/holds, secure export delivery,
backups and tested restore/deletion procedures. Disable public Worker
preview origins, protect the custom domain, limit Cloudflare account
access and establish incident response. Perform an independent
access-control and operational review. Code checks are not a legal
compliance certification.
Research and source crosswalk ·
Explore the fictional-data workspace