Using Schoolyear secure exam browser

Schoolyear lets schools run online tests in a secure browser. When Schoolyear is connected to Examplary, teachers can require students to open a test through the Schoolyear Browser before they can start.

This guide explains how organization admins set up the integration, how teachers enable it for a test, and what students see when they take the test.

Set up Schoolyear for your organization

An organization admin or owner only needs to connect Schoolyear once.

Start by getting API credentials from Schoolyear:

1. Log in to the Schoolyear dashboard
2. Click on your name in the top right corner and select Admin Console
3. In the Add-ons section, click Add and select Examplary
4. Copy the Secret shown on the screen and save the integration

Then go to Examplary to connect Schoolyear:

1. Go to Account → Integrations
2. Select Schoolyear
3. Enter the API secret from Schoolyear
4. Click Connect

Examplary checks the credentials with Schoolyear before saving the connection. When the setup succeeds, the Schoolyear card shows Connected.

Enable Schoolyear for a test

After Schoolyear is connected, teachers can enable it per test.

1. Open the test in Examplary
2. Open Settings
3. Set a start date and an end date for the test
4. In the security section, enable Require the use of Schoolyear
5. Save the test settings

Examplary creates the matching test in Schoolyear when the settings are saved. If you later change the test name, start date, end date, or browser spell-check setting, Examplary updates the Schoolyear test as well.

Configure the test in Schoolyear

When Schoolyear is enabled for a test, Examplary shows two buttons in the test settings:

• Configuration opens Schoolyear's configuration screen for that test
• Exam dashboard opens Schoolyear's live dashboard for monitoring sessions

Use Configuration for Schoolyear-specific browser settings. Use Exam dashboard during the test to follow student sessions in Schoolyear.

These links are generated fresh every time you click them, so reopen the button from Examplary whenever you need to access Schoolyear.

Share the test with students

Schoolyear tests must be taken by signed-in Examplary students. Before the test starts:

1. Make sure the students have Examplary student accounts
2. Invite the students or groups who should take the test
3. Share the test link with those students
4. Ask students follow the instructions to install the Schoolyear Browser on their devices

What students see

When a student opens a Schoolyear-protected test, Examplary checks whether they are signed in and whether the test is already running in the Schoolyear Browser.

The normal flow is:

1. The student opens the Examplary test link
2. If needed, the student signs in to their Examplary account
3. The student clicks the Open Schoolyear button
4. Schoolyear opens the secure browser and launches the test
5. The student starts the test in Examplary from inside the Schoolyear Browser

If a student tries to start the test outside Schoolyear, Examplary blocks the attempt and asks them to open the test in Schoolyear. If a teacher or admin opens the student test flow, Examplary explains that only students can take the test.

Turn off Schoolyear for a test

To stop requiring Schoolyear for a test, return to the test settings and disable Require the use of Schoolyear.

Examplary archives the matching Schoolyear test. This removes it from Schoolyear's planning, but it does not forcibly close students who are already in an active secure-browser session.

You can enable Schoolyear again later. Examplary will reuse the existing Schoolyear test and sync the latest settings.

Troubleshooting

I cannot find Integrations

Only organization admins and owners can configure integrations. If you are an admin or owner and still do not see Integrations, contact Examplary support.

Schoolyear will not connect

Check that the API endpoint starts with https:// and that the API secret is copied from Schoolyear without extra spaces. If the credentials still fail, ask Schoolyear to confirm the secret and endpoint for your organization.

I cannot enable Schoolyear for a test

Set both the start date and end date in the test settings, then save again.

A student is asked to sign in

This is expected for Schoolyear tests. The student must use an Examplary student account so Examplary can create a secure Schoolyear session for them.

A student sees "Only students can take this test"

They are signed in with a teacher or admin account. Ask them to sign out and sign back in with their student account.

A student cannot start the test

Ask them to open the test through the Open Schoolyear button in Examplary. Starting the test directly in a normal browser is blocked for Schoolyear-protected tests.