1. Overview
  2. Docs
package obus
Legend:
Library
Module
Module type
Parameter
Class
Class type

Client-side authentication

Mechanisms
type mechanism_return =
  1. | Mech_continue of data
    (*

    Continue the authentication with this response

    *)
  2. | Mech_ok of data
    (*

    Authentification done

    *)
  3. | Mech_error of string
    (*

    Authentification failed

    *)
class virtual mechanism_handler : object ... end
type mechanism = {
  1. mech_name : string;
    (*

    Name of the mechanism

    *)
  2. mech_exec : unit -> mechanism_handler;
    (*

    Mechanism creator

    *)
}

An client-side authentication mechanism

val mech_name : mechanism -> string

mech_name projection

val mech_exec : mechanism -> unit -> mechanism_handler

mech_exec projection

Predefined mechanisms
val mech_external : mechanism
val mech_anonymous : mechanism
val default_mechanisms : mechanism list
Authentication
val authenticate : ?capabilities:capability list -> ?mechanisms:mechanism list -> stream:stream -> unit -> (OBus_address.guid * capability list) Lwt.t

Launch client-side authentication on the given stream. On success it returns the unique identifier of the server address and capabilities that were successfully negotiated with the server.

Note: authenticate does not sends the initial null byte. You have to handle it before calling authenticate.

  • parameter capabilities

    defaults to