root/crypto/heimdal/lib/gssapi/mech/gss_init_sec_context.c
/*-
 * Copyright (c) 2005 Doug Rabson
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 *      $FreeBSD: src/lib/libgssapi/gss_init_sec_context.c,v 1.1 2005/12/29 14:40:20 dfr Exp $
 */

#include "mech_locl.h"

static gss_cred_id_t
_gss_mech_cred_find(gss_cred_id_t cred_handle, gss_OID mech_type)
{
        struct _gss_cred *cred = (struct _gss_cred *)cred_handle;
        struct _gss_mechanism_cred *mc;

        if (cred == NULL)
                return GSS_C_NO_CREDENTIAL;

        HEIM_SLIST_FOREACH(mc, &cred->gc_mc, gmc_link) {
                if (gss_oid_equal(mech_type, mc->gmc_mech_oid))
                        return mc->gmc_cred;
        }
        return GSS_C_NO_CREDENTIAL;
}

/**
 * As the initiator build a context with an acceptor.
 *
 * Returns in the major
 * - GSS_S_COMPLETE - if the context if build
 * - GSS_S_CONTINUE_NEEDED -  if the caller needs  to continue another
 *      round of gss_i nit_sec_context
 * - error code - any other error code
 *
 * @param minor_status minor status code.
 *
 * @param initiator_cred_handle the credential to use when building
 *        the context, if GSS_C_NO_CREDENTIAL is passed, the default
 *        credential for the mechanism will be used.
 *
 * @param context_handle a pointer to a context handle, will be
 *        returned as long as there is not an error.
 *
 * @param target_name the target name of acceptor, created using
 *        gss_import_name(). The name is can be of any name types the
 *        mechanism supports, check supported name types with
 *        gss_inquire_names_for_mech().
 *
 * @param input_mech_type mechanism type to use, if GSS_C_NO_OID is
 *        used, Kerberos (GSS_KRB5_MECHANISM) will be tried. Other
 *        available mechanism are listed in the @ref gssapi_mechs_intro
 *        section.
 *
 * @param req_flags flags using when building the context, see @ref
 *        gssapi_context_flags
 *
 * @param time_req time requested this context should be valid in
 *        seconds, common used value is GSS_C_INDEFINITE
 *
 * @param input_chan_bindings Channel bindings used, if not exepected
 *        otherwise, used GSS_C_NO_CHANNEL_BINDINGS
 *
 * @param input_token input token sent from the acceptor, for the
 *        initial packet the buffer of { NULL, 0 } should be used.
 *
 * @param actual_mech_type the actual mech used, MUST NOT be freed
 *        since it pointing to static memory.
 *
 * @param output_token if there is an output token, regardless of
 *        complete, continue_needed, or error it should be sent to the
 *        acceptor
 *
 * @param ret_flags return what flags was negotitated, caller should
 *        check if they are accetable. For example, if
 *        GSS_C_MUTUAL_FLAG was negotiated with the acceptor or not.
 *
 * @param time_rec amount of time this context is valid for
 *
 * @returns a gss_error code, see gss_display_status() about printing
 *          the error code.
 *
 * @ingroup gssapi
 */



GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL
gss_init_sec_context(OM_uint32 * minor_status,
    const gss_cred_id_t initiator_cred_handle,
    gss_ctx_id_t * context_handle,
    const gss_name_t target_name,
    const gss_OID input_mech_type,
    OM_uint32 req_flags,
    OM_uint32 time_req,
    const gss_channel_bindings_t input_chan_bindings,
    const gss_buffer_t input_token,
    gss_OID * actual_mech_type,
    gss_buffer_t output_token,
    OM_uint32 * ret_flags,
    OM_uint32 * time_rec)
{
        OM_uint32 major_status;
        gssapi_mech_interface m;
        struct _gss_name *name = (struct _gss_name *) target_name;
        struct _gss_mechanism_name *mn;
        struct _gss_context *ctx = (struct _gss_context *) *context_handle;
        gss_cred_id_t cred_handle;
        int allocated_ctx;
        gss_OID mech_type = input_mech_type;

        *minor_status = 0;

        _mg_buffer_zero(output_token);
        if (actual_mech_type)
            *actual_mech_type = GSS_C_NO_OID;
        if (ret_flags)
            *ret_flags = 0;
        if (time_rec)
            *time_rec = 0;

        /*
         * If we haven't allocated a context yet, do so now and lookup
         * the mechanism switch table. If we have one already, make
         * sure we use the same mechanism switch as before.
         */
        if (!ctx) {
                if (mech_type == NULL)
                        mech_type = GSS_KRB5_MECHANISM;

                ctx = malloc(sizeof(struct _gss_context));
                if (!ctx) {
                        *minor_status = ENOMEM;
                        return (GSS_S_FAILURE);
                }
                memset(ctx, 0, sizeof(struct _gss_context));
                m = ctx->gc_mech = __gss_get_mechanism(mech_type);
                if (!m) {
                        free(ctx);
                        return (GSS_S_BAD_MECH);
                }
                allocated_ctx = 1;
        } else {
                m = ctx->gc_mech;
                mech_type = &ctx->gc_mech->gm_mech_oid;
                allocated_ctx = 0;
        }

        /*
         * Find the MN for this mechanism.
         */
        major_status = _gss_find_mn(minor_status, name, mech_type, &mn);
        if (major_status != GSS_S_COMPLETE) {
                if (allocated_ctx)
                        free(ctx);
                return major_status;
        }

        /*
         * If we have a cred, find the cred for this mechanism.
         */
        if (m->gm_flags & GM_USE_MG_CRED)
                cred_handle = initiator_cred_handle;
        else
                cred_handle = _gss_mech_cred_find(initiator_cred_handle, mech_type);

        major_status = m->gm_init_sec_context(minor_status,
            cred_handle,
            &ctx->gc_ctx,
            mn->gmn_name,
            mech_type,
            req_flags,
            time_req,
            input_chan_bindings,
            input_token,
            actual_mech_type,
            output_token,
            ret_flags,
            time_rec);

        if (major_status != GSS_S_COMPLETE
            && major_status != GSS_S_CONTINUE_NEEDED) {
                if (allocated_ctx)
                        free(ctx);
                _mg_buffer_zero(output_token);
                _gss_mg_error(m, major_status, *minor_status);
        } else {
                *context_handle = (gss_ctx_id_t) ctx;
        }

        return (major_status);
}