mirror of https://github.com/home-assistant/core
426 lines
14 KiB
Python
426 lines
14 KiB
Python
"""Config flow to configure the FRITZ!Box Tools integration."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Mapping
|
|
import ipaddress
|
|
import logging
|
|
import socket
|
|
from typing import Any, Self
|
|
from urllib.parse import ParseResult, urlparse
|
|
|
|
from fritzconnection import FritzConnection
|
|
from fritzconnection.core.exceptions import FritzConnectionException
|
|
import voluptuous as vol
|
|
|
|
from homeassistant.components import ssdp
|
|
from homeassistant.components.device_tracker import (
|
|
CONF_CONSIDER_HOME,
|
|
DEFAULT_CONSIDER_HOME,
|
|
)
|
|
from homeassistant.config_entries import (
|
|
ConfigEntry,
|
|
ConfigFlow,
|
|
ConfigFlowResult,
|
|
OptionsFlow,
|
|
)
|
|
from homeassistant.const import (
|
|
CONF_HOST,
|
|
CONF_PASSWORD,
|
|
CONF_PORT,
|
|
CONF_SSL,
|
|
CONF_USERNAME,
|
|
)
|
|
from homeassistant.core import callback
|
|
from homeassistant.helpers.typing import VolDictType
|
|
|
|
from .const import (
|
|
CONF_OLD_DISCOVERY,
|
|
DEFAULT_CONF_OLD_DISCOVERY,
|
|
DEFAULT_HOST,
|
|
DEFAULT_HTTP_PORT,
|
|
DEFAULT_HTTPS_PORT,
|
|
DEFAULT_SSL,
|
|
DOMAIN,
|
|
ERROR_AUTH_INVALID,
|
|
ERROR_CANNOT_CONNECT,
|
|
ERROR_UNKNOWN,
|
|
ERROR_UPNP_NOT_CONFIGURED,
|
|
FRITZ_AUTH_EXCEPTIONS,
|
|
)
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
class FritzBoxToolsFlowHandler(ConfigFlow, domain=DOMAIN):
|
|
"""Handle a FRITZ!Box Tools config flow."""
|
|
|
|
VERSION = 1
|
|
|
|
_host: str
|
|
|
|
@staticmethod
|
|
@callback
|
|
def async_get_options_flow(
|
|
config_entry: ConfigEntry,
|
|
) -> FritzBoxToolsOptionsFlowHandler:
|
|
"""Get the options flow for this handler."""
|
|
return FritzBoxToolsOptionsFlowHandler()
|
|
|
|
def __init__(self) -> None:
|
|
"""Initialize FRITZ!Box Tools flow."""
|
|
self._name: str = ""
|
|
self._password: str = ""
|
|
self._use_tls: bool = False
|
|
self._port: int | None = None
|
|
self._username: str = ""
|
|
self._model: str = ""
|
|
|
|
async def async_fritz_tools_init(self) -> str | None:
|
|
"""Initialize FRITZ!Box Tools class."""
|
|
return await self.hass.async_add_executor_job(self.fritz_tools_init)
|
|
|
|
def fritz_tools_init(self) -> str | None:
|
|
"""Initialize FRITZ!Box Tools class."""
|
|
|
|
try:
|
|
connection = FritzConnection(
|
|
address=self._host,
|
|
port=self._port,
|
|
user=self._username,
|
|
password=self._password,
|
|
use_tls=self._use_tls,
|
|
timeout=60.0,
|
|
pool_maxsize=30,
|
|
)
|
|
except FRITZ_AUTH_EXCEPTIONS:
|
|
return ERROR_AUTH_INVALID
|
|
except FritzConnectionException:
|
|
return ERROR_CANNOT_CONNECT
|
|
except Exception:
|
|
_LOGGER.exception("Unexpected exception")
|
|
return ERROR_UNKNOWN
|
|
|
|
self._model = connection.call_action("DeviceInfo:1", "GetInfo")["NewModelName"]
|
|
|
|
if (
|
|
"X_AVM-DE_UPnP1" in connection.services
|
|
and not connection.call_action("X_AVM-DE_UPnP1", "GetInfo")["NewEnable"]
|
|
):
|
|
return ERROR_UPNP_NOT_CONFIGURED
|
|
|
|
return None
|
|
|
|
async def async_check_configured_entry(self) -> ConfigEntry | None:
|
|
"""Check if entry is configured."""
|
|
current_host = await self.hass.async_add_executor_job(
|
|
socket.gethostbyname, self._host
|
|
)
|
|
|
|
for entry in self._async_current_entries(include_ignore=False):
|
|
entry_host = await self.hass.async_add_executor_job(
|
|
socket.gethostbyname, entry.data[CONF_HOST]
|
|
)
|
|
if entry_host == current_host:
|
|
return entry
|
|
return None
|
|
|
|
@callback
|
|
def _async_create_entry(self) -> ConfigFlowResult:
|
|
"""Async create flow handler entry."""
|
|
return self.async_create_entry(
|
|
title=self._name,
|
|
data={
|
|
CONF_HOST: self._host,
|
|
CONF_PASSWORD: self._password,
|
|
CONF_PORT: self._port,
|
|
CONF_USERNAME: self._username,
|
|
CONF_SSL: self._use_tls,
|
|
},
|
|
options={
|
|
CONF_CONSIDER_HOME: DEFAULT_CONSIDER_HOME.total_seconds(),
|
|
CONF_OLD_DISCOVERY: DEFAULT_CONF_OLD_DISCOVERY,
|
|
},
|
|
)
|
|
|
|
def _determine_port(self, user_input: dict[str, Any]) -> int:
|
|
"""Determine port from user_input."""
|
|
if port := user_input.get(CONF_PORT):
|
|
return int(port)
|
|
return DEFAULT_HTTPS_PORT if user_input[CONF_SSL] else DEFAULT_HTTP_PORT
|
|
|
|
async def async_step_ssdp(
|
|
self, discovery_info: ssdp.SsdpServiceInfo
|
|
) -> ConfigFlowResult:
|
|
"""Handle a flow initialized by discovery."""
|
|
ssdp_location: ParseResult = urlparse(discovery_info.ssdp_location or "")
|
|
host = ssdp_location.hostname
|
|
if not host or ipaddress.ip_address(host).is_link_local:
|
|
return self.async_abort(reason="ignore_ip6_link_local")
|
|
|
|
self._host = host
|
|
self._name = (
|
|
discovery_info.upnp.get(ssdp.ATTR_UPNP_FRIENDLY_NAME)
|
|
or discovery_info.upnp[ssdp.ATTR_UPNP_MODEL_NAME]
|
|
)
|
|
|
|
uuid: str | None
|
|
if uuid := discovery_info.upnp.get(ssdp.ATTR_UPNP_UDN):
|
|
if uuid.startswith("uuid:"):
|
|
uuid = uuid[5:]
|
|
await self.async_set_unique_id(uuid)
|
|
self._abort_if_unique_id_configured({CONF_HOST: self._host})
|
|
|
|
if self.hass.config_entries.flow.async_has_matching_flow(self):
|
|
return self.async_abort(reason="already_in_progress")
|
|
|
|
if entry := await self.async_check_configured_entry():
|
|
if uuid and not entry.unique_id:
|
|
self.hass.config_entries.async_update_entry(entry, unique_id=uuid)
|
|
return self.async_abort(reason="already_configured")
|
|
|
|
self.context.update(
|
|
{
|
|
"title_placeholders": {"name": self._name.replace("FRITZ!Box ", "")},
|
|
"configuration_url": f"http://{self._host}",
|
|
}
|
|
)
|
|
|
|
return await self.async_step_confirm()
|
|
|
|
def is_matching(self, other_flow: Self) -> bool:
|
|
"""Return True if other_flow is matching this flow."""
|
|
return other_flow._host == self._host # noqa: SLF001
|
|
|
|
async def async_step_confirm(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Handle user-confirmation of discovered node."""
|
|
if user_input is None:
|
|
return self._show_setup_form_confirm()
|
|
|
|
errors = {}
|
|
|
|
self._username = user_input[CONF_USERNAME]
|
|
self._password = user_input[CONF_PASSWORD]
|
|
self._use_tls = user_input[CONF_SSL]
|
|
self._port = self._determine_port(user_input)
|
|
|
|
error = await self.async_fritz_tools_init()
|
|
|
|
if error:
|
|
errors["base"] = error
|
|
return self._show_setup_form_confirm(errors)
|
|
|
|
return self._async_create_entry()
|
|
|
|
def _show_setup_form_init(
|
|
self, errors: dict[str, str] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Show the setup form to the user."""
|
|
|
|
advanced_data_schema: VolDictType = {}
|
|
if self.show_advanced_options:
|
|
advanced_data_schema = {
|
|
vol.Optional(CONF_PORT): vol.Coerce(int),
|
|
}
|
|
|
|
return self.async_show_form(
|
|
step_id="user",
|
|
data_schema=vol.Schema(
|
|
{
|
|
vol.Optional(CONF_HOST, default=DEFAULT_HOST): str,
|
|
**advanced_data_schema,
|
|
vol.Required(CONF_USERNAME): str,
|
|
vol.Required(CONF_PASSWORD): str,
|
|
vol.Optional(CONF_SSL, default=DEFAULT_SSL): bool,
|
|
}
|
|
),
|
|
errors=errors or {},
|
|
)
|
|
|
|
def _show_setup_form_confirm(
|
|
self, errors: dict[str, str] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Show the setup form to the user."""
|
|
return self.async_show_form(
|
|
step_id="confirm",
|
|
data_schema=vol.Schema(
|
|
{
|
|
vol.Required(CONF_USERNAME): str,
|
|
vol.Required(CONF_PASSWORD): str,
|
|
vol.Optional(CONF_SSL, default=DEFAULT_SSL): bool,
|
|
}
|
|
),
|
|
description_placeholders={"name": self._name},
|
|
errors=errors or {},
|
|
)
|
|
|
|
async def async_step_user(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Handle a flow initiated by the user."""
|
|
if user_input is None:
|
|
return self._show_setup_form_init()
|
|
self._host = user_input[CONF_HOST]
|
|
self._username = user_input[CONF_USERNAME]
|
|
self._password = user_input[CONF_PASSWORD]
|
|
self._use_tls = user_input[CONF_SSL]
|
|
|
|
self._port = self._determine_port(user_input)
|
|
|
|
if not (error := await self.async_fritz_tools_init()):
|
|
self._name = self._model
|
|
|
|
if await self.async_check_configured_entry():
|
|
error = "already_configured"
|
|
|
|
if error:
|
|
return self._show_setup_form_init({"base": error})
|
|
|
|
return self._async_create_entry()
|
|
|
|
async def async_step_reauth(
|
|
self, entry_data: Mapping[str, Any]
|
|
) -> ConfigFlowResult:
|
|
"""Handle flow upon an API authentication error."""
|
|
self._host = entry_data[CONF_HOST]
|
|
self._port = entry_data[CONF_PORT]
|
|
self._username = entry_data[CONF_USERNAME]
|
|
self._password = entry_data[CONF_PASSWORD]
|
|
self._use_tls = entry_data[CONF_SSL]
|
|
|
|
return await self.async_step_reauth_confirm()
|
|
|
|
def _show_setup_form_reauth_confirm(
|
|
self, user_input: dict[str, Any], errors: dict[str, str] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Show the reauth form to the user."""
|
|
default_username = user_input.get(CONF_USERNAME)
|
|
return self.async_show_form(
|
|
step_id="reauth_confirm",
|
|
data_schema=vol.Schema(
|
|
{
|
|
vol.Required(CONF_USERNAME, default=default_username): str,
|
|
vol.Required(CONF_PASSWORD): str,
|
|
}
|
|
),
|
|
description_placeholders={"host": self._host},
|
|
errors=errors or {},
|
|
)
|
|
|
|
async def async_step_reauth_confirm(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Dialog that informs the user that reauth is required."""
|
|
if user_input is None:
|
|
return self._show_setup_form_reauth_confirm(
|
|
user_input={CONF_USERNAME: self._username}
|
|
)
|
|
|
|
self._username = user_input[CONF_USERNAME]
|
|
self._password = user_input[CONF_PASSWORD]
|
|
|
|
if error := await self.async_fritz_tools_init():
|
|
return self._show_setup_form_reauth_confirm(
|
|
user_input=user_input, errors={"base": error}
|
|
)
|
|
|
|
return self.async_update_reload_and_abort(
|
|
self._get_reauth_entry(),
|
|
data={
|
|
CONF_HOST: self._host,
|
|
CONF_PASSWORD: self._password,
|
|
CONF_PORT: self._port,
|
|
CONF_USERNAME: self._username,
|
|
CONF_SSL: self._use_tls,
|
|
},
|
|
)
|
|
|
|
def _show_setup_form_reconfigure(
|
|
self, user_input: dict[str, Any], errors: dict[str, str] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Show the reconfigure form to the user."""
|
|
advanced_data_schema: VolDictType = {}
|
|
if self.show_advanced_options:
|
|
advanced_data_schema = {
|
|
vol.Optional(CONF_PORT, default=user_input[CONF_PORT]): vol.Coerce(int),
|
|
}
|
|
|
|
return self.async_show_form(
|
|
step_id="reconfigure",
|
|
data_schema=vol.Schema(
|
|
{
|
|
vol.Required(CONF_HOST, default=user_input[CONF_HOST]): str,
|
|
**advanced_data_schema,
|
|
vol.Required(CONF_SSL, default=user_input[CONF_SSL]): bool,
|
|
}
|
|
),
|
|
description_placeholders={"host": user_input[CONF_HOST]},
|
|
errors=errors or {},
|
|
)
|
|
|
|
async def async_step_reconfigure(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Handle reconfigure flow."""
|
|
if user_input is None:
|
|
reconfigure_entry_data = self._get_reconfigure_entry().data
|
|
return self._show_setup_form_reconfigure(
|
|
{
|
|
CONF_HOST: reconfigure_entry_data[CONF_HOST],
|
|
CONF_PORT: reconfigure_entry_data[CONF_PORT],
|
|
CONF_SSL: reconfigure_entry_data.get(CONF_SSL, DEFAULT_SSL),
|
|
}
|
|
)
|
|
|
|
self._host = user_input[CONF_HOST]
|
|
self._use_tls = user_input[CONF_SSL]
|
|
self._port = self._determine_port(user_input)
|
|
|
|
reconfigure_entry = self._get_reconfigure_entry()
|
|
self._username = reconfigure_entry.data[CONF_USERNAME]
|
|
self._password = reconfigure_entry.data[CONF_PASSWORD]
|
|
if error := await self.async_fritz_tools_init():
|
|
return self._show_setup_form_reconfigure(
|
|
user_input={**user_input, CONF_PORT: self._port}, errors={"base": error}
|
|
)
|
|
|
|
return self.async_update_reload_and_abort(
|
|
reconfigure_entry,
|
|
data_updates={
|
|
CONF_HOST: self._host,
|
|
CONF_PORT: self._port,
|
|
CONF_SSL: self._use_tls,
|
|
},
|
|
)
|
|
|
|
|
|
class FritzBoxToolsOptionsFlowHandler(OptionsFlow):
|
|
"""Handle an options 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)
|
|
|
|
options = self.config_entry.options
|
|
data_schema = vol.Schema(
|
|
{
|
|
vol.Optional(
|
|
CONF_CONSIDER_HOME,
|
|
default=options.get(
|
|
CONF_CONSIDER_HOME, DEFAULT_CONSIDER_HOME.total_seconds()
|
|
),
|
|
): vol.All(vol.Coerce(int), vol.Clamp(min=0, max=900)),
|
|
vol.Optional(
|
|
CONF_OLD_DISCOVERY,
|
|
default=options.get(CONF_OLD_DISCOVERY, DEFAULT_CONF_OLD_DISCOVERY),
|
|
): bool,
|
|
}
|
|
)
|
|
return self.async_show_form(step_id="init", data_schema=data_schema)
|