src/auth/mech.h

	mech.h revision 345648b341f228bd7f0b89f8aa3ecb9c470d817e
#ifndef __MECH_H
#define __MECH_H

#include "auth-login-interface.h"

struct login_connection;

typedef void mech_callback_t(struct auth_login_reply *reply,
                 const void *data, struct login_connection *conn);

struct auth_request {
    pool_t pool;
    char *user, *realm;

    struct login_connection *conn;
    unsigned int id;
    time_t created;

    enum auth_protocol protocol;
    mech_callback_t *callback;

    int (*auth_continue)(struct auth_request *auth_request,
                 struct auth_login_request_continue *request,
                 const unsigned char *data,
                 mech_callback_t *callback);
    void (*auth_free)(struct auth_request *auth_request);
    /* ... mechanism specific data ... */
};

struct mech_module {
    enum auth_mech mech;

    struct auth_request *(*auth_new)(struct login_connection *conn,
                     unsigned int id,
                     mech_callback_t *callback);
};

extern enum auth_mech auth_mechanisms;
extern const char *const *auth_realms;

void mech_register_module(struct mech_module *module);
void mech_unregister_module(struct mech_module *module);

void mech_request_new(struct login_connection *conn,
              struct auth_login_request_new *request,
              mech_callback_t *callback);
void mech_request_continue(struct login_connection *conn,
               struct auth_login_request_continue *request,
               const unsigned char *data,
               mech_callback_t *callback);
void mech_request_free(struct login_connection *conn,
               struct auth_request *auth_request, unsigned int id);

void mech_init_login_reply(struct auth_login_reply *reply);
void *mech_auth_success(struct auth_login_reply *reply,
            struct auth_request *auth_request,
            const void *data, size_t data_size);
void mech_auth_finish(struct auth_request *auth_request,
              const void *data, size_t data_size, int success);

void mech_cyrus_sasl_init_lib(void);
struct auth_request *mech_cyrus_sasl_new(struct login_connection *conn,
                     struct auth_login_request_new *request,
                     mech_callback_t *callback);

void mech_init(void);
void mech_deinit(void);

#endif