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