Class: 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

Class Hierarchy

Subclasses

QgsCredentialsConsole	Implementation of credentials interface for the console
QgsCredentialsNone	Default implementation of credentials interface
QgsCredentialDialog	A generic dialog for requesting credentials

Methods

get	Requests credentials for the specified realm.
getMasterPassword
lock	Lock the instance against access from multiple threads.
mutex	Returns pointer to mutex
put	Stores the correct username and password for the specified realm.
request	request a password
requestMasterPassword	request a master password
setInstance	register instance
unlock	Unlock the instance after being locked.

Static Methods

instance

retrieves instance

class qgis.core.QgsCredentials

Bases: object

get(self, realm: str | None, username: str | None, password: str | None, message: str | None = '', requestCredentials: bool = True)

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 if requestCredentials is set to True.

The retrieved or user-entered details will be stored in username and password.

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

put()

Parameters:

• realm (Optional[str])

• username (Optional[str])

• password (Optional[str])

• message (Optional[str] = '')

• requestCredentials (bool = True) -> (bool)

getMasterPassword(self, password: str | None, stored: bool = False)

Parameters:

• password (Optional[str])

• stored (bool = False) -> (bool)

static instance() → QgsCredentials | None

retrieves instance

Return type:

Optional[QgsCredentials]

lock(self)

Lock the instance against access from multiple threads. This does not really lock access to get/put methods, 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.

mutex(self) → QMutex | None

Returns pointer to mutex

Return type:

Optional[QMutex]

put(self, realm: str | None, username: str | None, password: str | None)

Stores the correct username and password for the specified realm.

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 valid username and password combinations are used with this method.

See also

get()

Parameters:

• realm (Optional[str])

• username (Optional[str])

• password (Optional[str])

request(self, realm: str | None, username: str | None, password: str | None, message: str | None = '')

request a password

Parameters:

• realm (Optional[str])

• username (Optional[str])

• password (Optional[str])

• message (Optional[str] = '') -> (bool)

requestMasterPassword(self, password: str | None, stored: bool = False)

request a master password

Parameters:

• password (Optional[str])

• stored (bool = False) -> (bool)

setInstance(self, instance: QgsCredentials | None)

register instance

Parameters:

instance (Optional[QgsCredentials])

unlock(self)

Unlock the instance after being locked.