[comment]: # translation:outdated

[comment]: # ({43f8bc43-43f8bc43})
# user.checkAuthentication

[comment]: # ({/43f8bc43-43f8bc43})

[comment]: # ({3c28b1f2-a9b9d697})
### Beschrijving

`object user.checkAuthentication`

Deze methode controleert en verlengt de gebruikerssessie.

::: noteimportant
Het aanroepen van de `user.checkAuthentication` methode met de parameter `sessionid` verlengt standaard de gebruikerssessie.
:::

[comment]: # ({/3c28b1f2-a9b9d697})

[comment]: # ({340bc2e8-49a0b391})
### Parameters

De methode accepteert de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Omschrijving|
|--|--|------|
|extend|boolean|Of de gebruikerssessie moet worden verlengd.<br><br>Standaardwaarde: "true".<br>Het instellen van de waarde op "false" maakt het mogelijk om de gebruikerssessie te controleren zonder deze te verlengen.<br><br>[Gedrag van parameters](/manual/api/reference_commentary#parameter-behavior):<br>- *ondersteund* als `sessionid` is ingesteld|
|sessionid|string|Gebruikers [authenticatietoken](/manual/api#authentication).<br><br>[Gedrag van parameters](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist* als `token` niet is ingesteld|
|secret|string|Willekeurige tekenreeks van 32 tekens. Wordt gegenereerd bij het inloggen van de gebruiker.|
|token|string|Gebruikers [API-token](/manual/api#authentication).<br><br>[Gedrag van parameters](/manual/api/reference_commentary#parameter-behavior):<br>- *vereist* als `sessionid` niet is ingesteld|

[comment]: # ({/340bc2e8-49a0b391})

[comment]: # ({0df38ffd-a8544e3e})
### Retourwaarden

`(object)` Geeft een object terug met informatie over de gebruiker.

Naast de [standaard gebruikers eigenschappen](object#user), worden de volgende gegevens ook geretourneerd.

| Eigenschap | [Type](/manual/api/reference_commentary#data_types) | Beschrijving |
| -- | -- | ------ |
| auth\_type | integer | Standaard authenticatie voor de gebruiker.<br><br>Zie de eigenschap `authentication_type` van het [Authenticatie object](/manual/api/reference/authentication/object#authentication-object) voor een lijst van mogelijke waarden. |
| debug\_mode | integer | Of debugmodus ingeschakeld of uitgeschakeld is voor de gebruiker.<br><br>Zie de eigenschap `debug_mode` van het [Gebruikersgroep object](/manual/api/reference/usergroup/object#user_group) voor een lijst van mogelijke waarden. |
| deprovisioned | boolean | Of de gebruiker behoort tot een [gebruikersgroep met gedeprovisioneerde gebruikers](/manual/web_interface/frontend_sections/users/authentication#configuration). |
| gui\_access | string | De authenticatiemethode van de gebruiker voor de frontend.<br><br>Zie de eigenschap `gui_access` van het [Gebruikersgroep object](/manual/api/reference/usergroup/object#user_group) voor een lijst van mogelijke waarden. |
| secret | string | Willekeurige tekenreeks van 32 tekens. Wordt gegenereerd bij het inloggen van de gebruiker.<br><br>Eigenschap `secret` wordt niet geretourneerd als de gebruikerssessie wordt gecontroleerd met behulp van een API-token. |
| sessionid | string | Authenticatietoken dat moet worden gebruikt in de volgende API-verzoeken.<br><br>Eigenschap `sessionid` wordt niet geretourneerd als de gebruikerssessie wordt gecontroleerd met behulp van een API-token. |
| type | integer | Gebruikerstype.<br><br>Zie de eigenschap `type` van het [Rol object](/manual/api/reference/role/object#role) voor een lijst van mogelijke waarden. |
| userip | string | IP-adres van de gebruiker. |

[comment]: # ({/0df38ffd-a8544e3e})

[comment]: # ({b41637d2-e79e2236})
### Voorbeelden

[comment]: # ({/b41637d2-e79e2236})

[comment]: # ({b9f7b22c-d574e685})
##### Controleer authenticatie met behulp van een authenticatietoken

Controleer en verleng een gebruikerssessie met behulp van het authenticatietoken van de gebruiker en geef aanvullende informatie over de gebruiker terug.

[Aanvraag](/manual/api#performing-requests):

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

Reactie:

```json
{
    "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
}
```

[comment]: # ({/b9f7b22c-d574e685})

[comment]: # ({733c4ce5-698590d0})
##### Controleer authenticatie met behulp van een API-token

Controleer een gebruikerssessie met behulp van het API-token van de gebruiker en geef aanvullende informatie over de gebruiker terug.

[Aanvraag](/manual/api#performing-requests):

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

Reactie:

```json
{
    "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",
        "type": 3,
        "userip": "127.0.0.1",
        "debug_mode": 0,
        "gui_access": "1",
        "deprovisioned": false,
        "auth_type": 0
    },
    "id": 1
}
```

[comment]: # ({/733c4ce5-698590d0})

[comment]: # ({e7148ebe-97f5ed87})
### Bron

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

[comment]: # ({/e7148ebe-97f5ed87})