user.checkAuthentication

説明

object user.checkAuthentication

このメソッドはユーザーセッションをチェックし、延長します。

sessionidパラメータを使用してuser.checkAuthenticationメソッドを呼び出すと、デフォルトでユーザーセッションが延長されます。

パラメーター

このメソッドは以下のパラメーターを受け付けます。

パラメーター 型 説明
extend boolean ユーザーセッションを延長するかどうか。

デフォルト値: "true"
値を"false"に設定すると、セッションを延長せずにユーザーセッションをチェックできます。

パラメーターの動作:
- sessionidが設定されている場合はサポート
sessionid string ユーザーの認証トークン。

パラメーターの動作:
- tokenが設定されていない場合は必須
token string ユーザーのAPIトークン。

パラメーターの動作:
- sessionidが設定されていない場合は必須

戻り値

(object) ユーザーに関する情報を含むオブジェクトを返します。

標準のユーザーのプロパティに加えて、以下の情報が返されます。

プロパティ 型 説明
auth_type integer ユーザーのデフォルト認証。

可能な値の一覧は、認証オブジェクトのauthentication_typeプロパティを参照してください。
debug_mode integer ユーザーのデバッグモードが有効か無効か。

可能な値の一覧は、ユーザーグループオブジェクトのdebug_modeプロパティを参照してください。
deprovisioned boolean ユーザーが無効化されたユーザーグループに属しているかどうか。
gui_access string フロントエンドへのユーザーの認証方法。

可能な値の一覧は、ユーザーグループオブジェクトのgui_accessプロパティを参照してください。
secret string ランダムな32文字の文字列。ユーザーログイン時に生成されます。

APIトークンを使用してユーザーセッションを確認した場合、secretプロパティは返されません。
sessionid string 認証トークン。以降のAPIリクエストで使用する必要があります。

APIトークンを使用してユーザーセッションを確認した場合、sessionidプロパティは返されません。
type integer ユーザータイプ。

可能な値の一覧は、ロールオブジェクトのtypeプロパティを参照してください。
userip string ユーザーのIPアドレス。

例

認証トークンを使用し認証を確認

ユーザー認証トークンを使用してユーザーセッションを確認し、延長します。また、ユーザーに関する追加情報を返します。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "user.checkAuthentication",
    "params": {
        "sessionid": "673b8ba11562a35da902c66cf5c23fa2"
    },
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "userid": "1",
        "username": "Admin",
        "name": "Zabbix",
        "surname": "Administrator",
        "url": "",
        "autologin": "1",
        "autologout": "0",
        "lang": "ru_RU",
        "refresh": "0",
        "theme": "default",
        "attempt_failed": "0",
        "attempt_ip": "127.0.0.1",
        "attempt_clock": "1355919038",
        "rows_per_page": "50",
        "timezone": "Europe/Riga",
        "roleid": "3",
        "userdirectoryid": "0",
        "ts_provisioned": "0",
        "type": 3,
        "userip": "127.0.0.1",
        "debug_mode": 0,
        "gui_access": "0",
        "deprovisioned": false,
        "auth_type": 0,
        "sessionid": "673b8ba11562a35da902c66cf5c23fa2",
        "secret": "0e329b933e46984e49a5c1051ecd0751"
    },
    "id": 1
}
APIトークンを使用した認証の確認

ユーザーAPIトークンを使用してユーザーセッションを確認し、ユーザーに関する追加情報を返します。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "user.checkAuthentication",
    "params": {
        "token": "00aff470e07c12d707e50d98cfe39edef9e6ec349c14728dbdfbc8ddc5ea3eae"
    },
    "id": 1
}

レスポンス:

{
    "jsonrpc": "2.0",
    "result": {
        "userid": "1",
        "username": "Admin",
        "name": "Zabbix",
        "surname": "Administrator",
        "url": "",
        "autologin": "1",
        "autologout": "0",
        "lang": "ru_RU",
        "refresh": "0",
        "theme": "default",
        "attempt_failed": "0",
        "attempt_ip": "127.0.0.1",
        "attempt_clock": "1355919338",
        "rows_per_page": "50",
        "timezone": "Europe/Riga",
        "roleid": "3",
        "userdirectoryid": "0",
        "ts_provisioned": "0",
        "debug_mode": 0,
        "deprovisioned": false,
        "gui_access": "1",
        "mfaid": 0,
        "auth_type": 0,
        "type": 3,
        "userip": "127.0.0.1"
    },
    "id": 1
}

ソース

CUser::checkAuthentication() in ui/include/classes/api/services/CUser.php。