Summary: Nested Classes | Constants | Methods | Inherited Methods

E2eeContactKeysManager

Kotlin |Java

public final class E2eeContactKeysManager
extends Object

java.lang.Object
↳	android.provider.E2eeContactKeysManager

E2eeContactKeysManager provides access to the provider of end-to-end encryption contact keys. It manages two types of keys - E2eeContactKey and E2eeSelfKey.

A E2eeContactKey is a public key associated with a contact. It's used to end-to-end encrypt the communications between a user and the contact. This API allows operations on E2eeContactKeys to insert/update, remove, change the verification state, and retrieving keys (either created by or visible to the caller app).
A E2eeSelfKey is a key for this device, so the key represents the owner of the device. This API allows operations on E2eeSelfKeys to insert/update, remove, and retrieving self keys (either created by or visible to the caller app).

Keys are uniquely identified by:

ownerPackageName - package name of an app that the key belongs to.
deviceId - an app-specified identifier for the device, defined by the app. Within that app, the deviceID should be unique among devices belonging to that user.
accountId - the app-specified identifier for the account for which the contact key can be used. Using different account IDs allows for multiple key entries representing the same user. For most apps this would be a phone number.

Contact keys also use lookupKey which is an opaque value used to identify a contact in ContactsProvider.

Summary

Nested classes
`class`	`E2eeContactKeysManager.E2eeContactKey` A parcelable class encapsulating other users' end to end encrypted contact key.
`class`	`E2eeContactKeysManager.E2eeSelfKey` A parcelable class encapsulating self end to end encrypted contact key.

Constants
`int`	`VERIFICATION_STATE_UNVERIFIED` Unverified state of a contact end to end encrypted key.
`int`	`VERIFICATION_STATE_VERIFICATION_FAILED` Failed verification state of a contact end to end encrypted key.
`int`	`VERIFICATION_STATE_VERIFIED` Verified state of a contact end to end encrypted key.

Public methods
`List<E2eeContactKeysManager.E2eeContactKey>`	`getAllE2eeContactKeys(String lookupKey)` Retrieves all end-to-end encryption contact key entries that belong to apps visible to the caller.
`List<E2eeContactKeysManager.E2eeSelfKey>`	`getAllE2eeSelfKeys()` Returns all end-to-end encryption self key entries that belong to apps visible to the caller.
`E2eeContactKeysManager.E2eeContactKey`	`getE2eeContactKey(String lookupKey, String deviceId, String accountId)` Retrieves an end-to-end encryption contact key entry given the lookup key, device ID, accountId and inferred caller package name.
`E2eeContactKeysManager.E2eeSelfKey`	`getE2eeSelfKey(String deviceId, String accountId)` Returns an end-to-end encryption self key entry given the deviceId and the inferred package name of the caller.
`static int`	`getMaxKeySizeBytes()` Maximum size of an end-to-end encryption contact key.
`List<E2eeContactKeysManager.E2eeContactKey>`	`getOwnerE2eeContactKeys(String lookupKey)` Retrieves all end-to-end encryption contact key entries for a given lookupKey that belong to the caller app.
`List<E2eeContactKeysManager.E2eeSelfKey>`	`getOwnerE2eeSelfKeys()` Returns all end-to-end encryption self key entries that are owned by the caller app.
`boolean`	`removeE2eeContactKey(String lookupKey, String deviceId, String accountId)` Removes an end-to-end encryption contact key entry that belongs to the caller app.
`boolean`	`removeE2eeSelfKey(String deviceId, String accountId)` Removes an end-to-end encryption self key entry given the deviceId and the inferred package name of the caller.
`boolean`	`updateE2eeContactKeyLocalVerificationState(String lookupKey, String deviceId, String accountId, int localVerificationState)` Updates an end-to-end encryption contact key entry's local verification state that belongs to the caller app.
`boolean`	`updateE2eeContactKeyRemoteVerificationState(String lookupKey, String deviceId, String accountId, int remoteVerificationState)` Updates an end-to-end encryption contact key entry's remote verification state that belongs to the caller app.
`boolean`	`updateE2eeSelfKeyRemoteVerificationState(String deviceId, String accountId, int remoteVerificationState)` Updates an end-to-end encryption self key entry's remote verification state.
`void`	`updateOrInsertE2eeContactKey(String lookupKey, String deviceId, String accountId, byte[] keyValue)` Inserts a new entry into the end-to-end encryption contact keys table or updates one if it already exists.
`boolean`	`updateOrInsertE2eeSelfKey(String deviceId, String accountId, byte[] keyValue)` Inserts a new entry into the end-to-end encryption self keys table or updates one if it already exists.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

VERIFICATION_STATE_UNVERIFIED

Added in Android VanillaIceCream

public static final int VERIFICATION_STATE_UNVERIFIED

Unverified state of a contact end to end encrypted key.

Constant Value: 0 (0x00000000)

VERIFICATION_STATE_VERIFICATION_FAILED

Added in Android VanillaIceCream

public static final int VERIFICATION_STATE_VERIFICATION_FAILED

Failed verification state of a contact end to end encrypted key.

Constant Value: 1 (0x00000001)

VERIFICATION_STATE_VERIFIED

Added in Android VanillaIceCream

public static final int VERIFICATION_STATE_VERIFIED

Verified state of a contact end to end encrypted key.

Constant Value: 2 (0x00000002)

Public methods

getAllE2eeContactKeys

Added in Android VanillaIceCream

public List<E2eeContactKeysManager.E2eeContactKey> getAllE2eeContactKeys (String lookupKey)

Retrieves all end-to-end encryption contact key entries that belong to apps visible to the caller. The keys will be stripped of deviceId, timeUpdated and keyValue data.
Requires Manifest.permission.READ_CONTACTS

Parameters
`lookupKey`	`String`: the value that references the contact This value cannot be `null`.

Returns
`List<E2eeContactKeysManager.E2eeContactKey>`	a list of `E2eeContactKey` objects containing the contact key information, or an empty list if no keys are found. This value cannot be `null`.

getAllE2eeSelfKeys

Added in Android VanillaIceCream

public List<E2eeContactKeysManager.E2eeSelfKey> getAllE2eeSelfKeys ()

Returns all end-to-end encryption self key entries that belong to apps visible to the caller. The keys will be stripped of deviceId, timeUpdated and keyValue data.
Requires Manifest.permission.READ_CONTACTS

Returns
`List<E2eeContactKeysManager.E2eeSelfKey>`	a list of `E2eeSelfKey` objects containing the end-to-end encryption self key information, or an empty list if no self keys are found. This value cannot be `null`.

getE2eeContactKey

Added in Android VanillaIceCream

public E2eeContactKeysManager.E2eeContactKey getE2eeContactKey (String lookupKey, 
                String deviceId, 
                String accountId)

Retrieves an end-to-end encryption contact key entry given the lookup key, device ID, accountId and inferred caller package name.
Requires Manifest.permission.READ_CONTACTS

Parameters
`lookupKey`	`String`: the value that references the contact This value cannot be `null`.
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.

Returns
`E2eeContactKeysManager.E2eeContactKey`	a `E2eeContactKey` object containing the contact key information, or null if no contact key is found.

getE2eeSelfKey

Added in Android VanillaIceCream

public E2eeContactKeysManager.E2eeSelfKey getE2eeSelfKey (String deviceId, 
                String accountId)

Returns an end-to-end encryption self key entry given the deviceId and the inferred package name of the caller.
Requires Manifest.permission.READ_CONTACTS

Parameters
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.

Returns
`E2eeContactKeysManager.E2eeSelfKey`	a `E2eeSelfKey` object containing the end-to-end encryption self key information, or null if no self key is found.

getMaxKeySizeBytes

Added in Android VanillaIceCream

public static int getMaxKeySizeBytes ()

Maximum size of an end-to-end encryption contact key.

Returns
`int`

getOwnerE2eeContactKeys

Added in Android VanillaIceCream

public List<E2eeContactKeysManager.E2eeContactKey> getOwnerE2eeContactKeys (String lookupKey)

Retrieves all end-to-end encryption contact key entries for a given lookupKey that belong to the caller app.
Requires Manifest.permission.READ_CONTACTS

Parameters
`lookupKey`	`String`: the value that references the contact This value cannot be `null`.

Returns
`List<E2eeContactKeysManager.E2eeContactKey>`	a list of `E2eeContactKey` objects containing the end-to-end encryption contact key information, or an empty list if no keys are found. This value cannot be `null`.

getOwnerE2eeSelfKeys

Added in Android VanillaIceCream

public List<E2eeContactKeysManager.E2eeSelfKey> getOwnerE2eeSelfKeys ()

Returns all end-to-end encryption self key entries that are owned by the caller app.
Requires Manifest.permission.READ_CONTACTS

Returns
`List<E2eeContactKeysManager.E2eeSelfKey>`	a list of `E2eeSelfKey` objects containing the end-to-end encryption self key information, or an empty list if no self keys are found. This value cannot be `null`.

removeE2eeContactKey

Added in Android VanillaIceCream

public boolean removeE2eeContactKey (String lookupKey, 
                String deviceId, 
                String accountId)

Removes an end-to-end encryption contact key entry that belongs to the caller app.
Requires Manifest.permission.WRITE_CONTACTS

Parameters
`lookupKey`	`String`: the value that references the contact This value cannot be `null`.
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.

Returns
`boolean`	true if the entry was removed, false otherwise.

removeE2eeSelfKey

Added in Android VanillaIceCream

public boolean removeE2eeSelfKey (String deviceId, 
                String accountId)

Removes an end-to-end encryption self key entry given the deviceId and the inferred package name of the caller.
Requires Manifest.permission.WRITE_CONTACTS

Parameters
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.

Returns
`boolean`	true if the entry was removed, false otherwise.

updateE2eeContactKeyLocalVerificationState

Added in Android VanillaIceCream

public boolean updateE2eeContactKeyLocalVerificationState (String lookupKey, 
                String deviceId, 
                String accountId, 
                int localVerificationState)

Updates an end-to-end encryption contact key entry's local verification state that belongs to the caller app.
Requires Manifest.permission.WRITE_CONTACTS

Parameters
`lookupKey`	`String`: the value that references the contact This value cannot be `null`.
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.
`localVerificationState`	`int`: the new local verification state Value is `VERIFICATION_STATE_UNVERIFIED`, `VERIFICATION_STATE_VERIFICATION_FAILED`, or `VERIFICATION_STATE_VERIFIED`

Returns
`boolean`	true if the entry was updated, false otherwise.

updateE2eeContactKeyRemoteVerificationState

Added in Android VanillaIceCream

public boolean updateE2eeContactKeyRemoteVerificationState (String lookupKey, 
                String deviceId, 
                String accountId, 
                int remoteVerificationState)

Updates an end-to-end encryption contact key entry's remote verification state that belongs to the caller app.
Requires Manifest.permission.WRITE_CONTACTS

Parameters
`lookupKey`	`String`: the value that references the contact This value cannot be `null`.
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.
`remoteVerificationState`	`int`: the new remote verification state Value is `VERIFICATION_STATE_UNVERIFIED`, `VERIFICATION_STATE_VERIFICATION_FAILED`, or `VERIFICATION_STATE_VERIFIED`

Returns
`boolean`	true if the entry was updated, false otherwise.

updateE2eeSelfKeyRemoteVerificationState

Added in Android VanillaIceCream

public boolean updateE2eeSelfKeyRemoteVerificationState (String deviceId, 
                String accountId, 
                int remoteVerificationState)

Updates an end-to-end encryption self key entry's remote verification state.
Requires Manifest.permission.WRITE_CONTACTS

Parameters
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.
`remoteVerificationState`	`int`: the new remote verification state Value is `VERIFICATION_STATE_UNVERIFIED`, `VERIFICATION_STATE_VERIFICATION_FAILED`, or `VERIFICATION_STATE_VERIFIED`

Returns
`boolean`	true if the entry was updated, false otherwise.

updateOrInsertE2eeContactKey

Added in Android VanillaIceCream

public void updateOrInsertE2eeContactKey (String lookupKey, 
                String deviceId, 
                String accountId, 
                byte[] keyValue)

Inserts a new entry into the end-to-end encryption contact keys table or updates one if it already exists. The inserted/updated end-to-end encryption contact key is owned by the caller app.
Requires Manifest.permission.WRITE_CONTACTS

Parameters
`lookupKey`	`String`: value that references the contact This value cannot be `null`.
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.
`keyValue`	`byte`: the raw bytes for the key (max size is `getMaxKeySizeBytes()` bytes) This value cannot be `null`.

updateOrInsertE2eeSelfKey

Added in Android VanillaIceCream

public boolean updateOrInsertE2eeSelfKey (String deviceId, 
                String accountId, 
                byte[] keyValue)

Inserts a new entry into the end-to-end encryption self keys table or updates one if it already exists.
Requires Manifest.permission.WRITE_CONTACTS

Parameters
`deviceId`	`String`: an app-specified identifier for the device This value cannot be `null`.
`accountId`	`String`: an app-specified identifier for the account This value cannot be `null`.
`keyValue`	`byte`: the raw bytes for the key (max size is `getMaxKeySizeBytes()` bytes) This value cannot be `null`.

Returns
`boolean`	true if the entry was added or updated, false otherwise.

E2eeContactKeysManager

Summary

Nested classes

Constants

Public methods

Inherited methods

Constants

VERIFICATION_STATE_UNVERIFIED

VERIFICATION_STATE_VERIFICATION_FAILED

VERIFICATION_STATE_VERIFIED

Public methods

getAllE2eeContactKeys

getAllE2eeSelfKeys

getE2eeContactKey

getE2eeSelfKey

getMaxKeySizeBytes

getOwnerE2eeContactKeys

getOwnerE2eeSelfKeys

removeE2eeContactKey

removeE2eeSelfKey

updateE2eeContactKeyLocalVerificationState

updateE2eeContactKeyRemoteVerificationState

updateE2eeSelfKeyRemoteVerificationState

updateOrInsertE2eeContactKey

updateOrInsertE2eeSelfKey