Home Mode avec Surveillance Station

L’option Geofence de Synology semble avoir quelques soucis et après de nombreux essais sans succès, j’ai décidé de passer par l’API de Surveillance Station pour déclencher le Home Mode et ainsi de refaire mon propre mode “Geofence”.

Pour l’événement déclencheur, j’ai choisi de me baser sur la présence de mes téléphones portables sur le réseau. L’utilitaire “nmap” est donc utilisé pour faire un scan rapide du réseau et un script Python se charge du reste. Le tout est mis en cron sur un Raspberry Pi (ou tout autre système Linux/Unix supportant nmap et python). Les appels HTTP sont faits sur le réseau local mais il est possible de le faire depuis l’extérieur, sous réserve que Surveillance Station soit accessible.

Dans un 1er temps, on s’identifie via la méthode Login pour récupérer un identifiant de session (SID). Puis, on utilise cet SID dans la suite des appels.

Le script en lui-même est assez simple, il suffit de mettre à jour les variables suivantes :

DOMAIN.COM
PORT
USERNAME
PASSWORD
DEVICE1
DEVICE2

#!/usr/bin/python

import json
import os
import requests

## Get SID
def authHomeMode():
 res = requests.get('https://DOMAIN.COM:PORT/webapi/auth.cgi?api=SYNO.API.Auth&method=Login&version=2&account=USERNAME&passwd=PASSWORD&session=SurveillanceStation&format=sid')
 res_native = json.loads(res.text)
 sid=str(res_native.get('data').get('sid'))
 return sid

## Get current home mode
def getHomeMode(sid):
 res = requests.get('https:///DOMAIN.COM:PORT/webapi/entry.cgi?api="SYNO.SurveillanceStation.HomeMode"&version=1&method=GetInfo&need_mobiles=true&_sid='+sid)
 res_native = json.loads(res.text)
 state = str(res_native.get('data').get('on'))
 return state

## Set home mode
def setHomeMode(sid, state):
 res = requests.get('http:///DOMAIN.COM:PORT/webapi/entry.cgi?api="SYNO.SurveillanceStation.HomeMode"&version=1&method=Switch&on='+state+'&_sid='+sid);
 
## Check if the target device is on the network
def isDeviceOnNetwork(hostname):
 response=os.system("cat /tmp/nmap.out | grep " + hostname+' > /dev/null')
 if response == 0:
  return True
 else:
  return False

## Main
# Scan the local network
os.system("nmap -sn 192.168.1.0/24 > /tmp/nmap.out")
isHome = isDeviceOnNetwork('DEVICE1') or isDeviceOnNetwork('DEVICE2')

sid = authHomeMode()
state = getHomeMode(sid)
# Nobody at home and Home Mode is enabled => disable it
if state == 'True' and isHome == False:
 setHomeMode(sid, 'false')

# Device detected and Home Mode is disabled => enable it
if state == 'False' and isHome == True: 
 setHomeMode(sid, 'true')

#!/usr/bin/python

import json

import os

import requests

## Get SID

def authHomeMode():

res = requests.get('https://DOMAIN.COM:PORT/webapi/auth.cgi?api=SYNO.API.Auth&method=Login&version=2&account=USERNAME&passwd=PASSWORD&session=SurveillanceStation&format=sid')

res_native = json.loads(res.text)

sid=str(res_native.get('data').get('sid'))

return sid

## Get current home mode

def getHomeMode(sid):

res = requests.get('https:///DOMAIN.COM:PORT/webapi/entry.cgi?api="SYNO.SurveillanceStation.HomeMode"&version=1&method=GetInfo&need_mobiles=true&_sid='+sid)

res_native = json.loads(res.text)

state = str(res_native.get('data').get('on'))

return state

## Set home mode

def setHomeMode(sid, state):

res = requests.get('http:///DOMAIN.COM:PORT/webapi/entry.cgi?api="SYNO.SurveillanceStation.HomeMode"&version=1&method=Switch&on='+state+'&_sid='+sid);

## Check if the target device is on the network

def isDeviceOnNetwork(hostname):

response=os.system("cat /tmp/nmap.out | grep " + hostname+' > /dev/null')

if response == 0:

return True

else:

return False

## Main

# Scan the local network

os.system("nmap -sn 192.168.1.0/24 > /tmp/nmap.out")

isHome = isDeviceOnNetwork('DEVICE1') or isDeviceOnNetwork('DEVICE2')

sid = authHomeMode()

state = getHomeMode(sid)

# Nobody at home and Home Mode is enabled => disable it

if state == 'True' and isHome == False:

setHomeMode(sid, 'false')

# Device detected and Home Mode is disabled => enable it

if state == 'False' and isHome == True:

setHomeMode(sid, 'true')