async def remove_cloud_password(self, password: str) -> bool:
"""Turn off the Two-Step Verification security feature (Cloud Password) on your account.
Parameters:
password (``str``):
Your current password.
Returns:
``bool``: True on success.
Raises:
ValueError: In case there is no cloud password to remove.
Example:
.. code-block:: python
app.remove_cloud_password("password")
"""
r = await self.send(raw.functions.account.GetPassword())
if not r.has_password:
raise ValueError("There is no cloud password to remove")
await self.send(
raw.functions.account.UpdatePasswordSettings(
password=compute_password_check(r, password),
new_settings=raw.types.account.PasswordInputSettings(
new_algo=raw.types.PasswordKdfAlgoUnknown(),
new_password_hash=b"",
hint="")))
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
async def check_password(self, password: str) -> "types.User":
"""Check your Two-Step Verification password and log in.
Parameters:
password (``str``):
Your Two-Step Verification password.
Returns:
:obj:`~pyrogram.types.User`: On success, the authorized user is returned.
Raises:
BadRequest: In case the password is invalid.
"""
r = await self.send(
raw.functions.auth.CheckPassword(password=compute_password_check(
await self.send(raw.functions.account.GetPassword()),
password)))
await self.storage.user_id(r.user.id)
await self.storage.is_bot(False)
return types.User._parse(self, r.user)
