Package ghidra.formats.gfilesystem.crypto

Class CachedPasswordProvider

java.lang.Object

ghidra.formats.gfilesystem.crypto.CachedPasswordProvider

All Implemented Interfaces:

CryptoProvider, PasswordProvider

public class CachedPasswordProvider
extends Object
implements PasswordProvider

Caches passwords used to unlock a file.

Threadsafe.

Nested Class Summary

Nested classes/interfaces inherited from interface ghidra.formats.gfilesystem.crypto.CryptoProvider

CryptoProvider.Session

Constructor Summary

Constructors

Change	Constructor	Description
	CachedPasswordProvider()

Method Summary

Change	Modifier and Type	Method	Description
NEW	void	addPassword(FSRL fsrl, Password password)	Adds a password / file combo to the cache.
	void	clearCache()	Remove all cached information.
	int	getCount()	Returns the number of items in cache
MODIFIED	Iterator<Password>	getPasswordsFor(FSRL fsrl, String prompt, CryptoProvider.Session session)	Returns a sequence of passwords (ordered by quality) that may apply to the specified file.
REMOVED	void	addPassword(FSRL fsrl, PasswordValue password)	Removed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CachedPasswordProvider

public CachedPasswordProvider()

Method Details

addPassword NEW

public void addPassword(FSRL fsrl,
 Password password)

Adds a password / file combo to the cache.

Parameters:

fsrl - FSRL file

password - password to unlock the file. Specified Password is only copied, clearing is still callers responsibility

clearCache

public void clearCache()

Remove all cached information.

getCount

public int getCount()

Returns the number of items in cache

Returns:

number of items in cache

getPasswordsFor MODIFIED

public Iterator<Password> getPasswordsFor(FSRL fsrl,
 String prompt,
 CryptoProvider.Session session)

return type: Iterator → Iterator

-java.util.Iterator<ghidra.formats.gfilesystem.crypto.PasswordValue> getPasswordsFor(ghidra.formats.gfilesystem.FSRL fsrl, java.lang.String prompt, ghidra.formats.gfilesystem.crypto.CryptoProvider.Session session)

+java.util.Iterator<ghidra.framework.generic.auth.Password> getPasswordsFor(ghidra.formats.gfilesystem.FSRL fsrl, java.lang.String prompt, ghidra.formats.gfilesystem.crypto.CryptoProvider.Session session)

Description copied from interface: PasswordProvider

Returns a sequence of passwords (ordered by quality) that may apply to the specified file.

Specified by:

getPasswordsFor in interface PasswordProvider

Parameters:

fsrl - FSRL path to the password protected file

prompt - optional prompt that may be displayed to a user

session - a place to hold state values that persist across related queries

Returns:

Iterator of possible passwords