Schoolbox SaaS Instance Configuration

Overview - Schoolbox SaaS Instance Configuration

Are you sure you want to remove this component?

Schoolbox SaaS Hostname

Are you sure you want to remove this component?

Your Schoolbox SaaS instance can be served from either:

  1. A hostname provided by us in the form of [code].schoolbox.cloud address, eg abc.schoolbox.cloud, or
  2. your custom domain name of choice, eg schoolbox.abc.vic.edu.au
     

When on-boarded, you will automatically be provided with a [code].schoolbox.cloud address, eg abc.schoolbox.cloud. You can either serve your instance from this domain name, or from your own custom domain name, eg schoolbox.abc.vic.edu.au.

If you elect to use your own custom domain name, you need to configure a DNS CNAME record to point to the [code].schoolbox.cloud address. This enables Schoolbox to manage the routing of web requests.

 

image.php?hash=74c731791a1b04f7956cc571f2bc5d4979d8c366

CDN Domains

Are you sure you want to remove this component?

The Schoolbox SaaS service serves static content from a CDN with domain schoolbox-static.cloud.

Storage files and images are served directly from AWS S3 to the browser. The domain will align to the region which hosts your service, eg clients in Sydney, Australia will likely have content served from s3.ap-southeast-2.amazonaws.com.

Please ensure on-site users are able to access these domains.

Email Relay

Are you sure you want to remove this component?

Schoolbox SaaS may be configured to route mail:

  1. via a local relay and then to recipients (recommended) or
  2. via your relay and then to recipients (deprecated, not supported for new installs)

In both cases, if email is sent from domains whose DNS you control, you should also configure DKIM

image.php?hash=6693b48ac179743b0035f5dae82881b980716f9b

 

1. Sending mail directly to recipients

For Schoolbox to send mail on behalf of users, the Schoolbox mail servers must be authorised to send from your users' mail domain. For example, to send mail for john@myschool.edu.au requires Schoolbox to be authorised to send mail for myschool.edu.au.

Schoolbox relies on DNS SPF records to authorise mail servers. Schoolbox publishes their mail server IPs via an SPF TXT record at spf.schoolbox.cloud.

You must include this record in your domain's SPF record,eg myschoolbox.edu.au.    300    IN    TXT    "v=spf1 +include:spf.schoolbox.cloud ~all"

 

2. Sending mail via your relay and then to recipients

This configuration is deprecated and not supported for new customers. Drawbacks include:

  • no logging takes place. Unable to later determine if message was sent.
  • causes the web request to hang, degrading user experience
  • no retries, transient network issues will result in message loss
  • the application server pool scales, with dynamic IPs, thus the relay cannot be configured to accept mail from a whitelist.
  • poor security, no TLS support