Webservice Authentication

Follow these steps to enable the webservice for todo4teams:

  1. Select "Systems" in the main menu and add a new entry there:
    Set the clients' IP address or a wildcard pattern (as a regular expression) to filter the system that might access the services:
    image-20250128161148-2.png
    Take the following patterns as examples:
    1. IPs:    .*       (all IPs)
    2. IPs:    192\.168\.5\.221     (the exact IP 192.168.5.221)
    3. IPs:    192\.168\.5\.\d+     (the subnet 192.168.5.*)
  2. Add more system entries if needed.
  3. Optional: Enable authentication for the webservices:
    1. Select "System Properties" and add an entry "RESTUSERAUTHENTICATION" with value "required", lke this:
      image-20250128161046-1.png
    2. Select "Users" in the main menu and add a new user to be used for these services exclusively and select roles "Admin" and category "Systems".
      Set a valid password to be used in the API calls.
      image-20250128162312-3.png
  4. Use the 'curl'  command to check if the settings are correct. E.g. fetch the list of users:
    curl -u yourapiuser:yourapipassword -H "Accept: application/json" -H "Content-Type: application/json" -X GET   "https://yourtodoserver/todo4teams/rest/users"

  5. Set the credentials like set above.