org.kitteh.irc.client.library.feature.auth

Class SaslEcdsaNist256PChallenge

java.lang.Object

org.kitteh.irc.client.library.feature.auth.AbstractAccountProtocol

org.kitteh.irc.client.library.feature.auth.AbstractSaslProtocol<ECPrivateKey>

org.kitteh.irc.client.library.feature.auth.SaslEcdsaNist256PChallenge

All Implemented Interfaces:

ClientLinked, AuthProtocol, AccountName, EventListening

public class SaslEcdsaNist256PChallenge
extends AbstractSaslProtocol<ECPrivateKey>

SASL ECDSA-NIST256P-CHALLENGE authentication. Automatically attempts auth during connection.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SaslEcdsaNist256PChallenge.ECKeyPair Holds a private and public key.

Constructor Summary

Constructors

Constructor and Description
SaslEcdsaNist256PChallenge(Client client, String accountName, ECPrivateKey privateKey) Creates an instance.

Method Summary

Modifier and Type	Method and Description
static String	base64Encode(ECPrivateKey privateKey) Encodes a given ECPrivateKey to base64.
static String	base64Encode(ECPublicKey publicKey) Encodes a given ECPublicKey to base64.
protected String	getAuthLine() Gets the info to base64 encode in the first AUTHENTICATE message.
static String	getCompressedBase64PublicKey(ECPublicKey publicKey) Applies point compression to a public key and returns the result, encoded with base64.
Object	getEventListener() Gets the object for listening.
static SaslEcdsaNist256PChallenge.ECKeyPair	getNewKey() Generates a new SaslEcdsaNist256PChallenge.ECKeyPair for use with this SASL protocol.
static ECPrivateKey	getPrivateKey(String base64Encoded) Gets a ECPrivateKey from a base64 encoded String.
static ECPublicKey	getPublicKey(String base64Encoded) Gets a ECPublicKey from a base64 encoded String.
static String	sign(ECPrivateKey privateKey, String base64Challenge) Signs a given base64'd challenge via ECDSA.
static boolean	verify(ECPublicKey publicKey, String base64Challenge, String signature) Verifies a signature.

Methods inherited from class org.kitteh.irc.client.library.feature.auth.AbstractSaslProtocol

getAuthentication, getAuthValue, setAuthValue

Methods inherited from class org.kitteh.irc.client.library.feature.auth.AbstractAccountProtocol

getAccountName, getClient, setAccountName, startAuthentication, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

SaslEcdsaNist256PChallenge

public SaslEcdsaNist256PChallenge(@Nonnull
                                  Client client,
                                  @Nonnull
                                  String accountName,
                                  @Nonnull
                                  ECPrivateKey privateKey)

Creates an instance.

Parameters:

client - client

accountName - account name

privateKey - private key

Method Detail

getAuthLine

@Nonnull
protected String getAuthLine()

Description copied from class: AbstractSaslProtocol

Gets the info to base64 encode in the first AUTHENTICATE message.

Specified by:

getAuthLine in class AbstractSaslProtocol<ECPrivateKey>

Returns:

value to encode

getEventListener

@Nonnull
public Object getEventListener()

Description copied from interface: EventListening

Gets the object for listening.

Specified by:

getEventListener in interface EventListening

Overrides:

getEventListener in class AbstractSaslProtocol<ECPrivateKey>

Returns:

listener

base64Encode

@Nonnull
public static String base64Encode(@Nonnull
                                            ECPrivateKey privateKey)

Encodes a given ECPrivateKey to base64.

Parameters:

privateKey - key to encode

Returns:

encoded key

Throws:

IllegalArgumentException - if privateKey is null

See Also:

getPrivateKey(String)

base64Encode

@Nonnull
public static String base64Encode(@Nonnull
                                            ECPublicKey publicKey)

Encodes a given ECPublicKey to base64.

Parameters:

publicKey - key to encode

Returns:

encoded key

Throws:

IllegalArgumentException - if publicKey is null

See Also:

getPublicKey(String)

getPrivateKey

@Nonnull
public static ECPrivateKey getPrivateKey(@Nonnull
                                                   String base64Encoded)
                                            throws NoSuchAlgorithmException,
                                                   InvalidKeySpecException

Gets a ECPrivateKey from a base64 encoded String.

Parameters:

base64Encoded - encoded string

Returns:

the key

Throws:

NoSuchAlgorithmException - if the JVM doesn't support EC

InvalidKeySpecException - if the encoded key is invalid

IllegalArgumentException - if base64Encoded is null

See Also:

base64Encode(ECPrivateKey)

getPublicKey

@Nonnull
public static ECPublicKey getPublicKey(@Nonnull
                                                 String base64Encoded)
                                          throws NoSuchAlgorithmException,
                                                 InvalidKeySpecException

Gets a ECPublicKey from a base64 encoded String.

Parameters:

base64Encoded - encoded string

Returns:

the key

Throws:

NoSuchAlgorithmException - if the JVM doesn't support EC

InvalidKeySpecException - if the encoded key is invalid

IllegalArgumentException - if base64Encoded is null

See Also:

base64Encode(ECPublicKey)

getCompressedBase64PublicKey

@Nonnull
public static String getCompressedBase64PublicKey(@Nonnull
                                                            ECPublicKey publicKey)

Applies point compression to a public key and returns the result, encoded with base64. See http://www.secg.org/sec1-v2.pdf section 2.3.3 for more info.

Parameters:

publicKey - the public key to get the compressed X9.62 representation for

Returns:

base64 encoded compressed public key

Throws:

IllegalArgumentException - if publicKey is null

sign

@Nonnull
public static String sign(@Nonnull
                                    ECPrivateKey privateKey,
                                    @Nonnull
                                    String base64Challenge)
                             throws SignatureException,
                                    NoSuchAlgorithmException,
                                    InvalidKeyException

Signs a given base64'd challenge via ECDSA.

Parameters:

privateKey - private key for signing

base64Challenge - challenge to sign

Returns:

base64 encoded signature

Throws:

SignatureException - if signing fails

NoSuchAlgorithmException - if the JVM doesn't support NONEwithECDSA

InvalidKeyException - if the key is invalid

IllegalArgumentException - if either parameter is null

getNewKey

@Nonnull
public static SaslEcdsaNist256PChallenge.ECKeyPair getNewKey()
                                                                throws NoSuchAlgorithmException

Generates a new SaslEcdsaNist256PChallenge.ECKeyPair for use with this SASL protocol.

Returns:

a shiny new key pair

Throws:

NoSuchAlgorithmException - if the JVM doesn't support NONEwithECDSA

verify

public static boolean verify(@Nonnull
                             ECPublicKey publicKey,
                             @Nonnull
                             String base64Challenge,
                             @Nonnull
                             String signature)
                      throws SignatureException,
                             NoSuchAlgorithmException,
                             InvalidKeyException

Verifies a signature.

Parameters:

publicKey - public key to use in verification

base64Challenge - the challenge that was signed

signature - signature

Returns:

true if verified

Throws:

SignatureException - if something has gone horribly wrong

NoSuchAlgorithmException - if the JVM doesn't support NONEwithECDSA

InvalidKeyException - if the key is invalid

IllegalArgumentException - if any parameter is null