async def enable_cloud_password(
self,
password: str,
hint: str = "",
email: str = None
) -> bool:
"""Enable the Two-Step Verification security feature (Cloud Password) on your account.
This password will be asked when you log-in on a new device in addition to the SMS code.
Parameters:
password (``str``):
Your password.
hint (``str``, *optional*):
A password hint.
email (``str``, *optional*):
Recovery e-mail.
Returns:
``bool``: True on success.
Raises:
ValueError: In case there is already a cloud password enabled.
Example:
.. code-block:: python
# Enable password without hint and email
app.enable_cloud_password("password")
# Enable password with hint and without email
app.enable_cloud_password("password", hint="hint")
# Enable password with hint and email
app.enable_cloud_password("password", hint="hint", email="*****@*****.**")
"""
r = await self.send(raw.functions.account.GetPassword())
if r.has_password:
raise ValueError("There is already a cloud password enabled")
r.new_algo.salt1 += os.urandom(32)
new_hash = btoi(compute_password_hash(r.new_algo, password))
new_hash = itob(pow(r.new_algo.g, new_hash, btoi(r.new_algo.p)))
await self.send(
raw.functions.account.UpdatePasswordSettings(
password=raw.types.InputCheckPasswordEmpty(),
new_settings=raw.types.account.PasswordInputSettings(
new_algo=r.new_algo,
new_password_hash=new_hash,
hint=hint,
email=email
)
)
)
return True
async def change_cloud_password(
self,
current_password: str,
new_password: str,
new_hint: str = ""
) -> bool:
"""Change your Two-Step Verification password (Cloud Password) with a new one.
Parameters:
current_password (``str``):
Your current password.
new_password (``str``):
Your new password.
new_hint (``str``, *optional*):
A new password hint.
Returns:
``bool``: True on success.
Raises:
ValueError: In case there is no cloud password to change.
Example:
.. code-block:: python
# Change password only
app.change_cloud_password("current_password", "new_password")
# Change password and hint
app.change_cloud_password("current_password", "new_password", new_hint="hint")
"""
r = await self.send(raw.functions.account.GetPassword())
if not r.has_password:
raise ValueError("There is no cloud password to change")
r.new_algo.salt1 += os.urandom(32)
new_hash = btoi(compute_password_hash(r.new_algo, new_password))
new_hash = itob(pow(r.new_algo.g, new_hash, btoi(r.new_algo.p)))
await self.send(
raw.functions.account.UpdatePasswordSettings(
password=compute_password_check(r, current_password),
new_settings=raw.types.account.PasswordInputSettings(
new_algo=r.new_algo,
new_password_hash=new_hash,
hint=new_hint
)
)
)
return True