Web.Authenticate.OAuth

Contents

Synopsis

Data types

data OAuth Source

Data type for OAuth client (consumer). The default values apply when you use newOAuth

Constructors

OAuth

Fields

oauthServerName :: String: Service name (You MUST specify)
oauthRequestUri :: String: URI to request temporary credential (You MUST specify)
oauthAccessTokenUri :: String: Uri to obtain access token (You MUST specify)
oauthAuthorizeUri :: String: Uri to authorize (You MUST specify)
oauthSignatureMethod :: SignMethod: Signature Method (default: HMACSHA1)
oauthConsumerKey :: ByteString: Consumer key (You MUST specify)
oauthConsumerSecret :: ByteString: Consumer Secret (You MUST specify)
oauthCallback :: Maybe ByteString: Callback uri to redirect after authentication (default: Nothing)
oauthRealm :: Maybe ByteString: Optional authorization realm (default: Nothing)

Instances

Eq OAuth
Data OAuth
Ord OAuth
Read OAuth
Show OAuth
Typeable OAuth

newOAuth :: OAuth Source

Default value for OAuth datatype. You must specify at least oauthServerName, URIs and Tokens.

data SignMethod Source

Data type for signature method.

Constructors

PLAINTEXT
HMACSHA1
RSASHA1 PrivateKey

Instances

Eq SignMethod
Data SignMethod
Ord SignMethod
Read SignMethod
Show SignMethod
Typeable SignMethod

data Credential Source

Data type for redential.

Constructors

Credential
Fields unCredential :: [(ByteString, ByteString)]

Instances

Eq Credential
Data Credential
Ord Credential
Read Credential
Show Credential
Typeable Credential

data OAuthException Source

Constructors

OAuthException String

Instances

Eq OAuthException
Data OAuthException
Show OAuthException
Typeable OAuthException
Exception OAuthException

Operations for credentials

newCredential Source

Arguments

:: ByteString	value for oauth_token
-> ByteString	value for oauth_token_secret
-> Credential

Convenient function to create Credential with OAuth Token and Token Secret.

emptyCredential :: Credential Source

Empty credential.

insert Source

Arguments

:: ByteString	Parameter Name
-> ByteString	Value
-> Credential	Credential
-> Credential	Result

Insert an oauth parameter into given Credential.

delete Source

Arguments

:: ByteString	Parameter name
-> Credential	Credential
-> Credential	Result

Remove an oauth parameter for key from given Credential.

inserts :: [(ByteString, ByteString)] -> Credential -> Credential Source

Convenient method for inserting multiple parameters into credential.

Signature

signOAuth Source

Arguments

:: OAuth	OAuth Application
-> Credential	Credential
-> Request IO	Original Request
-> IO (Request IO)	Signed OAuth Request

Add OAuth headers & sign to Request.

genSign :: ResourceIO m => OAuth -> Credential -> Request m -> m ByteString Source

Url & operation for authentication

authorizeUrl Source

Arguments

:: OAuth	OAuth Application
-> Credential	Temporary Credential (Request Token & Secret)
-> String	URL to authorize

URL to obtain OAuth verifier.

getAccessToken,getTokenCredential Source

Arguments

:: OAuth	OAuth Application
-> Credential	Temporary Credential with oauth_verifier
-> IO Credential	Token Credential (Access Token & Secret)

Get Access token.

getTemporaryCredential Source

Arguments

:: OAuth	OAuth Application
-> IO Credential	Temporary Credential (Request Token & Secret).

Get temporary credential for requesting acces token.

getTemporaryCredentialWithScope Source

Arguments

:: ByteString	Scope parameter string
-> OAuth	OAuth Application
-> IO Credential	Temporay Credential (Request Token & Secret).

Get temporary credential for requesting access token with Scope parameter.

getAccessTokenProxy,getTokenCredentialProxy Source

Arguments

:: Maybe Proxy	Proxy
-> OAuth	OAuth Application
-> Credential	Temporary Credential with oauth_verifier
-> IO Credential	Token Credential (Access Token & Secret)

Get Access token via the proxy.

getTemporaryCredentialProxy Source

Arguments

:: Maybe Proxy	Proxy
-> OAuth	OAuth Application
-> IO Credential	Temporary Credential (Request Token & Secret).

Get temporary credential for requesting access token via the proxy.

getAccessToken'Source

Arguments

:: (Request IO -> Request IO)	Request Hook
-> OAuth	OAuth Application
-> Credential	Temporary Credential with oauth_verifier
-> IO Credential	Token Credential (Access Token & Secret)

getTemporaryCredential'Source

Arguments

:: (Request IO -> Request IO)	Request Hook
-> OAuth	OAuth Application
-> IO Credential	Temporary Credential (Request Token & Secret).

Utility Methods

paramEncode :: ByteString -> ByteString Source

Encode a string using the percent encoding method for OAuth.

addScope :: MonadIO m => ByteString -> Request m -> Request mSource

addMaybeProxy :: Maybe Proxy -> Request m -> Request mSource