xref: /freebsd/crypto/heimdal/lib/krb5/convert_creds.c (revision f078c492a9b57877c723586db26d789cda1b98ea)
1 /*
2  * Copyright (c) 1997 - 2004 Kungliga Tekniska Högskolan
3  * (Royal Institute of Technology, Stockholm, Sweden).
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  *
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  *
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * 3. Neither the name of the Institute nor the names of its contributors
18  *    may be used to endorse or promote products derived from this software
19  *    without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  */
33 
34 #include "krb5_locl.h"
35 #include "krb5-v4compat.h"
36 
37 #ifndef HEIMDAL_SMALLER
38 
39 /**
40  * Convert the v5 credentials in in_cred to v4-dito in v4creds.  This
41  * is done by sending them to the 524 function in the KDC.  If
42  * `in_cred' doesn't contain a DES session key, then a new one is
43  * gotten from the KDC and stored in the cred cache `ccache'.
44  *
45  * @param context Kerberos 5 context.
46  * @param in_cred the credential to convert
47  * @param v4creds the converted credential
48  *
49  * @return Returns 0 to indicate success. Otherwise an kerberos et
50  * error code is returned, see krb5_get_error_message().
51  *
52  * @ingroup krb5_v4compat
53  */
54 
55 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
56 krb524_convert_creds_kdc(krb5_context context,
57 			 krb5_creds *in_cred,
58 			 struct credentials *v4creds)
59     KRB5_DEPRECATED_FUNCTION("Use X instead")
60 {
61     memset(v4creds, 0, sizeof(*v4creds));
62     krb5_set_error_message(context, EINVAL,
63 			   N_("krb524_convert_creds_kdc not supported", ""));
64     return EINVAL;
65 }
66 
67 /**
68  * Convert the v5 credentials in in_cred to v4-dito in v4creds,
69  * check the credential cache ccache before checking with the KDC.
70  *
71  * @param context Kerberos 5 context.
72  * @param ccache credential cache used to check for des-ticket.
73  * @param in_cred the credential to convert
74  * @param v4creds the converted credential
75  *
76  * @return Returns 0 to indicate success. Otherwise an kerberos et
77  * error code is returned, see krb5_get_error_message().
78  *
79  * @ingroup krb5_v4compat
80  */
81 
82 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
83 krb524_convert_creds_kdc_ccache(krb5_context context,
84 				krb5_ccache ccache,
85 				krb5_creds *in_cred,
86 				struct credentials *v4creds)
87     KRB5_DEPRECATED_FUNCTION("Use X instead")
88 {
89     memset(v4creds, 0, sizeof(*v4creds));
90     krb5_set_error_message(context, EINVAL,
91 			   N_("krb524_convert_creds_kdc_ccache not supported", ""));
92     return EINVAL;
93 }
94 
95 #endif
96