Compare commits
5 Commits
1c28d0ac84
...
1.0.5
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5a464316f1 | ||
|
|
8dec92b43a | ||
|
|
9ac724ed4c | ||
| f7ab676b0d | |||
| b78a9512d8 |
93
GLPIAPI.py
93
GLPIAPI.py
@@ -3,7 +3,7 @@ import json
|
|||||||
from datetime import datetime
|
from datetime import datetime
|
||||||
|
|
||||||
class GLPIAPI:
|
class GLPIAPI:
|
||||||
def __init__(self, Server, AppToken, UserToken, UserAgent="GLPI API"):
|
def __init__(self, Server, AppToken, UserToken, UserAgent="GLPI API", Profile=None):
|
||||||
self.Server = Server
|
self.Server = Server
|
||||||
self.AppToken = AppToken
|
self.AppToken = AppToken
|
||||||
self.UserToken = UserToken
|
self.UserToken = UserToken
|
||||||
@@ -11,7 +11,14 @@ class GLPIAPI:
|
|||||||
self.SessionToken = None
|
self.SessionToken = None
|
||||||
self.StatusCode = None
|
self.StatusCode = None
|
||||||
self.Headers = None
|
self.Headers = None
|
||||||
|
self.ActiveProfile = None
|
||||||
self.InitConnection()
|
self.InitConnection()
|
||||||
|
if(Profile == None):
|
||||||
|
self.ActiveProfile = self.GetActiveProfile()
|
||||||
|
else:
|
||||||
|
self.ActiveProfile = Profile
|
||||||
|
profileId = self.GetItems('Profile', 'Profile.name', Profile)[1]['2']
|
||||||
|
self.SetActiveProfile(profileId)
|
||||||
|
|
||||||
def InitConnection(self):
|
def InitConnection(self):
|
||||||
initURI = '/apirest.php/initSession/'
|
initURI = '/apirest.php/initSession/'
|
||||||
@@ -32,6 +39,9 @@ class GLPIAPI:
|
|||||||
"Session-Token": self.SessionToken,
|
"Session-Token": self.SessionToken,
|
||||||
"App-Token": self.AppToken
|
"App-Token": self.AppToken
|
||||||
}
|
}
|
||||||
|
if(self.GetActiveProfile() != self.ActiveProfile and self.ActiveProfile != None):
|
||||||
|
profileId = self.GetItems('Profile', 'Profile.name', self.ActiveProfile)[1]['2']
|
||||||
|
self.SetActiveProfile(profileId)
|
||||||
else:
|
else:
|
||||||
raise Exception(f"{result.status_code} - {result.json()[0]}")
|
raise Exception(f"{result.status_code} - {result.json()[0]}")
|
||||||
|
|
||||||
@@ -42,7 +52,34 @@ class GLPIAPI:
|
|||||||
self.InitConnection()
|
self.InitConnection()
|
||||||
return
|
return
|
||||||
|
|
||||||
def GetComputers(self, deviceName=None, serialNumber=None, user=None, imei=None, airwatchDevice=None):
|
def GetUserProfiles(self):
|
||||||
|
self.CheckConnection()
|
||||||
|
uri = f"{self.Server}/apirest.php/getMyProfiles"
|
||||||
|
req = requests.get(uri, headers=self.Headers)
|
||||||
|
if(req.status_code == 200):
|
||||||
|
return req.json()
|
||||||
|
else:
|
||||||
|
return req.status_code
|
||||||
|
|
||||||
|
def GetActiveProfile(self):
|
||||||
|
self.CheckConnection()
|
||||||
|
uri = f"{self.Server}/apirest.php/getActiveProfile"
|
||||||
|
req = requests.get(uri, headers=self.Headers)
|
||||||
|
if(req.status_code == 200):
|
||||||
|
return req.json()['active_profile']['name']
|
||||||
|
else:
|
||||||
|
return req.status_code
|
||||||
|
|
||||||
|
def SetActiveProfile(self, profileId):
|
||||||
|
self.CheckConnection()
|
||||||
|
body = {
|
||||||
|
"profiles_id" : profileId
|
||||||
|
}
|
||||||
|
|
||||||
|
uri = f"{self.Server}/apirest.php/changeActiveProfile"
|
||||||
|
return requests.post(uri, headers=self.Headers, json=body)
|
||||||
|
|
||||||
|
def GetComputers(self, deviceName=None, serialNumber=None, user=None, imei=None, airwatchDevice=None, fieldsToDisplay=[], trashbin=0):
|
||||||
'''
|
'''
|
||||||
Search for computer items in GLPI based on one of the possibles parameters :
|
Search for computer items in GLPI based on one of the possibles parameters :
|
||||||
- deviceName : name of the item
|
- deviceName : name of the item
|
||||||
@@ -50,7 +87,10 @@ class GLPIAPI:
|
|||||||
- user : user of the item
|
- user : user of the item
|
||||||
- imei : custom field using field plugin (only for internal use)
|
- imei : custom field using field plugin (only for internal use)
|
||||||
- airwatchDevice : an airwatchDevice object from airwatchAPI module
|
- airwatchDevice : an airwatchDevice object from airwatchAPI module
|
||||||
If no parameters are set, it will search for all items
|
If no parameters are set, it will search for all items.
|
||||||
|
|
||||||
|
fieldsToDisplay: set fields to forcefully add to the results of the search (must be a list [])
|
||||||
|
trashbin: set if the search is in the trashbin or not (0 not in the trash or 1 in the trash)
|
||||||
|
|
||||||
Return a tuple with item id, item data and item count.
|
Return a tuple with item id, item data and item count.
|
||||||
'''
|
'''
|
||||||
@@ -58,43 +98,47 @@ class GLPIAPI:
|
|||||||
searchAll = False
|
searchAll = False
|
||||||
if(deviceName != None):
|
if(deviceName != None):
|
||||||
# Recherche en fonction du nom de l'appareil
|
# Recherche en fonction du nom de l'appareil
|
||||||
search_parameter = f'is_deleted=0&criteria[0][field]=1&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{deviceName}$'
|
search_parameter = f'is_deleted={trashbin}&criteria[0][field]=1&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{deviceName}$'
|
||||||
elif(user != None):
|
elif(user != None):
|
||||||
# Recherche en fonction de l'utilisateur de l'appareil
|
# Recherche en fonction de l'utilisateur de l'appareil
|
||||||
search_parameter = f'is_deleted=0&criteria[0][field]=70&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{user}$'
|
search_parameter = f'is_deleted={trashbin}&criteria[0][field]=70&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{user}$'
|
||||||
elif(airwatchDevice != None):
|
elif(airwatchDevice != None):
|
||||||
if(airwatchDevice.Imei != ''):
|
if(airwatchDevice.Imei != ''):
|
||||||
# Recherche des appareils en fonction du numéro de série ou de l'imei
|
# Recherche des appareils en fonction du numéro de série ou de l'imei
|
||||||
# l'imei pouvant être dans le champ numéro de série ou les champs imei custom (plugin field)
|
# l'imei pouvant être dans le champ numéro de série ou les champs imei custom (plugin field)
|
||||||
search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{airwatchDevice.SerialNumber}$'\
|
search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{airwatchDevice.SerialNumber}$'\
|
||||||
f'&criteria[1][link]=OR&criteria[1][field]=5&criteria[1][searchtype]=contains&criteria[1][value]=^{airwatchDevice.Imei}$'\
|
f'&criteria[1][link]=OR&criteria[1][field]=5&criteria[1][searchtype]=contains&criteria[1][value]=^{airwatchDevice.Imei}$'\
|
||||||
f'&criteria[2][link]=OR&criteria[2][field]=76667&criteria[2][searchtype]=contains&criteria[2][value]=^{airwatchDevice.Imei}$'\
|
f'&criteria[2][link]=OR&criteria[2][field]=76667&criteria[2][searchtype]=contains&criteria[2][value]=^{airwatchDevice.Imei}$'\
|
||||||
f'&criteria[3][link]=OR&criteria[3][field]=76670&criteria[3][searchtype]=contains&criteria[3][value]=^{airwatchDevice.Imei}$'
|
f'&criteria[3][link]=OR&criteria[3][field]=76670&criteria[3][searchtype]=contains&criteria[3][value]=^{airwatchDevice.Imei}$'
|
||||||
else:
|
else:
|
||||||
# Recherche des appareils en fonction du numéro de série seulement
|
# Recherche des appareils en fonction du numéro de série seulement
|
||||||
search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{airwatchDevice.SerialNumber}$'
|
search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{airwatchDevice.SerialNumber}$'
|
||||||
|
|
||||||
elif(imei != None):
|
elif(imei != None):
|
||||||
# Recherche des appareils en fonction du numéro de série ou de l'imei
|
# Recherche des appareils en fonction du numéro de série ou de l'imei
|
||||||
# l'imei pouvant être dans le champ numéro de série ou les champs imei custom (plugin field)
|
# l'imei pouvant être dans le champ numéro de série ou les champs imei custom (plugin field)
|
||||||
search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'\
|
search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'\
|
||||||
f'&criteria[1][link]=OR&criteria[1][field]=5&criteria[1][searchtype]=contains&criteria[1][value]=^{imei}$'\
|
f'&criteria[1][link]=OR&criteria[1][field]=5&criteria[1][searchtype]=contains&criteria[1][value]=^{imei}$'\
|
||||||
f'&criteria[2][link]=OR&criteria[2][field]=76667&criteria[2][searchtype]=contains&criteria[2][value]=^{imei}$'\
|
f'&criteria[2][link]=OR&criteria[2][field]=76667&criteria[2][searchtype]=contains&criteria[2][value]=^{imei}$'\
|
||||||
f'&criteria[3][link]=OR&criteria[3][field]=76670&criteria[3][searchtype]=contains&criteria[3][value]=^{imei}$'
|
f'&criteria[3][link]=OR&criteria[3][field]=76670&criteria[3][searchtype]=contains&criteria[3][value]=^{imei}$'
|
||||||
|
|
||||||
elif(serialNumber != None):
|
elif(serialNumber != None):
|
||||||
# Recherche des appareils en fonction du numéro de série seulement
|
# Recherche des appareils en fonction du numéro de série seulement
|
||||||
search_parameter = f'is_deleted=0&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'
|
search_parameter = f'is_deleted={trashbin}&criteria[0][field]=5&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{serialNumber}$'
|
||||||
|
|
||||||
else:
|
else:
|
||||||
# Recherche de l'ensemble des appareils si rien n'est renseigné
|
# Recherche de l'ensemble des appareils si rien n'est renseigné
|
||||||
searchAll = True
|
searchAll = True
|
||||||
|
|
||||||
search_parameter = f'is_deleted=0&criteria[0][link]=AND&criteria[0][field]=view&criteria[0][searchtype]=contains&criteria[0][value]='
|
|
||||||
if(searchAll):
|
if(searchAll):
|
||||||
searchUri = f"{self.Server}/apirest.php/search/Computer/?range=0-9999999&is_deleted=0"
|
searchUri = f"{self.Server}/apirest.php/search/Computer/?range=0-9999999&is_deleted={trashbin}"
|
||||||
else:
|
else:
|
||||||
searchUri = f"{self.Server}/apirest.php/search/Computer?{search_parameter}"
|
searchUri = f"{self.Server}/apirest.php/search/Computer?{search_parameter}"
|
||||||
|
|
||||||
|
if(fieldsToDisplay != []):
|
||||||
|
for i in range(len(fieldsToDisplay)):
|
||||||
|
searchUri += f"&forcedisplay[{i}]={fieldsToDisplay[i]}"
|
||||||
|
|
||||||
search = requests.get(searchUri, headers=self.Headers)
|
search = requests.get(searchUri, headers=self.Headers)
|
||||||
if(search.status_code == 200):
|
if(search.status_code == 200):
|
||||||
search = search.json()
|
search = search.json()
|
||||||
@@ -115,7 +159,7 @@ class GLPIAPI:
|
|||||||
|
|
||||||
return None, search, 0
|
return None, search, 0
|
||||||
|
|
||||||
def GetItems(self, itemType, fieldName=None, fieldValue=None):
|
def GetItems(self, itemType, fieldName=None, fieldValue=None, fieldsToDisplay=[], trashbin=0):
|
||||||
'''
|
'''
|
||||||
Search for items of a specific item type in GLPI. A filter can be set using fieldName and fieldValue :
|
Search for items of a specific item type in GLPI. A filter can be set using fieldName and fieldValue :
|
||||||
fieldName: must be the name of the field as visible in GLPI
|
fieldName: must be the name of the field as visible in GLPI
|
||||||
@@ -130,15 +174,22 @@ class GLPIAPI:
|
|||||||
if(fieldName != None and fieldValue != None):
|
if(fieldName != None and fieldValue != None):
|
||||||
fieldId = list(self.GetSearchOptions(itemType, fieldName))[0]
|
fieldId = list(self.GetSearchOptions(itemType, fieldName))[0]
|
||||||
# Recherche en fonction de l'utilisateur de l'appareil
|
# Recherche en fonction de l'utilisateur de l'appareil
|
||||||
search_parameter = f'is_deleted=0&criteria[0][field]={fieldId}&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{fieldValue}$'
|
search_parameter = f'is_deleted={trashbin}&criteria[0][field]={fieldId}&withindexes=true&criteria[0][searchtype]=contains&criteria[0][value]=^{fieldValue}$'
|
||||||
else:
|
else:
|
||||||
searchAll = True
|
searchAll = True
|
||||||
|
|
||||||
if(searchAll):
|
if(searchAll):
|
||||||
searchUri = f"{self.Server}/apirest.php/search/{itemType}/?range=0-9999999&is_deleted=0"
|
searchUri = f"{self.Server}/apirest.php/search/{itemType}/?range=0-9999999&is_deleted={trashbin}"
|
||||||
else:
|
else:
|
||||||
searchUri = f"{self.Server}/apirest.php/search/{itemType}?{search_parameter}"
|
searchUri = f"{self.Server}/apirest.php/search/{itemType}?{search_parameter}"
|
||||||
|
|
||||||
|
idFieldNumber = list(self.GetSearchOptions(itemType, f'{itemType}.id'))[0]
|
||||||
|
searchUri += f"&forcedisplay[0]={idFieldNumber}"
|
||||||
|
|
||||||
|
if(fieldsToDisplay != []):
|
||||||
|
for i in range(1, len(fieldsToDisplay)+1):
|
||||||
|
searchUri += f"&forcedisplay[{i}]={fieldsToDisplay[i-1]}"
|
||||||
|
|
||||||
search = requests.get(searchUri, headers=self.Headers)
|
search = requests.get(searchUri, headers=self.Headers)
|
||||||
|
|
||||||
if(search.status_code == 200):
|
if(search.status_code == 200):
|
||||||
@@ -150,7 +201,6 @@ class GLPIAPI:
|
|||||||
return itemID, data, search["totalcount"]
|
return itemID, data, search["totalcount"]
|
||||||
elif(search["totalcount"] > 1):
|
elif(search["totalcount"] > 1):
|
||||||
if(searchAll):
|
if(searchAll):
|
||||||
idFieldNumber = list(self.GetSearchOptions(itemType, 'id'))[0]
|
|
||||||
itemID = [i[idFieldNumber] for i in search["data"]]
|
itemID = [i[idFieldNumber] for i in search["data"]]
|
||||||
else:
|
else:
|
||||||
itemID = list(search["data"].keys())
|
itemID = list(search["data"].keys())
|
||||||
@@ -160,7 +210,7 @@ class GLPIAPI:
|
|||||||
|
|
||||||
return None, search, 0
|
return None, search, 0
|
||||||
|
|
||||||
def GetUsers(self, username=None, email=None):
|
def GetUsers(self, username=None, email=None, fieldsToDisplay=[], trashbin=0):
|
||||||
'''
|
'''
|
||||||
Search for users in GLPI based on one of the possibles parameters :
|
Search for users in GLPI based on one of the possibles parameters :
|
||||||
- username : username of the glpi user
|
- username : username of the glpi user
|
||||||
@@ -172,13 +222,12 @@ class GLPIAPI:
|
|||||||
fieldName = None
|
fieldName = None
|
||||||
fieldValue = None
|
fieldValue = None
|
||||||
if(username != None):
|
if(username != None):
|
||||||
fieldName = 'login'
|
fieldName = 'User.name'
|
||||||
fieldValue = username
|
fieldValue = username
|
||||||
elif(email != None):
|
elif(email != None):
|
||||||
fieldName = 'Emails'
|
fieldName = 'User.UserEmail.email'
|
||||||
fieldValue = email
|
fieldValue = email
|
||||||
|
return self.GetItems("User", fieldName, fieldValue, fieldsToDisplay, trashbin)
|
||||||
return self.GetItems("User", fieldName, fieldValue)
|
|
||||||
|
|
||||||
def GetSearchOptions(self, itemType, fieldName=None):
|
def GetSearchOptions(self, itemType, fieldName=None):
|
||||||
self.CheckConnection()
|
self.CheckConnection()
|
||||||
@@ -188,7 +237,7 @@ class GLPIAPI:
|
|||||||
searchOptions = searchOptions.json()
|
searchOptions = searchOptions.json()
|
||||||
if(fieldName != None):
|
if(fieldName != None):
|
||||||
for k,v in searchOptions.items():
|
for k,v in searchOptions.items():
|
||||||
if(v['name'].lower() == fieldName.lower()):
|
if('uid' in v.keys() and v['uid'].lower() == fieldName.lower()):
|
||||||
return {k : searchOptions[k]}
|
return {k : searchOptions[k]}
|
||||||
return searchOptions
|
return searchOptions
|
||||||
return searchOptions.status_code
|
return searchOptions.status_code
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
|
|||||||
|
|
||||||
[project]
|
[project]
|
||||||
name = "GLPIAPI"
|
name = "GLPIAPI"
|
||||||
version = "1.0.4"
|
version = "1.0.5"
|
||||||
description = "A module python to make it easier to use GLPI API"
|
description = "A module python to make it easier to use GLPI API"
|
||||||
readme = "README.md"
|
readme = "README.md"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
|
|||||||
Reference in New Issue
Block a user