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