mfa.create

説明

object mfa.create(object/array MFA methods)

このメソッドは、新しいMFAメソッドを作成します。

このメソッドは、スーパー管理者ユーザータイプでのみ使用できます。 このメソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳しくは、ユーザーロールをご覧ください。

パラメータ

(object/array) 作成するスクリプト

このメソッドは、標準のスクリプトプロパティを持つスクリプトを受けつけます。

戻り値

(object) mfaids プロパティの下で作成されたMFA メソッドの ID を含むオブジェクトを返します。 返される ID の順序は、渡されたアイテムの順序と一致します。

例

MFA メソッドの作成

時間ベースのワンタイムパスワード (TOTP) を利用した "Zabbix TOTP" MFA メソッドを作成します。TOTP コード生成用のハッシュ関数は SHA-1 に設定し、検証コードの長さは 6 桁に設定します。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "mfa.create",
    "params": {
        "type": 1,
        "name": "Zabbix TOTP",
        "hash_function": 1,
        "code_length": 6
    },
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "mfaids": [
            "1"
        ]
    },
    "id": 1
}
{
"jsonrpc": "2.0",
"method": "mfa.create",
"params": {
"type": 1,
"name": "Zabbix TOTP",
"hash_function": 1,
"code_length": 6
},
"id": 1
}

レスポンス:

{
"jsonrpc": "2.0",
"result": {
"mfaids": [
"1"
]
},
"id": 1
}

ソース

CMfa::create() in ui/include/classes/api/services/CMfa.php.