GetToken vs. GetToken2

GetToken

This call asks the user directly for it's username and password to be used on the SSO. 

    <GetToken xmlns="https://api.nmbrs.nl/soap/v3/SingleSignOn">
      <Username>string</Username>
      <Password>string</Password>
    </GetToken>

We only recommend to use it for Employee login (assuming that he only has one email registered in Nmbrs).

Limitations:

In the case of an username is used in multiple Nmbrs environments, the call will not work.

For example, if I am an accountant that has accounts in multiple environments in Nmbrs, then, the call will not be able to identify on which environment the user wants to SSO, therefore, it will return 9999: Unknown. The username and password are not unique identifiers.

GetToken2

As an alternative, the call GetToken2 can be used. 

    <GetToken2 xmlns="https://api.nmbrs.nl/soap/v3/SingleSignOn">
      <Username>string</Username>
      <Token>string</Token>
    </GetToken2>

With it, you pass in the username and token. The token is unique and retrieved within a specific environment.  Therefore, the system can identify in which environment the user wants to SSO. 

 

Comments

Knowledge base