Troubleshooting web services authentication and access issues

If an authentication error is returned when you attempt to make a web service request, see the list below for some common causes of related issues.

If none of the scenarios listed below applies to you and you’re still facing an authentication problem, please contact Replicon Support.

  • Authentication format is incorrect

Correct format: Companyname\Username e.g. ACMEInc\Tester.Joe

Incorrect format: Companyname\\Username e.g. ACMEInc\\Tester.Joe

  • Endpoint in URL is incorrect

The services can only be accessed from your instance’s end point (https://X.replicon.com/services/, where the X could be NA2, NA3, NA4, etc). This end point may change from time to time.

So, if you’re having authentication errors, check that you’re accessing the services from the correct end point by following these instructions. Since this end point can change, it’s a good idea to include a check in your code, and generate the web service URL dynamically each time you perform a call.

  • Authentication method for the account is set to SSO

The authentication method must be Replicon internal to access web services. To check and change the authentication method:

  1. Log in to Replicon as an administrator.
  2. Go to Administration > Employees and Organization > Users.
  3. Select the user you want to use to access web services.
  4. If the Authentication Type field is set to SSO, change it to Replicon internal authentication.
  5. Click Save.
  • The password reset frequency has been updated in your system

Due to a known issue in Replicon, in some cases when you update the password expiry frequency for the system (set at Administration > System and Security > Security Settings), users will be unable to access web services with their existing credentials.

If this happens, you will still be able to log in to the Replicon web app, but will need to reset your password before you can use services.

  • Required products or permissions are missing

If you see an error like this: All access checks failed to authorize operation '<name of operation>' : At least one of the following permissions are required: ‘<name of permission>’, you’re missing permissions required to perform the operation in question.

For any operation carried out using services, you’ll need the same permissions and products you’d need to carry out that operation manually within the app. For information on assigning products and permissions, select the links.