Decription: Dreamcatchr is a personalised cloud based Careers option.

There are two options (make sure Crystal knows which option you are using) ...

  • Manual option: Historically Dream catcher is provisioned from a kamar export. This document labels this as the "manual" provisioning option.
    The problem here is that the Kamar export username occassionaly varies from the LDAP username (5-10%).
    Schools can choose to use the manual option but any username troubleshooting will attract a cost.
    See appendix below on how to manually provision.

  • Crystal option: Crystal has developed a provisioning system that does always match users with the LDAP..
    This service is free.
    If Crystal is to provision please make sure there is a good lead time as a SQL export table environment need to organsied with Dreamweaver.

SSO logon: https://idp.theloop.school.nz/simplesaml/saml2/idp/SSOService.php?spentityid=DreamCatcher

Dreamcatcher SSO config fee
There iso an arrangement with Dreamweaver for Loop schools to not have to pay a $500 SSO fee.

The Loop paid for the SSO fee for all Loop schools when MGC first started using Dreamcatcher.


Crystal Provisioning: << not yet tested- please contact Geoff first>>
The school uses Crystal to generate the user list (a CSV file) and the school sends this to Dreamcatcher.
To get the CSV file...

  1. Log onto Crystal as a status level 3 (not a teacher).
  2. Go to NetAdmin/select your school and go to "Provisioning Group Definition"
  3. Complete the course definition page (aka select the class/group/timetable class) you wish to use Dreamcatcher then select the service (Dreamcatcher - drop down box below). Save.
  4. Fine tune your group membership using the "Provisioning Group Membership" and select 'export (top right hand corner).
  5. Now you have a list of the users that you are going to send to Dreamcatcher but there is still one piece of data that may be not correct - "Gender".
    Gender is NOT exported by the official MoE export and the Crystal's attempt at guessing the gender may be wrong ... so you will have to check your list and edit as necessary.
    You can edit the gender back in NetAdmin/School details tab.
  6. Once checked return to the "Group Membership" tab using the "Provisioning Group Membership" and select 'export (top right hand corner).
  7. Email that exported file to Dreamcatcher.

Manual provisioning
The school has to organise the provisioning themselves.
Crystal can only does the SSO side when Dreamcatcher is manually provisioned.... the SSO relies on the school getting the provisioning correct.
Dreamcatcher have a PDF that explains how to do this
Usernames need to match, and Dreamcatcher (see Sheldon contact below) does the rest.

Dreamcatcher technical contact.


p: +64 9 972 0269 (Auckland)
p: +64 7 929 4912 (Hamilton)
p: +64 7 928 8867 (Tauranga)
m: +64 274940600

Crystal side config
Only for Crystal engineers)

Dreamcatcher meta data is:
<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" entityID="DreamCatcher">
  <md:SPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:1.1:protocol urn:oasis:names:tc:SAML:2.0:protocol">
    <md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://area51.dreamcatcher.school.nz/single-sign-on/logout"/>
    <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://area51.dreamcatcher.school.nz/single-sign-on/authenticate" index="0"/>
    <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:1.0:profiles:browser-post" Location="https://area51.dreamcatcher.school.nz/single-sign-on/invalid" index="1"/>
    <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Artifact" Location="https://area51.dreamcatcher.school.nz/single-sign-on/authenticate" index="2"/>
    <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:1.0:profiles:artifact-01" Location="https://area51.dreamcatcher.school.nz/single-sign-on/invalid" index="3"/>
  <md:ContactPerson contactType="technical">

Dreamcatcher CSV export file format

The bold * fields must be populated.
The italics field will be populated by Crystal

Surname (Preferred) *
First Name (Preferred) *

Student e-mail - (Crystal: email address)
Date of Birth
Year Level * (Crystal: Group starting with Y#)
* (Crystal: Teacher name from Provisioning Group Definition)
Address – Home (Line) – Residence A
Phone – Home – Residence A
Ethnicity – 1st Number
Ethnicity – 2nd Number
Ethnicity – 3rd Number
Iwi 1st
Iwi 2nd
Iwi 3rd
Internet – Unique Logon * (Crystal Username)
Internet – Password – Student (No longer used- redundant)
National Student Number (NSN)* Type [e.g. AE for adult education - MoE codes]
PCG One Name (eg Mother)*
PCG One Relationship (eg Mother)
PCG One Occupation (eg: Mother)
PCG One email (eg: Mother) * (SMS email address)
PCG One Phone Cell (eg: Mother)
PCG One Phone Home (eg: Mother)
PCG One Phone Work (eg: Mother)
PCG One Work Address (eg: Mother)
PCG Two Name (eg Father)
PCG Two Address (eg. Father)
PCG Two eMail (eg. Father)
PCG Two Name (eg. Father)
PCG Two Occupation (eg. Father)
PCG Two Phone Cell (eg. Father)
PCG Two Phone Home (eg. Father)
PCG Two Phone Work (eg. Father)
PCG Two Relationship (eg. Father)
PCG Two Work Address (eg. Father)