Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

When 2FA is enabled, every login / sign-in requires users to input their password, OTP, and user ID.

...

Table of Contents
stylenone

Introduction

Starting v8.1, a new type of user - API user is implemented.

API users are a special type of users that user who do not require OTP for sign-in. However, they have one important security restriction - : API calls can be restricted from to a certain IP address (or range).

Steps:

  1. Navigate to Home → Users → Create

  2. Select Yes as the answer for API User?

  3. Specify the host IP address or range of allowed IP addresses in the text box appearing below the API User? as illustrated in the image below -

...

  1. Host IP address as in 142.250.67.196. This means the API user account can be used to invoke APIs from this IP address alone.

  2. IP address range using Network address / mask notation (aka CIDR notation). For example: 142.250.0.0/16. This allows to invoke API from any IP falling the range - 142.250.0.0 - 142.250.255.255 (for a total of 65,025 IP addresses)

  3. Few more examples:

    1. 142.250.67.0/24 signifies the range 142.250.67.0 - 142.250.67.255 (for a total of 255 IP addresses)

    2. 142.250.67.248/29 specifies the range 142.250.67.248 - 142.250.67.255 (for a total of 8 IP addresses)

Frequently Asked Questions

  1. How to reset the password of an API user?

  Ans: You can either reset it manually via the UI or include the reset password process in your API code.

API Details:

URL

https://<URL>/rest/ng/users/password

Method

PUT

Request Payload

Code Block
{
  "userId": <userId>,
  "oldPassword": "<oldPassword>",
  "newPassword": "<newPassword>""
}

Response

true

  1. Is there any way to stop expiring API user password? 

 Ans: No. You have to manually reset the API user password or update the code to reset the password programmatically using #1.

  1. Can we configure multiple subnets in the IP address field?

   Ans: Yes, you can configure multiple subnet IP ranges. Each IP range has to be separated using a comma. 

For e.g, 192.168.0.0/16,204.48.25.207,104.131.254.19