Class: QgsCredentials¶
-
class
qgis.core.
QgsCredentials
¶ Bases:
sip.wrapper
Constructor for QgsCredentials.
Interface for requesting credentials in QGIS in GUI independent way. This class provides abstraction of a dialog for requesting credentials to the user. By default QgsCredentials will be used if not overridden with other credential creator function.
QGIS application uses QgsCredentialDialog class for displaying a dialog to the user.
Caller can use the mutex to synchronize authentications to avoid requesting credentials for the same resource several times.
Object deletes itself when it’s not needed anymore. Children should use signal destroyed() to be notified of the deletion
Enums
Methods
Requests credentials for the specified
realm
.retrieves instance
Lock the instance against access from multiple threads.
Returns pointer to mutex
Stores the correct
username
andpassword
for the specifiedrealm
.request a password
request a master password
register instance
Unlock the instance after being locked.
Signals
Attributes
-
get
(self, realm: str, username: str, password: str, message: str = '') → Tuple[bool, str, str]¶ Requests credentials for the specified
realm
.If existing credentials exist for the given
realm
, these will be returned. Otherwise the credential handler will prompt for the correct username and password.The retrieved or user-entered details will be stored in
username
andpassword
.Optionally, a specific
message
can be used to advise users of the context for the credentials request.Note
This method will not automatically store the newly obtained credentials. Callers must manually call put() after verifying that the obtained credentials are correct.
See also
-
getMasterPassword
(self, password: str, stored: bool = False) → Tuple[bool, str]¶
-
instance
() → QgsCredentials¶ retrieves instance
-
lock
(self)¶ Lock the instance against access from multiple threads. This does not really lock access to get/put methds, it will just prevent other threads to lock the instance and continue the execution. When the class is used from non-GUI threads, they should call lock() before the get/put calls to avoid race conditions.
New in version 2.4.
-
mutex
(self) → QMutex¶ Returns pointer to mutex
New in version 2.4.
-
put
(self, realm: str, username: str, password: str)¶ Stores the correct
username
andpassword
for the specifiedrealm
.These values will be used for all future calls to get() for the same
realm
, without requesting users to re-enter them. It is the caller’s responsibility to ensure that only validusername
andpassword
combinations are used with this method.See also
-
request
(self, realm: str, username: str, password: str, message: str = '') → Tuple[bool, str, str]¶ request a password
-
requestMasterPassword
(self, password: str, stored: bool = False) → Tuple[bool, str]¶ request a master password
-
setInstance
(self, instance: QgsCredentials)¶ register instance
-
unlock
(self)¶ Unlock the instance after being locked.
New in version 2.4.
-