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

Class SaslEcdsaNist256PChallenge

java.lang.Object

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

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

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

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

All Implemented Interfaces:

ClientLinked, AuthProtocol, EventListening

public class SaslEcdsaNist256PChallenge
extends AbstractAccountSaslProtocol

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(@NonNull Client client, @NonNull String accountName, @NonNull ECPrivateKey privateKey) Creates an instance.

Method Summary

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

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

getAccountName

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

getAuthentication

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

getClient, 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

protected @NonNull String getAuthLine()

Description copied from class: AbstractSaslProtocol

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

Specified by:

getAuthLine in class AbstractSaslProtocol

Returns:

value to encode

getEventListener

public @NonNull Object getEventListener()

Description copied from interface: EventListening

Gets the object for listening.

Specified by:

getEventListener in interface EventListening

Overrides:

getEventListener in class AbstractSaslProtocol

Returns:

listener

toString

protected void toString(ToStringer stringer)

Description copied from class: AbstractAuthProtocol

Adds data to toString.

Overrides:

toString in class AbstractAccountSaslProtocol

Parameters:

stringer - stringer

base64Encode

public static @NonNull 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

public static @NonNull 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

public static @NonNull 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

public static @NonNull 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

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

Applies point compression to a public key and returns the result, encoded with base64. See https://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

public static @NonNull 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

public static @NonNull 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