Once you've set up your SAML component, you can test it against the RealMe® Messaging Test Site (MTS) - there are separate versions for login service and assertion service. The primary aim of MTS is to provide developers and integrators with the ability to test the sending of a SAML v2.0 AuthnRequest to the RealMe service and receiving a SAML v2.0 response from the RealMe service. MTS is also required to test exception handling.
As well as providing the functionality to try out SAML requests and responses from your system test environment, the Messaging Test Site website provides information and instructions for its use.
MTS Certificate Renewal - 7 October 2021
The MTS certificates expired and were replaced on the evening of the 7 October. Services integrated into MTS will need to be updated to consume the new MTS IdP metadata appropriate to your servce:
Please note that, as part of the certificate renewal, we have also changed the MTS endpoint from mts.login.realme.govt.nz to login.mts.realme.govt.nz. This domain name change resolves an issue where users could not initiate a login to MTS if they had logged onto the Production environment in the same browser session.
Download the Messaging Test Site bundle [ZIP, 18 KB] - it contains everything you need for a POST binding Messaging Test Site for the RealMe login service or RealMe assertion service. To make this easy, the MTS bundle includes self-signed certificates that you can use. For ITE and Production integrations you will need to meet the certificate requirements.
If you're incorporating SAML products or code libraries or perhaps even considering some custom coding then you will need to be familiar with the RealMe message request requirements that differ in some way from the OASIS Standard or have additional NZ specific constraints. You should also look at the SAML metadata requirements for RealMe integration.
After successfully connecting to the Messaging Test Site, the core steps for technical integration describes what is involved in configuring and connecting your online service to the RealMe ITE and Production environments. This requires a formal project to be set up by contacting the RealMe team via email on firstname.lastname@example.org.