xref: /freebsd/crypto/krb5/src/lib/krb5/keytab/read_servi.c (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1 /* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */
2 /* lib/krb5/keytab/read_servi.c */
3 /*
4  * Copyright 1990,2008 by the Massachusetts Institute of Technology.
5  * All Rights Reserved.
6  *
7  * Export of this software from the United States of America may
8  *   require a specific license from the United States Government.
9  *   It is the responsibility of any person or organization contemplating
10  *   export to obtain such a license before exporting.
11  *
12  * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
13  * distribute this software and its documentation for any purpose and
14  * without fee is hereby granted, provided that the above copyright
15  * notice appear in all copies and that both that copyright notice and
16  * this permission notice appear in supporting documentation, and that
17  * the name of M.I.T. not be used in advertising or publicity pertaining
18  * to distribution of the software without specific, written prior
19  * permission.  Furthermore if you modify this software you must label
20  * your software as modified software and not distribute it in such a
21  * fashion that it might be confused with the original M.I.T. software.
22  * M.I.T. makes no representations about the suitability of
23  * this software for any purpose.  It is provided "as is" without express
24  * or implied warranty.
25  */
26 
27 /*
28  * This routine is designed to be passed to krb5_rd_req.
29  * It is a convenience function that reads a key out of a keytab.
30  * It handles all of the opening and closing of the keytab
31  * internally.
32  */
33 #ifndef LEAN_CLIENT
34 
35 #include "k5-int.h"
36 
37 #define KSUCCESS 0
38 
39 /*
40  * effects: If keyprocarg is not NULL, it is taken to be the name of a
41  *      keytab.  Otherwise, the default keytab will be used.  This
42  *      routine opens the keytab and finds the principal associated with
43  *      principal, vno, and enctype and returns the resulting key in *key
44  *      or returning an error code if it is not found.
45  * returns: Either KSUCCESS or error code.
46  * errors: error code if not found or keyprocarg is invalid.
47  */
48 krb5_error_code KRB5_CALLCONV
krb5_kt_read_service_key(krb5_context context,krb5_pointer keyprocarg,krb5_principal principal,krb5_kvno vno,krb5_enctype enctype,krb5_keyblock ** key)49 krb5_kt_read_service_key(krb5_context context, krb5_pointer keyprocarg, krb5_principal principal, krb5_kvno vno, krb5_enctype enctype, krb5_keyblock **key)
50 {
51     krb5_error_code kerror = KSUCCESS;
52     char keytabname[MAX_KEYTAB_NAME_LEN + 1]; /* + 1 for NULL termination */
53     krb5_keytab id;
54     krb5_keytab_entry entry;
55 
56     /*
57      * Get the name of the file that we should use.
58      */
59     if (!keyprocarg) {
60         if ((kerror = krb5_kt_default_name(context, (char *)keytabname,
61                                            sizeof(keytabname) - 1))!= KSUCCESS)
62             return (kerror);
63     } else {
64         memset(keytabname, 0, sizeof(keytabname));
65         (void) strncpy(keytabname, (char *)keyprocarg,
66                        sizeof(keytabname) - 1);
67     }
68 
69     if ((kerror = krb5_kt_resolve(context, (char *)keytabname, &id)))
70         return (kerror);
71 
72     kerror = krb5_kt_get_entry(context, id, principal, vno, enctype, &entry);
73     krb5_kt_close(context, id);
74 
75     if (kerror)
76         return(kerror);
77 
78     krb5_copy_keyblock(context, &entry.key, key);
79 
80     krb5_kt_free_entry(context, &entry);
81 
82     return (KSUCCESS);
83 }
84 #endif /* LEAN_CLIENT */
85