Package org.bouncycastle.mls

Class KeyScheduleEpoch

java.lang.Object

org.bouncycastle.mls.KeyScheduleEpoch

public class KeyScheduleEpoch
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	KeyScheduleEpoch.ExternalInitParams
static class	KeyScheduleEpoch.JoinSecrets
static class	KeyScheduleEpoch.PSKWithSecret

Field Summary

Fields

Modifier and Type	Field	Description
final Secret	confirmationKey
final Secret	encryptionSecret
final Secret	epochAuthenticator
final Secret	exporterSecret
final Secret	externalSecret
final GroupKeySet	groupKeySet
final Secret	initSecret
Secret	joinerSecret
Secret	membershipKey
final Secret	resumptionPSK
Secret	senderDataSecret

Constructor Summary

Constructors

Constructor	Description
KeyScheduleEpoch(MlsCipherSuite suite)
KeyScheduleEpoch(MlsCipherSuite suite, Secret initSecret, Secret senderDataSecret, Secret exporterSecret, Secret confirmationKey, Secret membershipKey, Secret resumptionPSK, Secret epochAuthenticator, Secret encryptionSecret, Secret externalSecret, org.bouncycastle.crypto.AsymmetricCipherKeyPair externalKeyPair, GroupKeySet groupKeySet, Secret joinerSecret)
KeyScheduleEpoch(MlsCipherSuite suite, TreeSize treeSize, Secret epochSecret)
KeyScheduleEpoch(MlsCipherSuite suite, TreeSize treeSize, Secret joinerSecret, Secret pskSecret, byte[] context)

Method Summary

Modifier and Type	Method	Description
byte[]	confirmationTag(byte[] confirmedTranscriptHash)
KeyScheduleEpoch	copy()
boolean	equals(Object o)
static KeyScheduleEpoch	forCreator(MlsCipherSuite suite)
static KeyScheduleEpoch	forCreator(MlsCipherSuite suite, byte[] groupContext)
static KeyScheduleEpoch	forCreator(MlsCipherSuite suite, SecureRandom rng)
static KeyScheduleEpoch	forExternalJoiner(MlsCipherSuite suite, TreeSize treeSize, KeyScheduleEpoch.ExternalInitParams externalInitParams, Secret commitSecret, List<KeyScheduleEpoch.PSKWithSecret> psks, byte[] context)
GroupKeySet	getEncryptionKeys(TreeSize size)
org.bouncycastle.crypto.params.AsymmetricKeyParameter	getExternalPublicKey()
Secret	getJoinerSecret()
static KeyScheduleEpoch	joiner(MlsCipherSuite suite, byte[] joinerSecret, List<KeyScheduleEpoch.PSKWithSecret> psks, byte[] context)
byte[]	MLSExporter(String label, byte[] context, int length)
KeyScheduleEpoch	next(TreeSize treeSize, byte[] externalInit, Secret commitSecret, List<KeyScheduleEpoch.PSKWithSecret> psks, byte[] context)
byte[]	receiveExternalInit(byte[] kemOut)
static KeyGeneration	senderDataKeys(MlsCipherSuite suite, byte[] senderDataSecretBytes, byte[] ciphertext)
void	setJoinerSecret(Secret joinerSecret)
KeyScheduleEpoch.JoinSecrets	startCommit(Secret commitSecret, List<KeyScheduleEpoch.PSKWithSecret> psks, byte[] context)
static Secret	welcomeSecret(MlsCipherSuite suite, byte[] joinerSecret, List<KeyScheduleEpoch.PSKWithSecret> psk)

Methods inherited from class java.lang.Object

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

Field Details

initSecret

public final Secret initSecret

senderDataSecret

public Secret senderDataSecret

exporterSecret

public final Secret exporterSecret

confirmationKey

public final Secret confirmationKey

membershipKey

public Secret membershipKey

resumptionPSK

public final Secret resumptionPSK

epochAuthenticator

public final Secret epochAuthenticator

encryptionSecret

public final Secret encryptionSecret

externalSecret

public final Secret externalSecret

groupKeySet

public final GroupKeySet groupKeySet

joinerSecret

public Secret joinerSecret

Constructor Details

KeyScheduleEpoch

public KeyScheduleEpoch(MlsCipherSuite suite,
 Secret initSecret,
 Secret senderDataSecret,
 Secret exporterSecret,
 Secret confirmationKey,
 Secret membershipKey,
 Secret resumptionPSK,
 Secret epochAuthenticator,
 Secret encryptionSecret,
 Secret externalSecret,
 org.bouncycastle.crypto.AsymmetricCipherKeyPair externalKeyPair,
 GroupKeySet groupKeySet,
 Secret joinerSecret)

KeyScheduleEpoch

public KeyScheduleEpoch(MlsCipherSuite suite)
                 throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

KeyScheduleEpoch

public KeyScheduleEpoch(MlsCipherSuite suite,
 TreeSize treeSize,
 Secret epochSecret)
                 throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

KeyScheduleEpoch

public KeyScheduleEpoch(MlsCipherSuite suite,
 TreeSize treeSize,
 Secret joinerSecret,
 Secret pskSecret,
 byte[] context)
                 throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

Method Details

receiveExternalInit

public byte[] receiveExternalInit(byte[] kemOut)
                           throws IOException

Throws:

IOException

getJoinerSecret

public Secret getJoinerSecret()

setJoinerSecret

public void setJoinerSecret(Secret joinerSecret)

getEncryptionKeys

public GroupKeySet getEncryptionKeys(TreeSize size)
                              throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

senderDataKeys

public static KeyGeneration senderDataKeys(MlsCipherSuite suite,
 byte[] senderDataSecretBytes,
 byte[] ciphertext)
                                    throws IOException

Throws:

IOException

welcomeSecret

public static Secret welcomeSecret(MlsCipherSuite suite,
 byte[] joinerSecret,
 List<KeyScheduleEpoch.PSKWithSecret> psk)
                            throws IOException

Throws:

IOException

forCreator

public static KeyScheduleEpoch forCreator(MlsCipherSuite suite,
 byte[] groupContext)
                                   throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

forCreator

public static KeyScheduleEpoch forCreator(MlsCipherSuite suite)
                                   throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

forCreator

public static KeyScheduleEpoch forCreator(MlsCipherSuite suite,
 SecureRandom rng)
                                   throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

forExternalJoiner

public static KeyScheduleEpoch forExternalJoiner(MlsCipherSuite suite,
 TreeSize treeSize,
 KeyScheduleEpoch.ExternalInitParams externalInitParams,
 Secret commitSecret,
 List<KeyScheduleEpoch.PSKWithSecret> psks,
 byte[] context)
                                          throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

startCommit

public KeyScheduleEpoch.JoinSecrets startCommit(Secret commitSecret,
 List<KeyScheduleEpoch.PSKWithSecret> psks,
 byte[] context)
                                         throws IOException

Throws:

IOException

confirmationTag

public byte[] confirmationTag(byte[] confirmedTranscriptHash)

copy

public KeyScheduleEpoch copy()

joiner

public static KeyScheduleEpoch joiner(MlsCipherSuite suite,
 byte[] joinerSecret,
 List<KeyScheduleEpoch.PSKWithSecret> psks,
 byte[] context)
                               throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

next

public KeyScheduleEpoch next(TreeSize treeSize,
 byte[] externalInit,
 Secret commitSecret,
 List<KeyScheduleEpoch.PSKWithSecret> psks,
 byte[] context)
                      throws IOException,
IllegalAccessException

Throws:

IOException

IllegalAccessException

MLSExporter

public byte[] MLSExporter(String label,
 byte[] context,
 int length)
                   throws IOException

Throws:

IOException

equals

public boolean equals(Object o)

Overrides:

equals in class Object

getExternalPublicKey

public org.bouncycastle.crypto.params.AsymmetricKeyParameter getExternalPublicKey()