org.whispersystems.libsignal.fingerprint

Class NumericFingerprintGenerator

java.lang.Object

org.whispersystems.libsignal.fingerprint.NumericFingerprintGenerator

All Implemented Interfaces:

FingerprintGenerator

public class NumericFingerprintGenerator
extends java.lang.Object
implements FingerprintGenerator

Constructor Summary

Constructors

Constructor and Description
NumericFingerprintGenerator(int iterations) Construct a fingerprint generator for 60 digit numerics.

Method Summary

Modifier and Type	Method and Description
Fingerprint	createFor(int version, byte[] localStableIdentifier, IdentityKey localIdentityKey, byte[] remoteStableIdentifier, IdentityKey remoteIdentityKey) Generate a scannable and displayable fingerprint.
Fingerprint	createFor(int version, byte[] localStableIdentifier, java.util.List<IdentityKey> localIdentityKeys, byte[] remoteStableIdentifier, java.util.List<IdentityKey> remoteIdentityKeys) Generate a scannable and displayable fingerprint for logical identities that have multiple physical keys.

Methods inherited from class java.lang.Object

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

Constructor Detail

NumericFingerprintGenerator

public NumericFingerprintGenerator(int iterations)

Construct a fingerprint generator for 60 digit numerics.

Parameters:

iterations - The number of internal iterations to perform in the process of generating a fingerprint. This needs to be constant, and synchronized across all clients. The higher the iteration count, the higher the security level: - 1024 ~ 109.7 bits - 1400 > 110 bits - 5200 > 112 bits

Method Detail

createFor

public Fingerprint createFor(int version,
                             byte[] localStableIdentifier,
                             IdentityKey localIdentityKey,
                             byte[] remoteStableIdentifier,
                             IdentityKey remoteIdentityKey)

Generate a scannable and displayable fingerprint.

Specified by:

createFor in interface FingerprintGenerator

Parameters:

version - The version of fingerprint you are generating.

localStableIdentifier - The client's "stable" identifier.

localIdentityKey - The client's identity key.

remoteStableIdentifier - The remote party's "stable" identifier.

remoteIdentityKey - The remote party's identity key.

Returns:

A unique fingerprint for this conversation.

createFor

public Fingerprint createFor(int version,
                             byte[] localStableIdentifier,
                             java.util.List<IdentityKey> localIdentityKeys,
                             byte[] remoteStableIdentifier,
                             java.util.List<IdentityKey> remoteIdentityKeys)

Generate a scannable and displayable fingerprint for logical identities that have multiple physical keys. Do not trust the output of this unless you've been through the device consistency process for the provided localIdentityKeys.

Specified by:

createFor in interface FingerprintGenerator

Parameters:

version - The version of fingerprint you are generating.

localStableIdentifier - The client's "stable" identifier.

localIdentityKeys - The client's collection of physical identity keys.

remoteStableIdentifier - The remote party's "stable" identifier.

remoteIdentityKeys - The remote party's collection of physical identity key.

Returns:

A unique fingerprint for this conversation.