NAME

catboks_dbmap - map user credentials

SYNOPSIS

#include <cat/boks.h>

int catboks_dbmap(const char *route, const char *user, catboks_dbinfo *dbinfo);

DESCRIPTION

This function maps the given credentials to those stored in the Keon database.

The route argument is the access route as returned by catboks_tcpmethod(). The user argument is the Keon user as obtained by a call to catboks_certtouser() or similar.

The parameter givenuser, givenpsw and givendbid must be set in dbinfo before calling this function.

If the mapping is successful, the parameters user, psw and dbid will be set in dbinfo.

The catboks_dbinfo structure looks as follows:

  #define CATBOKS_DBITEMLEN     48

  typedef struct catboks_dbinfo {
      const char *givenuser;
      const char *givenpsw;
      const char *givendbid;
      char user[CATBOKS_DBITEMLEN];
      char psw[CATBOKS_DBITEMLEN];
      char dbid[CATBOKS_DBITEMLEN];
  } catboks_dbinfo;

The map operation searches the Security Server database until a record that matches the three input fields (givenuser, givenpsw and givendbid) is found. The corresponding user, psw and dbid are then read from that record.

If an input value is NULL or "*", it will match any value in the database.

RETURN VALUES

The function returns 0 if successful, or a negative code on error.

SEE ALSO

cat, catboks