CrossClj

1.0.1 docs

SourceDocs



RECENT

    vhura

    Clojars

    Nov 7, 2015


    OWNER
    Emil Bengtsson
    Oslo, Norway
    emil0r.com

    Readme

    Index of all namespaces


    The README below is fetched from the published project artifact. Some relative links may be broken.

    vhura

    Wrapper for the Yubikey java validation client

    YubiKey?

    Read more at https://www.yubico.com/

    Dependancy

    [vhura "1.0"]
    

    Usage

     (require '[vhura.core :as vhura])
    
    (let [client (vhura/get-client 12346 "mykey")]
      (vhura/verify client "my-otp-here"))
      
    ;;
    ;; will give back a map the following key/values. taken from the code living in core
    ;;
    ;; {:ok? (.isOk response)
    ;;  :H (.getH response)
    ;;  :T (.getT response)
    ;;  :timestamp (.getTimestamp response)
    ;;  :session/counter (.getSessioncounter response)
    ;;  :session/use (.getSessionuse response)
    ;;  :sl (.getSl response)
    ;;  :otp (.getOtp response)
    ;;  :nonce (.getNonce response)
    ;;  :public-id (.getPublicId response)
    ;;
    ;;  :status/error? (.. response getStatus isError)
    ;;  :status (condp = (.getStatus response)
    ;;
    ;;            ;; The OTP has already been seen by the service
    ;;            ResponseStatus/REPLAYED_OTP :replayed-otp
    ;;
    ;;            ;; Unexpected error in our server. Please contact us if you see this error.
    ;;            ResponseStatus/BACKEND_ERROR :backend-error
    ;;
    ;;            ;; The OTP is invalid format
    ;;            ResponseStatus/BAD_OTP :bad-otp
    ;;
    ;;            ;; The HMAC signature verification failed
    ;;            ResponseStatus/BAD_SIGNATURE :bad-signature
    ;;
    ;;            ;; The request id does not exist
    ;;            ResponseStatus/NO_SUCH_CLIENT :no-such-client
    ;;
    ;;            ;; The request lacks a parameter
    ;;            ResponseStatus/MISSING_PARAMETER :missing-parameter
    ;;
    ;;            ;; The request id is not allowed to verify OTPs
    ;;            ResponseStatus/OPERATION_NOT_ALLOWED :operation-not-allowed
    ;;
    ;;            ;; Server could not get requested number of syncs during before timeout
    ;;            ResponseStatus/NOT_ENOUGH_ANSWERS :not-enough-answers
    ;;
    ;;            ;; Server has seen the OTP/Nonce combination before, see http://forum.yubico.com/viewtopic.php?f=3&t=701
    ;;            ResponseStatus/REPLAYED_REQUEST :replayed-request
    ;;
    ;;            ;; The OTP is valid
    ;;            ResponseStatus/OK :ok
    ;;
    ;;            ;; missing an enum
    ;;            (.getStatus response))}
    

    Separate namespace vhura.client for wrapper operations on the YubicoClient class that’s returned from vhura.core/get-client.

    License

    Copyright © 2015 Emil Bengtsson

    Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.

    Coram Deo