Cloud Administration Disable FIDO Authenticator API
a year ago

Cloud Administration Disable FIDO Authenticator API

The Cloud Administration Disable FIDO authenticator API allows Help Desk Administrators and Super Administrators to disable a FIDO authenticator that is assigned to a user. When an authenticator is disabled, it cannot be used for authentication.

For information about managing access to this API, see Accessing the Cloud Administration APIs.

Authentication

Clients calling this API must authenticate themselves by including a JSON web token in the request. For instructions on using this token, see Authentication for the Cloud Administration APIs .

Software Developer Kit

You can download the API Software Developer Kit (SDK) from Cloud Administration REST API Download.

Request Requirements

Use the following information to disable FIDO authenticator.

MethodRequest URLResponse Content TypeResponse BodyResponse Codes
PATCH/AdminInterface/restapi/v1/fido/{userId}/authenticators/{authenticatorId}/disableapplication/jsonFIDO status200, 400, 403, 429, 500.

Example Request Data

PATCH /AdminInterface/restapi/v1/fido/{userId}/authenticators/{authenticatorId}/disable

Accept: application/json

Authorization: Bearer <JWT token>

EXAMPLE REQUEST BODY: NA

REQUEST PROPERTY DESCRIPTIONS: NA

Example Response

{

"statusChangedAt": 1654604832860,

"statusChangedBy": <admin subject>,

"status": "Disabled"

}

Response Property Descriptions:

  • statusChangedAt: The timestamp when the FIDO authenticator was enabled. For information on formatting timestamps in ISO 8601 format, see https://www.w3.org/TR/NOTE-datetime.

  • statusChangedBy : Identifies the administrator who enabled the FIDO authenticator

  • status: FIDO Status (Enabled/Disabled)

Response Codes:

CodeDescription
200Successfully disabled FIDO authenticator assigned to the user.
400Invalid userId/authenticatorId/api url (Bad Request).
403Not authorized to perform the request.
429Too many requests.
500Internal server error occurred while processing the request.