lib/krb5/convert_creds.c

   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