2 * Copyright (c) 2011, JANET(UK)
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * 3. Neither the name of JANET(UK) nor the names of its contributors
17 * may be used to endorse or promote products derived from this software
18 * without specific prior written permission.
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * Portions Copyright 2009 by the Massachusetts Institute of Technology.
34 * All Rights Reserved.
36 * Export of this software from the United States of America may
37 * require a specific license from the United States Government.
38 * It is the responsibility of any person or organization contemplating
39 * export to obtain such a license before exporting.
41 * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
42 * distribute this software and its documentation for any purpose and
43 * without fee is hereby granted, provided that the above copyright
44 * notice appear in all copies and that both that copyright notice and
45 * this permission notice appear in supporting documentation, and that
46 * the name of M.I.T. not be used in advertising or publicity pertaining
47 * to distribution of the software without specific, written prior
48 * permission. Furthermore if you modify this software you must label
49 * your software as modified software and not distribute it in such a
50 * fashion that it might be confused with the original M.I.T. software.
51 * M.I.T. makes no representations about the suitability of
52 * this software for any purpose. It is provided "as is" without express
53 * or implied warranty.
57 * Name utility routines.
60 #include "gssapiP_eap.h"
62 static gss_OID_desc gssEapNtEapName = {
63 /* 1.3.6.1.4.1.5322.22.2.1 */
64 10, "\x2B\x06\x01\x04\x01\xA9\x4A\x16\x02\x01"
67 gss_OID GSS_EAP_NT_EAP_NAME = &gssEapNtEapName;
70 gssEapAllocName(OM_uint32 *minor, gss_name_t *pName)
75 *pName = GSS_C_NO_NAME;
77 name = (gss_name_t)GSSEAP_CALLOC(1, sizeof(*name));
83 if (GSSEAP_MUTEX_INIT(&name->mutex) != 0) {
85 gssEapReleaseName(&tmpMinor, &name);
91 return GSS_S_COMPLETE;
95 gssEapReleaseName(OM_uint32 *minor, gss_name_t *pName)
98 krb5_context krbContext = NULL;
104 return GSS_S_COMPLETE;
108 if (name == GSS_C_NO_NAME) {
109 return GSS_S_COMPLETE;
112 GSSEAP_KRB_INIT(&krbContext);
113 krb5_free_principal(krbContext, name->krbPrincipal);
114 gssEapReleaseOid(&tmpMinor, &name->mechanismUsed);
116 gssEapReleaseAttrContext(&tmpMinor, name);
118 GSSEAP_MUTEX_DESTROY(&name->mutex);
122 return GSS_S_COMPLETE;
126 krbPrincipalToName(OM_uint32 *minor,
127 krb5_principal *principal,
133 major = gssEapAllocName(minor, &name);
134 if (GSS_ERROR(major))
137 name->krbPrincipal = *principal;
140 if (KRB_PRINC_LENGTH(name->krbPrincipal) > 1) {
141 name->flags |= NAME_FLAG_SERVICE;
143 name->flags |= NAME_FLAG_NAI;
149 return GSS_S_COMPLETE;
152 static krb5_error_code
153 gssEapGetDefaultRealm(krb5_context krbContext, char **defaultRealm)
155 *defaultRealm = NULL;
157 krb5_appdefault_string(krbContext, "eap_gss",
158 NULL, "default_realm", "", defaultRealm);
160 if (*defaultRealm != NULL && (*defaultRealm)[0] == '\0') {
161 GSSEAP_FREE(*defaultRealm);
162 *defaultRealm = NULL;
165 return (*defaultRealm != NULL) ? 0 : KRB5_CONFIG_NODEFREALM;
169 importServiceName(OM_uint32 *minor,
170 const gss_buffer_t nameBuffer,
174 krb5_error_code code;
175 krb5_context krbContext;
176 krb5_principal krbPrinc;
177 char *service, *host, *realm = NULL;
179 GSSEAP_KRB_INIT(&krbContext);
181 major = bufferToString(minor, nameBuffer, &service);
182 if (GSS_ERROR(major))
185 host = strchr(service, '@');
191 gssEapGetDefaultRealm(krbContext, &realm);
193 code = krb5_build_principal(krbContext,
195 realm != NULL ? strlen(realm) : 0,
196 realm != NULL ? realm : "",
202 KRB_PRINC_TYPE(krbPrinc) = KRB5_NT_SRV_HST;
204 major = krbPrincipalToName(minor, &krbPrinc, pName);
205 if (GSS_ERROR(major))
206 krb5_free_principal(krbContext, krbPrinc);
208 major = GSS_S_FAILURE;
209 *minor = GSSEAP_BAD_SERVICE_NAME;
214 GSSEAP_FREE(service);
220 importUserName(OM_uint32 *minor,
221 const gss_buffer_t nameBuffer,
225 krb5_context krbContext;
226 krb5_principal krbPrinc = NULL;
227 krb5_error_code code;
229 GSSEAP_KRB_INIT(&krbContext);
231 if (nameBuffer == GSS_C_NO_BUFFER) {
232 code = krb5_copy_principal(krbContext,
233 krbAnonymousPrincipal(), &krbPrinc);
236 return GSS_S_FAILURE;
241 major = bufferToString(minor, nameBuffer, &nameString);
242 if (GSS_ERROR(major))
246 * First, attempt to parse the name on the assumption that it includes
247 * a qualifying realm.
249 code = krb5_parse_name_flags(krbContext, nameString,
250 KRB5_PRINCIPAL_PARSE_REQUIRE_REALM, &krbPrinc);
251 if (code == KRB5_PARSE_MALFORMED) {
252 char *defaultRealm = NULL;
256 * We need an explicit appdefaults check because, at least with MIT
257 * Kerberos, setting the context realm to NULL will reset it to the
258 * default Kerberos realm after the second call to get_default_realm.
259 * We want to make sure that the default Kerberos realm does not end
260 * up accidentally appended to an unqualified name.
262 gssEapGetDefaultRealm(krbContext, &defaultRealm);
264 if (defaultRealm == NULL)
265 flags |= KRB5_PRINCIPAL_PARSE_NO_REALM;
267 code = krb5_parse_name_flags(krbContext, nameString, flags, &krbPrinc);
269 if (defaultRealm != NULL)
270 GSSEAP_FREE(defaultRealm);
273 GSSEAP_FREE(nameString);
277 return GSS_S_FAILURE;
281 assert(krbPrinc != NULL);
283 major = krbPrincipalToName(minor, &krbPrinc, pName);
284 if (GSS_ERROR(major))
285 krb5_free_principal(krbContext, krbPrinc);
291 importAnonymousName(OM_uint32 *minor,
292 const gss_buffer_t nameBuffer GSSEAP_UNUSED,
296 krb5_context krbContext;
297 krb5_principal krbPrinc;
299 GSSEAP_KRB_INIT(&krbContext);
301 *minor = krb5_copy_principal(krbContext, krbAnonymousPrincipal(),
304 return GSS_S_FAILURE;
306 major = krbPrincipalToName(minor, &krbPrinc, pName);
307 if (GSS_ERROR(major)) {
308 krb5_free_principal(krbContext, krbPrinc);
314 #define UPDATE_REMAIN(n) do { \
319 #define CHECK_REMAIN(n) do { \
320 if (remain < (n)) { \
321 major = GSS_S_BAD_NAME; \
322 *minor = GSSEAP_TOK_TRUNC; \
328 gssEapImportNameInternal(OM_uint32 *minor,
329 const gss_buffer_t nameBuffer,
333 OM_uint32 major, tmpMinor;
334 krb5_context krbContext;
338 enum gss_eap_token_type tokType;
339 gss_name_t name = GSS_C_NO_NAME;
340 gss_OID mechanismUsed = GSS_C_NO_OID;
342 GSSEAP_KRB_INIT(&krbContext);
344 p = (unsigned char *)nameBuffer->value;
345 remain = nameBuffer->length;
347 if (flags & EXPORT_NAME_FLAG_OID) {
350 /* TOK_ID || MECH_OID_LEN || MECH_OID */
352 return GSS_S_BAD_NAME;
354 if (flags & EXPORT_NAME_FLAG_COMPOSITE)
355 tokType = TOK_TYPE_EXPORT_NAME_COMPOSITE;
357 tokType = TOK_TYPE_EXPORT_NAME;
360 if (load_uint16_be(p) != tokType)
361 return GSS_S_BAD_NAME;
365 len = load_uint16_be(p);
367 return GSS_S_BAD_NAME;
372 return GSS_S_BAD_NAME;
375 mech.elements = &p[2];
377 CHECK_REMAIN(mech.length);
379 major = gssEapCanonicalizeOid(minor,
381 OID_FLAG_FAMILY_MECH_VALID |
382 OID_FLAG_MAP_FAMILY_MECH_TO_NULL,
384 if (GSS_ERROR(major))
387 UPDATE_REMAIN(2 + mech.length);
392 len = load_uint32_be(p);
401 major = importUserName(minor, &buf, &name);
402 if (GSS_ERROR(major))
405 name->mechanismUsed = mechanismUsed;
406 mechanismUsed = GSS_C_NO_OID;
408 if (flags & EXPORT_NAME_FLAG_COMPOSITE) {
414 major = gssEapImportAttrContext(minor, &buf, name);
415 if (GSS_ERROR(major))
419 major = GSS_S_COMPLETE;
423 if (GSS_ERROR(major)) {
424 gssEapReleaseOid(&tmpMinor, &mechanismUsed);
425 gssEapReleaseName(&tmpMinor, &name);
434 importExportName(OM_uint32 *minor,
435 const gss_buffer_t nameBuffer,
438 return gssEapImportNameInternal(minor, nameBuffer, name,
439 EXPORT_NAME_FLAG_OID);
442 #ifdef HAVE_GSS_C_NT_COMPOSITE_EXPORT
444 importCompositeExportName(OM_uint32 *minor,
445 const gss_buffer_t nameBuffer,
448 return gssEapImportNameInternal(minor, nameBuffer, name,
449 EXPORT_NAME_FLAG_OID |
450 EXPORT_NAME_FLAG_COMPOSITE);
454 struct gss_eap_name_import_provider {
456 OM_uint32 (*import)(OM_uint32 *, const gss_buffer_t, gss_name_t *);
460 gssEapImportName(OM_uint32 *minor,
461 const gss_buffer_t nameBuffer,
462 const gss_OID nameType,
463 const gss_OID mechType,
466 struct gss_eap_name_import_provider nameTypes[] = {
467 { GSS_EAP_NT_EAP_NAME, importUserName },
468 { GSS_C_NT_USER_NAME, importUserName },
469 { GSS_C_NT_HOSTBASED_SERVICE, importServiceName },
470 { GSS_C_NT_HOSTBASED_SERVICE_X, importServiceName },
471 { GSS_C_NT_ANONYMOUS, importAnonymousName },
472 { GSS_C_NT_EXPORT_NAME, importExportName },
473 { GSS_KRB5_NT_PRINCIPAL_NAME, importUserName },
474 #ifdef HAVE_GSS_C_NT_COMPOSITE_EXPORT
475 { GSS_C_NT_COMPOSITE_EXPORT, importCompositeExportName },
479 OM_uint32 major = GSS_S_BAD_NAMETYPE;
481 gss_name_t name = GSS_C_NO_NAME;
483 for (i = 0; i < sizeof(nameTypes) / sizeof(nameTypes[0]); i++) {
484 if (oidEqual(nameTypes[i].oid,
485 nameType == GSS_C_NO_OID ? GSS_EAP_NT_EAP_NAME : nameType)) {
486 major = nameTypes[i].import(minor, nameBuffer, &name);
491 if (major == GSS_S_COMPLETE &&
492 mechType != GSS_C_NO_OID) {
493 assert(gssEapIsConcreteMechanismOid(mechType));
494 assert(name->mechanismUsed == GSS_C_NO_OID);
496 major = gssEapCanonicalizeOid(minor, mechType, 0, &name->mechanismUsed);
499 if (GSS_ERROR(major))
500 gssEapReleaseName(&tmpMinor, &name);
508 gssEapExportName(OM_uint32 *minor,
509 const gss_name_t name,
510 gss_buffer_t exportedName)
512 return gssEapExportNameInternal(minor, name, exportedName,
513 EXPORT_NAME_FLAG_OID);
517 gssEapExportNameInternal(OM_uint32 *minor,
518 const gss_name_t name,
519 gss_buffer_t exportedName,
522 OM_uint32 major = GSS_S_FAILURE, tmpMinor;
523 krb5_context krbContext;
524 char *krbName = NULL;
525 size_t krbNameLen, exportedNameLen;
527 gss_buffer_desc attrs = GSS_C_EMPTY_BUFFER;
530 exportedName->length = 0;
531 exportedName->value = NULL;
533 if (name->mechanismUsed != GSS_C_NO_OID)
534 mech = name->mechanismUsed;
536 mech = GSS_EAP_MECHANISM;
538 GSSEAP_KRB_INIT(&krbContext);
540 *minor = krb5_unparse_name(krbContext, name->krbPrincipal, &krbName);
542 major = GSS_S_FAILURE;
545 krbNameLen = strlen(krbName);
548 if (flags & EXPORT_NAME_FLAG_OID) {
549 exportedNameLen += 6 + mech->length;
551 exportedNameLen += 4 + krbNameLen;
552 if (flags & EXPORT_NAME_FLAG_COMPOSITE) {
553 major = gssEapExportAttrContext(minor, name, &attrs);
554 if (GSS_ERROR(major))
556 exportedNameLen += attrs.length;
559 exportedName->value = GSSEAP_MALLOC(exportedNameLen);
560 if (exportedName->value == NULL) {
561 major = GSS_S_FAILURE;
565 exportedName->length = exportedNameLen;
567 p = (unsigned char *)exportedName->value;
569 if (flags & EXPORT_NAME_FLAG_OID) {
570 /* TOK | MECH_OID_LEN */
571 store_uint16_be((flags & EXPORT_NAME_FLAG_COMPOSITE)
572 ? TOK_TYPE_EXPORT_NAME_COMPOSITE
573 : TOK_TYPE_EXPORT_NAME,
576 store_uint16_be(mech->length + 2, p);
581 *p++ = mech->length & 0xff;
582 memcpy(p, mech->elements, mech->length);
587 store_uint32_be(krbNameLen, p);
591 memcpy(p, krbName, krbNameLen);
594 if (flags & EXPORT_NAME_FLAG_COMPOSITE) {
595 memcpy(p, attrs.value, attrs.length);
599 assert(p == (unsigned char *)exportedName->value + exportedNameLen);
601 major = GSS_S_COMPLETE;
605 gss_release_buffer(&tmpMinor, &attrs);
606 if (GSS_ERROR(major))
607 gss_release_buffer(&tmpMinor, exportedName);
608 krb5_free_unparsed_name(krbContext, krbName);
614 gssEapCanonicalizeName(OM_uint32 *minor,
615 const gss_name_t input_name,
616 const gss_OID mech_type,
617 gss_name_t *dest_name)
619 OM_uint32 major, tmpMinor;
620 krb5_context krbContext;
624 if (input_name == GSS_C_NO_NAME) {
626 return GSS_S_CALL_INACCESSIBLE_READ | GSS_S_BAD_NAME;
629 GSSEAP_KRB_INIT(&krbContext);
631 major = gssEapAllocName(minor, &name);
632 if (GSS_ERROR(major)) {
636 if (mech_type != GSS_C_NO_OID)
637 mech_used = mech_type;
639 mech_used = input_name->mechanismUsed;
641 major = gssEapCanonicalizeOid(minor,
644 &name->mechanismUsed);
645 if (GSS_ERROR(major))
648 name->flags = input_name->flags;
650 *minor = krb5_copy_principal(krbContext, input_name->krbPrincipal,
651 &name->krbPrincipal);
653 major = GSS_S_FAILURE;
657 if (input_name->attrCtx != NULL) {
658 major = gssEapDuplicateAttrContext(minor, input_name, name);
659 if (GSS_ERROR(major))
666 if (GSS_ERROR(major)) {
667 gssEapReleaseName(&tmpMinor, &name);
674 gssEapDuplicateName(OM_uint32 *minor,
675 const gss_name_t input_name,
676 gss_name_t *dest_name)
678 return gssEapCanonicalizeName(minor, input_name,
679 GSS_C_NO_OID, dest_name);
683 gssEapDisplayName(OM_uint32 *minor,
685 gss_buffer_t output_name_buffer,
686 gss_OID *output_name_type)
689 krb5_context krbContext;
693 GSSEAP_KRB_INIT(&krbContext);
695 output_name_buffer->length = 0;
696 output_name_buffer->value = NULL;
698 if (name == GSS_C_NO_NAME) {
700 return GSS_S_CALL_INACCESSIBLE_READ | GSS_S_BAD_NAME;
703 *minor = krb5_unparse_name(krbContext, name->krbPrincipal, &krbName);
705 return GSS_S_FAILURE;
708 major = makeStringBuffer(minor, krbName, output_name_buffer);
709 if (GSS_ERROR(major)) {
710 krb5_free_unparsed_name(krbContext, krbName);
714 krb5_free_unparsed_name(krbContext, krbName);
716 if (KRB_PRINC_TYPE(name->krbPrincipal) == KRB5_NT_WELLKNOWN &&
717 krb5_principal_compare(krbContext,
718 name->krbPrincipal, krbAnonymousPrincipal())) {
719 name_type = GSS_C_NT_ANONYMOUS;
721 name_type = GSS_EAP_NT_EAP_NAME;
724 if (output_name_type != NULL)
725 *output_name_type = name_type;
727 return GSS_S_COMPLETE;