Return to README CVS log

Up to [Research Unix] / researchv10no / ipc / mgrs / oauthmgr

Annotation of researchv10no/ipc/mgrs/oauthmgr/README, revision 1.1

1.1     ! root        1: There is a man page for authmgr(8) with the authmgr paper in
        !             2: /usr/cohrs/paper.
        !             3: 
        !             4: If you want to add a new challenge box type to authmgr, follow
        !             5: these steps.
        !             6: 
        !             7: 1) create a new .c file, containing two procedures, a foochal
        !             8:    procedure and a foocomp procedure (assuming foo is the type
        !             9:    of challenge box you are adding).
        !            10: 
        !            11:    char*
        !            12:    foochal(kp)
        !            13:        struct keyinfo *kp;
        !            14:        char *login;
        !            15:    {
        !            16:        return "the challenge string, up to 60 characters login";
        !            17:    }
        !            18: 
        !            19:    int
        !            20:    foocomp(kp, response)
        !            21:        struct keyinfo *kp;
        !            22:        char *response;
        !            23:    {
        !            24:        if(response is correct)
        !            25:                return 0;
        !            26:        else
        !            27:                return 1;
        !            28:    }
        !            29: 
        !            30:    struct keyinfo is defined in "authmgr.h", so you'll want to include
        !            31:    this.  Look at atalla.c for an example.  Note that you can define
        !            32:    static variables if you want foochal to save stuff that foocomp
        !            33:    uses later.
        !            34: 
        !            35: 2) Add foo.o to the Makefile OBJS line.
        !            36: 
        !            37: 3) Edit keytypes.c, and, in the "keytypemap" structure, add an
        !            38:    entry for the foo box, for example:
        !            39:        "foo", foochal, foocomp,        /* a foo encryption box */
        !            40: 
        !            41:    Put this entry just before the line that says "0, 0, 0". Don't
        !            42:    put it first, no matter what!
        !            43: 
        !            44:    Also, on the lines just before the keytypemap structure, add
        !            45:    external refs to foochal and foocomp (look at the atalla lines
        !            46:    if you need examples).
        !            47: 
        !            48: 4) make authmgr
        !            49: 
        !            50: You should now be able to add lines in the keys file of type "foo",
        !            51: and the foochal and foocomp routines should be used to make the
        !            52: challenge and compare the response with the correct response.
        !            53: 
        !            54: If foochal ever returns a NULL pointer, authmgr assumes that it
        !            55: should prompt the user for a "Password: " instead of a normal
        !            56: challenge.  Take care to not return NULL if this isn't what you want.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.