431 lines
15 KiB
Python
431 lines
15 KiB
Python
"""Config flow to configure the Synology DSM integration."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Mapping
|
|
from ipaddress import ip_address as ip
|
|
import logging
|
|
from typing import Any, cast
|
|
from urllib.parse import urlparse
|
|
|
|
from synology_dsm import SynologyDSM
|
|
from synology_dsm.exceptions import (
|
|
SynologyDSMException,
|
|
SynologyDSMLogin2SAFailedException,
|
|
SynologyDSMLogin2SARequiredException,
|
|
SynologyDSMLoginInvalidException,
|
|
SynologyDSMRequestException,
|
|
)
|
|
import voluptuous as vol
|
|
|
|
from homeassistant.config_entries import (
|
|
ConfigEntry,
|
|
ConfigFlow,
|
|
ConfigFlowResult,
|
|
OptionsFlow,
|
|
)
|
|
from homeassistant.const import (
|
|
CONF_DISKS,
|
|
CONF_HOST,
|
|
CONF_MAC,
|
|
CONF_NAME,
|
|
CONF_PASSWORD,
|
|
CONF_PORT,
|
|
CONF_SCAN_INTERVAL,
|
|
CONF_SSL,
|
|
CONF_USERNAME,
|
|
CONF_VERIFY_SSL,
|
|
)
|
|
from homeassistant.core import callback
|
|
from homeassistant.exceptions import HomeAssistantError
|
|
from homeassistant.helpers.aiohttp_client import async_get_clientsession
|
|
import homeassistant.helpers.config_validation as cv
|
|
from homeassistant.helpers.service_info.ssdp import (
|
|
ATTR_UPNP_FRIENDLY_NAME,
|
|
ATTR_UPNP_SERIAL,
|
|
SsdpServiceInfo,
|
|
)
|
|
from homeassistant.helpers.service_info.zeroconf import ZeroconfServiceInfo
|
|
from homeassistant.helpers.typing import DiscoveryInfoType, VolDictType
|
|
from homeassistant.util.network import is_ip_address as is_ip
|
|
|
|
from .const import (
|
|
CONF_DEVICE_TOKEN,
|
|
CONF_SNAPSHOT_QUALITY,
|
|
CONF_VOLUMES,
|
|
DEFAULT_PORT,
|
|
DEFAULT_PORT_SSL,
|
|
DEFAULT_SCAN_INTERVAL,
|
|
DEFAULT_SNAPSHOT_QUALITY,
|
|
DEFAULT_TIMEOUT,
|
|
DEFAULT_USE_SSL,
|
|
DEFAULT_VERIFY_SSL,
|
|
DOMAIN,
|
|
)
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
CONF_OTP_CODE = "otp_code"
|
|
|
|
HTTP_SUFFIX = "._http._tcp.local."
|
|
|
|
|
|
def _discovery_schema_with_defaults(discovery_info: DiscoveryInfoType) -> vol.Schema:
|
|
return vol.Schema(_ordered_shared_schema(discovery_info))
|
|
|
|
|
|
def _reauth_schema() -> vol.Schema:
|
|
return vol.Schema(
|
|
{
|
|
vol.Required(CONF_USERNAME): str,
|
|
vol.Required(CONF_PASSWORD): str,
|
|
}
|
|
)
|
|
|
|
|
|
def _user_schema_with_defaults(user_input: dict[str, Any]) -> vol.Schema:
|
|
user_schema: VolDictType = {
|
|
vol.Required(CONF_HOST, default=user_input.get(CONF_HOST, "")): str,
|
|
}
|
|
user_schema.update(_ordered_shared_schema(user_input))
|
|
|
|
return vol.Schema(user_schema)
|
|
|
|
|
|
def _ordered_shared_schema(schema_input: dict[str, Any]) -> VolDictType:
|
|
return {
|
|
vol.Required(CONF_USERNAME, default=schema_input.get(CONF_USERNAME, "")): str,
|
|
vol.Required(CONF_PASSWORD, default=schema_input.get(CONF_PASSWORD, "")): str,
|
|
vol.Optional(CONF_PORT, default=schema_input.get(CONF_PORT, "")): str,
|
|
vol.Optional(
|
|
CONF_SSL, default=schema_input.get(CONF_SSL, DEFAULT_USE_SSL)
|
|
): bool,
|
|
vol.Optional(
|
|
CONF_VERIFY_SSL,
|
|
default=schema_input.get(CONF_VERIFY_SSL, DEFAULT_VERIFY_SSL),
|
|
): bool,
|
|
}
|
|
|
|
|
|
def format_synology_mac(mac: str) -> str:
|
|
"""Format a mac address to the format used by Synology DSM."""
|
|
return mac.replace(":", "").replace("-", "").upper()
|
|
|
|
|
|
class SynologyDSMFlowHandler(ConfigFlow, domain=DOMAIN):
|
|
"""Handle a config flow."""
|
|
|
|
VERSION = 1
|
|
|
|
@staticmethod
|
|
@callback
|
|
def async_get_options_flow(
|
|
config_entry: ConfigEntry,
|
|
) -> SynologyDSMOptionsFlowHandler:
|
|
"""Get the options flow for this handler."""
|
|
return SynologyDSMOptionsFlowHandler()
|
|
|
|
def __init__(self) -> None:
|
|
"""Initialize the synology_dsm config flow."""
|
|
self.saved_user_input: dict[str, Any] = {}
|
|
self.discovered_conf: dict[str, Any] = {}
|
|
self.reauth_conf: Mapping[str, Any] = {}
|
|
self.reauth_reason: str | None = None
|
|
|
|
def _show_form(
|
|
self,
|
|
step_id: str,
|
|
user_input: dict[str, Any] | None = None,
|
|
errors: dict[str, str] | None = None,
|
|
) -> ConfigFlowResult:
|
|
"""Show the setup form to the user."""
|
|
if not user_input:
|
|
user_input = {}
|
|
|
|
description_placeholders = {}
|
|
data_schema = None
|
|
|
|
if step_id == "link":
|
|
user_input.update(self.discovered_conf)
|
|
data_schema = _discovery_schema_with_defaults(user_input)
|
|
description_placeholders = self.discovered_conf
|
|
elif step_id == "reauth_confirm":
|
|
data_schema = _reauth_schema()
|
|
elif step_id == "user":
|
|
data_schema = _user_schema_with_defaults(user_input)
|
|
|
|
return self.async_show_form(
|
|
step_id=step_id,
|
|
data_schema=data_schema,
|
|
errors=errors or {},
|
|
description_placeholders=description_placeholders,
|
|
)
|
|
|
|
async def async_validate_input_create_entry(
|
|
self, user_input: dict[str, Any], step_id: str
|
|
) -> ConfigFlowResult:
|
|
"""Process user input and create new or update existing config entry."""
|
|
host = user_input[CONF_HOST]
|
|
port = user_input.get(CONF_PORT)
|
|
username = user_input[CONF_USERNAME]
|
|
password = user_input[CONF_PASSWORD]
|
|
use_ssl = user_input.get(CONF_SSL, DEFAULT_USE_SSL)
|
|
verify_ssl = user_input.get(CONF_VERIFY_SSL, DEFAULT_VERIFY_SSL)
|
|
otp_code = user_input.get(CONF_OTP_CODE)
|
|
friendly_name = user_input.get(CONF_NAME)
|
|
|
|
if not port:
|
|
if use_ssl is True:
|
|
port = DEFAULT_PORT_SSL
|
|
else:
|
|
port = DEFAULT_PORT
|
|
|
|
session = async_get_clientsession(self.hass, verify_ssl)
|
|
api = SynologyDSM(
|
|
session, host, port, username, password, use_ssl, timeout=DEFAULT_TIMEOUT
|
|
)
|
|
|
|
errors = {}
|
|
try:
|
|
serial = await _login_and_fetch_syno_info(api, otp_code)
|
|
except SynologyDSMLogin2SARequiredException:
|
|
return await self.async_step_2sa(user_input)
|
|
except SynologyDSMLogin2SAFailedException:
|
|
errors[CONF_OTP_CODE] = "otp_failed"
|
|
user_input[CONF_OTP_CODE] = None
|
|
return await self.async_step_2sa(user_input, errors)
|
|
except SynologyDSMLoginInvalidException as ex:
|
|
_LOGGER.error(ex)
|
|
errors[CONF_USERNAME] = "invalid_auth"
|
|
except SynologyDSMRequestException as ex:
|
|
_LOGGER.error(ex)
|
|
errors[CONF_HOST] = "cannot_connect"
|
|
except SynologyDSMException as ex:
|
|
_LOGGER.error(ex)
|
|
errors["base"] = "unknown"
|
|
except InvalidData:
|
|
errors["base"] = "missing_data"
|
|
|
|
if errors:
|
|
return self._show_form(step_id, user_input, errors)
|
|
|
|
# unique_id should be serial for services purpose
|
|
existing_entry = await self.async_set_unique_id(serial, raise_on_progress=False)
|
|
|
|
config_data = {
|
|
CONF_HOST: host,
|
|
CONF_PORT: port,
|
|
CONF_SSL: use_ssl,
|
|
CONF_VERIFY_SSL: verify_ssl,
|
|
CONF_USERNAME: username,
|
|
CONF_PASSWORD: password,
|
|
CONF_MAC: api.network.macs,
|
|
}
|
|
if otp_code:
|
|
config_data[CONF_DEVICE_TOKEN] = api.device_token
|
|
if user_input.get(CONF_DISKS):
|
|
config_data[CONF_DISKS] = user_input[CONF_DISKS]
|
|
if user_input.get(CONF_VOLUMES):
|
|
config_data[CONF_VOLUMES] = user_input[CONF_VOLUMES]
|
|
|
|
if existing_entry:
|
|
reason = (
|
|
"reauth_successful" if self.reauth_conf else "reconfigure_successful"
|
|
)
|
|
return self.async_update_reload_and_abort(
|
|
existing_entry, data=config_data, reason=reason
|
|
)
|
|
|
|
return self.async_create_entry(title=friendly_name or host, data=config_data)
|
|
|
|
async def async_step_user(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Handle a flow initiated by the user."""
|
|
step = "user"
|
|
if not user_input:
|
|
return self._show_form(step)
|
|
return await self.async_validate_input_create_entry(user_input, step_id=step)
|
|
|
|
async def async_step_zeroconf(
|
|
self, discovery_info: ZeroconfServiceInfo
|
|
) -> ConfigFlowResult:
|
|
"""Handle a discovered synology_dsm via zeroconf."""
|
|
discovered_macs = [
|
|
format_synology_mac(mac)
|
|
for mac in discovery_info.properties.get("mac_address", "").split("|")
|
|
if mac
|
|
]
|
|
if not discovered_macs:
|
|
return self.async_abort(reason="no_mac_address")
|
|
host = discovery_info.host
|
|
friendly_name = discovery_info.name.removesuffix(HTTP_SUFFIX)
|
|
return await self._async_from_discovery(host, friendly_name, discovered_macs)
|
|
|
|
async def async_step_ssdp(
|
|
self, discovery_info: SsdpServiceInfo
|
|
) -> ConfigFlowResult:
|
|
"""Handle a discovered synology_dsm via ssdp."""
|
|
parsed_url = urlparse(discovery_info.ssdp_location)
|
|
upnp_friendly_name: str = discovery_info.upnp[ATTR_UPNP_FRIENDLY_NAME]
|
|
friendly_name = upnp_friendly_name.split("(", 1)[0].strip()
|
|
mac_address = discovery_info.upnp[ATTR_UPNP_SERIAL]
|
|
discovered_macs = [format_synology_mac(mac_address)]
|
|
# Synology NAS can broadcast on multiple IP addresses, since they can be connected to multiple ethernets.
|
|
# The serial of the NAS is actually its MAC address.
|
|
host = cast(str, parsed_url.hostname)
|
|
return await self._async_from_discovery(host, friendly_name, discovered_macs)
|
|
|
|
async def _async_from_discovery(
|
|
self, host: str, friendly_name: str, discovered_macs: list[str]
|
|
) -> ConfigFlowResult:
|
|
"""Handle a discovered synology_dsm via zeroconf or ssdp."""
|
|
existing_entry = None
|
|
for discovered_mac in discovered_macs:
|
|
await self.async_set_unique_id(discovered_mac)
|
|
if existing_entry := self._async_get_existing_entry(discovered_mac):
|
|
break
|
|
self._abort_if_unique_id_configured()
|
|
|
|
if (
|
|
existing_entry
|
|
and is_ip(existing_entry.data[CONF_HOST])
|
|
and is_ip(host)
|
|
and existing_entry.data[CONF_HOST] != host
|
|
and ip(existing_entry.data[CONF_HOST]).version == ip(host).version
|
|
):
|
|
_LOGGER.debug(
|
|
"Update host from '%s' to '%s' for NAS '%s' via discovery",
|
|
existing_entry.data[CONF_HOST],
|
|
host,
|
|
existing_entry.unique_id,
|
|
)
|
|
self.hass.config_entries.async_update_entry(
|
|
existing_entry,
|
|
data={**existing_entry.data, CONF_HOST: host},
|
|
)
|
|
return self.async_abort(reason="reconfigure_successful")
|
|
|
|
if existing_entry:
|
|
return self.async_abort(reason="already_configured")
|
|
|
|
self.discovered_conf = {
|
|
CONF_NAME: friendly_name,
|
|
CONF_HOST: host,
|
|
}
|
|
self.context["title_placeholders"] = self.discovered_conf
|
|
return await self.async_step_link()
|
|
|
|
async def async_step_link(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Link a config entry from discovery."""
|
|
step = "link"
|
|
if not user_input:
|
|
return self._show_form(step)
|
|
user_input = {**self.discovered_conf, **user_input}
|
|
return await self.async_validate_input_create_entry(user_input, step_id=step)
|
|
|
|
async def async_step_reauth(
|
|
self, entry_data: Mapping[str, Any]
|
|
) -> ConfigFlowResult:
|
|
"""Perform reauth upon an API authentication error."""
|
|
self.reauth_conf = entry_data
|
|
placeholders = {
|
|
**self.context["title_placeholders"],
|
|
CONF_HOST: entry_data[CONF_HOST],
|
|
}
|
|
self.context["title_placeholders"] = placeholders
|
|
|
|
return await self.async_step_reauth_confirm()
|
|
|
|
async def async_step_reauth_confirm(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Perform reauth confirm upon an API authentication error."""
|
|
step = "reauth_confirm"
|
|
if not user_input:
|
|
return self._show_form(step)
|
|
user_input = {**self.reauth_conf, **user_input}
|
|
return await self.async_validate_input_create_entry(user_input, step_id=step)
|
|
|
|
async def async_step_2sa(
|
|
self, user_input: dict[str, Any], errors: dict[str, str] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Enter 2SA code to anthenticate."""
|
|
if not self.saved_user_input:
|
|
self.saved_user_input = user_input
|
|
|
|
if not user_input.get(CONF_OTP_CODE):
|
|
return self.async_show_form(
|
|
step_id="2sa",
|
|
data_schema=vol.Schema({vol.Required(CONF_OTP_CODE): str}),
|
|
errors=errors or {},
|
|
)
|
|
|
|
user_input = {**self.saved_user_input, **user_input}
|
|
self.saved_user_input = {}
|
|
|
|
return await self.async_step_user(user_input)
|
|
|
|
def _async_get_existing_entry(self, discovered_mac: str) -> ConfigEntry | None:
|
|
"""See if we already have a configured NAS with this MAC address."""
|
|
for entry in self._async_current_entries():
|
|
if discovered_mac in [
|
|
format_synology_mac(mac) for mac in entry.data.get(CONF_MAC, [])
|
|
]:
|
|
return entry
|
|
return None
|
|
|
|
|
|
class SynologyDSMOptionsFlowHandler(OptionsFlow):
|
|
"""Handle a option flow."""
|
|
|
|
async def async_step_init(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Handle options flow."""
|
|
if user_input is not None:
|
|
return self.async_create_entry(title="", data=user_input)
|
|
|
|
data_schema = vol.Schema(
|
|
{
|
|
vol.Required(
|
|
CONF_SCAN_INTERVAL,
|
|
default=self.config_entry.options.get(
|
|
CONF_SCAN_INTERVAL, DEFAULT_SCAN_INTERVAL
|
|
),
|
|
): cv.positive_int,
|
|
vol.Required(
|
|
CONF_SNAPSHOT_QUALITY,
|
|
default=self.config_entry.options.get(
|
|
CONF_SNAPSHOT_QUALITY, DEFAULT_SNAPSHOT_QUALITY
|
|
),
|
|
): vol.All(vol.Coerce(int), vol.Range(min=0, max=2)),
|
|
}
|
|
)
|
|
return self.async_show_form(step_id="init", data_schema=data_schema)
|
|
|
|
|
|
async def _login_and_fetch_syno_info(api: SynologyDSM, otp_code: str | None) -> str:
|
|
"""Login to the NAS and fetch basic data."""
|
|
# These do i/o
|
|
await api.login(otp_code)
|
|
await api.utilisation.update()
|
|
await api.storage.update()
|
|
await api.network.update()
|
|
|
|
if (
|
|
not api.information.serial
|
|
or api.utilisation.cpu_user_load is None
|
|
or not api.storage.volumes_ids
|
|
or not api.network.macs
|
|
):
|
|
raise InvalidData
|
|
|
|
return api.information.serial
|
|
|
|
|
|
class InvalidData(HomeAssistantError):
|
|
"""Error to indicate we get invalid data from the nas."""
|