Network.Secure.Identity

Documentation

class Identity a where

An identity, public or private.

Methods

identityName :: a -> String

Return the description that was associated with the identity when it was created.

writeIdentity :: (Functor m, MonadIO m) => a -> m ByteString

Serialize an identity to a ByteString for storage or transmission.

readIdentity :: (Functor m, MonadIO m) => ByteString -> m a

Read back an identity previously serialized with writeIdentity.

Instances

Identity LocalIdentity

Identity PeerIdentity

data PeerIdentity

The public identity of a peer. This kind of identity can be used to authenticate the remote ends of connections.

Instances

Eq PeerIdentity

Ord PeerIdentity

Show PeerIdentity

Identity PeerIdentity

data LocalIdentity

A local identity. This kind of identity can be used to authenticate to remote ends of connections.

Instances

Eq LocalIdentity

Ord LocalIdentity

Show LocalIdentity

Identity LocalIdentity

toPeerIdentity :: LocalIdentity -> PeerIdentity

Extract the public parts of a LocalIdentity into a PeerIdentity suitable for sharing with peers. The resulting PeerIdentity will allow them to verify your identity when you authenticate using the corresponding LocalIdentity.

newLocalIdentity :: MonadIO m => String -> Int -> m LocalIdentity

Generate a new LocalIdentity, giving it an identifying name and a validity period in days.

Note that this function may take quite a while to execute, as it is generating key material for the identity.

piX509 :: PeerIdentity -> X509

liX509 :: LocalIdentity -> X509

liKey :: LocalIdentity -> RSAKeyPair

fromX509 :: X509 -> IO PeerIdentity