Creating a Virtual MFA Device

Function

This API is provided for IAM users to create a virtual MFA device.

URI

POST /v3.0/OS-MFA/virtual-mfa-devices

Request Parameters

Table 1 Parameters in the request header

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Token (no special permission requirements) of the IAM user corresponding to the user_id specified in the request body.

Table 2 Parameters in the request body

Parameter

Mandatory

Type

Description

virtual_mfa_device

Yes

object

MFA device information.

Table 3 virtual_mfa_device

Parameter

Mandatory

Type

Description

name

Yes

String

Device name.

Minimum length: 1 character

Maximum length: 64 characters

user_id

Yes

String

ID of the user for whom you will create the MFA device.

Response Parameters

Status code: 201

Table 4 Parameters in the response body

Parameter

Type

Description

virtual_mfa_device

object

MFA device information.

Table 5 virtual_mfa_device

Parameter

Type

Description

serial_number

String

Serial number of the MFA device.

base32_string_seed

String

Base32 seed, which a third-party system can use to generate a CAPTCHA code.

Example Request

POST https://sample.domain.com/v3.0/OS-MFA/virtual-mfa-devices

{
  "virtual_mfa_device" : {
    "name" : "{device_name}",
    "user_id" : "09f99d8f6a001d4f1f01c00c31968..."
  }
}

Example Response

Status code: 201

The request is successful.

{
  "virtual_mfa_device": {
    "serial_number": "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}",
    "base32_string_seed": "{string}"
  }
}

Status Codes

Status Code

Description

201

The request is successful.

400

The request is invalid.

401

Authentication failed.

403

You do not have permission to perform this action.

409

A conflict occurs when the requested resource is saved.

500

A system error occurred.