Try it out now

You can test your SAML service component or OIDC relying party via the appropriate RealMe® Messaging Test Site (MTS). The primary aim of MTS is to provide developers and integrators with the ability to:

·       test sending a SAML v2.0 AuthnRequest to the RealMe service and receiving a SAML v2.0 response from the RealMe service,

OR

·       test sending an OIDC Authentication Request to the RealMe Service, invoking the RealMe Token endpoint and receiving an OIDC Token response from the RealMe service.

MTS is also required to test SAML exception handling and OIDC exception handling

As well as providing the functionality to try out SAML or OIDC requests and responses from your system test environment, the Messaging Test Site website provides information and instructions for its use.

For SAML testing, there are separate versions of MTS for the login service and assertion service:

• RealMe login service MTS - https://mtscloud.realme.govt.nz/Login(external link)(external link)
• RealMe assertion service MTS - https://mtscloud.realme.govt.nz/Assertion(external link)(external link)

Download the Messaging Test Site bundle [ZIP, 33 KB](external link) - it contains everything you need for a POST binding Messaging Test Site integration 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.

For OIDC testing, before attempting an MTS integration make sure you are familiar with the OIDC requirements which, in some cases, are specific to RealMe.

• RealMe OIDC MTS - RealMe - About MTS for RealMe OIDC(external link)

After successfully connecting to the Messaging Test Site, the core steps for technical integration (SAML or OIDC) 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: integrations@realme.govt.nz.