API Scripts are recommended to use the Login call instead of separate Authentication & Authorization calls. Last step for logging in is sending the partial AuthToken for authorization and retrieving the AuthToken.
Authorization was successful. The AuthToken is ready for any subsequent API call.
Information about logged in user, such as username and email address, if exists.
Username.
If true, it is not possible to complete login process without providing MFA.
Whether there is a LogServer deployed and the user has privileges to access to it.
The privileges the user has.
Administrative Privilege item. Use type-target-map API to get the details on which types are valid for which targets and their scopes.
The type of the Privilege defines the possible administrator actions.
The target of the Privilege defines the possible target objects for that type.
The scope of the Privilege. Only applicable to certain type-target combinations. Some types depend on the IdP/MFA type, such as GetUserAttributes. This field must be omitted if not applicable.
'If "true", all objects are accessible. For example, "type: Edit - target: Condition - scope.all: true" means the administrator can edit all Conditions in the system.'
Specific object IDs this Privilege would have access to.
Object tags this privilege would have access to.
The items in this list would be added automatically to the newly created objects' tags. Only applicable on "Create" type and targets with tagging capability. This field must be omitted if not applicable.
Privilege for changing Appliance Functions. Only applicable on "AssignFunction" type with Appliance or All target. This field must be omitted if not applicable.
The AuthToken required for subsequent API calls.
Token expiration time.
Message of the day configured by an admin.
ZTP type of the collective.
ZTP account type.
Whether X509 CRL is enabled for the system or not. Issued Certificates is disabled if it's not enabled.
Whether Protection Profile mode is enabled or not. Limits certain functionalities.
Whether user session inactivity timeout is enabled or not.
Number of minutes of inactivity before a user session is terminated. Minimum value is 1 minute. Not applicable if inactivity timeout is disabled.
JSON error. Check the JSON format.
Generic HTTP error.
Machine readable error code.
Human readable error details.
Login Failed.
Machine readable error code.
Human readable error details.
The authentication failure reason.
No administration rights.
Generic HTTP error.
Machine readable error code.
Human readable error details.
Invalid 'Accept' header.
Generic HTTP error.
Machine readable error code.
Human readable error details.
Request validation error. Check "errors" array for details.
Http 422 error for object validation.
Machine readable error code.
Human readable error details.
List of fields with validation errors.
Name of the field that failed validation.
Failure reason.
Name of the field that should be displayed in the UI. It's an internal field to be used by the local replication service.
Message to be displayed in the replication UI. It's an internal field to be used by the local replication service.
Unexpected server side error.
Generic HTTP error.
Machine readable error code.
Human readable error details.