# system.kanoa.security.getUsers(paramsDict)

Returns users filtered by the passed parameters. paramsDict keys are optional.

---
### Parameters
**paramsDict** `Dictionary`<br />
<table class='dictionaryKeyTable'>
	<tbody>
 	<tr><td> - assetId</td><td>int</td><td>Id of asset to check functionName against. Only required when functionName is passed</td></tr>	
 	<tr><td> - functionName</td><td>String</td><td>When passed with assetId, filters to users who have this function on that asset (or an ancestor of it), plus all gateway admins</td></tr>	
 	<tr><td> - idpUserId</td><td>Integer</td><td>userId coming from the ignition authentication session properties</td></tr>	
 	<tr><td> - userId</td><td>Integer</td><td></td></tr>	
 	<tr><td> - userName</td><td>String</td><td></td></tr>	
	</tbody>
</table>

---
### Returns
**userData** `pyDataset`<br />

---
### Example
```python
userData = system.kanoa.security.getUsers({'userName': 'johndoe'})
```