HEIMDAL:lib/krb5: add krb5_rd_req_in_set_verify_ap_req_flags()
[metze/samba/wip.git] / third_party / heimdal / lib / krb5 / rd_req.c
1
2 /*
3  * Copyright (c) 1997 - 2007 Kungliga Tekniska Högskolan
4  * (Royal Institute of Technology, Stockholm, Sweden).
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  *
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * 3. Neither the name of the Institute nor the names of its contributors
19  *    may be used to endorse or promote products derived from this software
20  *    without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  */
34
35 #include "krb5_locl.h"
36
37 static krb5_error_code
38 decrypt_tkt_enc_part (krb5_context context,
39                       krb5_keyblock *key,
40                       EncryptedData *enc_part,
41                       EncTicketPart *decr_part)
42 {
43     krb5_error_code ret;
44     krb5_data plain;
45     size_t len;
46     krb5_crypto crypto;
47
48     ret = krb5_crypto_init(context, key, 0, &crypto);
49     if (ret)
50         return ret;
51     ret = krb5_decrypt_EncryptedData (context,
52                                       crypto,
53                                       KRB5_KU_TICKET,
54                                       enc_part,
55                                       &plain);
56     krb5_crypto_destroy(context, crypto);
57     if (ret)
58         return ret;
59
60     ret = decode_EncTicketPart(plain.data, plain.length, decr_part, &len);
61     if (ret)
62         krb5_set_error_message(context, ret,
63                                N_("Failed to decode encrypted "
64                                   "ticket part", ""));
65     krb5_data_free (&plain);
66     return ret;
67 }
68
69 static krb5_error_code
70 decrypt_authenticator (krb5_context context,
71                        EncryptionKey *key,
72                        EncryptedData *enc_part,
73                        Authenticator *authenticator,
74                        krb5_key_usage usage)
75 {
76     krb5_error_code ret;
77     krb5_data plain;
78     size_t len;
79     krb5_crypto crypto;
80
81     ret = krb5_crypto_init(context, key, 0, &crypto);
82     if (ret)
83         return ret;
84     ret = krb5_decrypt_EncryptedData (context,
85                                       crypto,
86                                       usage /* KRB5_KU_AP_REQ_AUTH */,
87                                       enc_part,
88                                       &plain);
89     /* for backwards compatibility, also try the old usage */
90     if (ret && usage == KRB5_KU_TGS_REQ_AUTH)
91         ret = krb5_decrypt_EncryptedData (context,
92                                           crypto,
93                                           KRB5_KU_AP_REQ_AUTH,
94                                           enc_part,
95                                           &plain);
96     krb5_crypto_destroy(context, crypto);
97     if (ret)
98         return ret;
99
100     ret = decode_Authenticator(plain.data, plain.length,
101                                authenticator, &len);
102     krb5_data_free (&plain);
103     return ret;
104 }
105
106 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
107 krb5_decode_ap_req(krb5_context context,
108                    const krb5_data *inbuf,
109                    krb5_ap_req *ap_req)
110 {
111     krb5_error_code ret;
112     size_t len;
113     ret = decode_AP_REQ(inbuf->data, inbuf->length, ap_req, &len);
114     if (ret)
115         return ret;
116     if (ap_req->pvno != 5){
117         free_AP_REQ(ap_req);
118         krb5_clear_error_message (context);
119         return KRB5KRB_AP_ERR_BADVERSION;
120     }
121     if (ap_req->msg_type != krb_ap_req){
122         free_AP_REQ(ap_req);
123         krb5_clear_error_message (context);
124         return KRB5KRB_AP_ERR_MSG_TYPE;
125     }
126     if (ap_req->ticket.tkt_vno != 5){
127         free_AP_REQ(ap_req);
128         krb5_clear_error_message (context);
129         return KRB5KRB_AP_ERR_BADVERSION;
130     }
131     return 0;
132 }
133
134 static krb5_error_code
135 check_transited(krb5_context context, Ticket *ticket, EncTicketPart *enc)
136 {
137     char **realms;
138     unsigned int num_realms, n;
139     krb5_error_code ret;
140
141     /*
142      * Windows 2000 and 2003 uses this inside their TGT so it's normaly
143      * not seen by others, however, samba4 joined with a Windows AD as
144      * a Domain Controller gets exposed to this.
145      */
146     if(enc->transited.tr_type == 0 && enc->transited.contents.length == 0)
147         return 0;
148
149     if(enc->transited.tr_type != domain_X500_Compress)
150         return KRB5KDC_ERR_TRTYPE_NOSUPP;
151
152     if(enc->transited.contents.length == 0)
153         return 0;
154
155     ret = krb5_domain_x500_decode(context, enc->transited.contents,
156                                   &realms, &num_realms,
157                                   enc->crealm,
158                                   ticket->realm);
159     if(ret)
160         return ret;
161     ret = krb5_check_transited(context, enc->crealm,
162                                ticket->realm,
163                                realms, num_realms, NULL);
164     for (n = 0; n < num_realms; n++)
165         free(realms[n]);
166     free(realms);
167     return ret;
168 }
169
170 static krb5_error_code
171 find_etypelist(krb5_context context,
172                krb5_auth_context auth_context,
173                EtypeList *etypes)
174 {
175     krb5_error_code ret;
176     krb5_data data;
177   
178     ret = _krb5_get_ad(context, auth_context->authenticator->authorization_data, NULL, KRB5_AUTHDATA_GSS_API_ETYPE_NEGOTIATION, &data);
179     if (ret)
180         return 0;
181     
182     ret = decode_EtypeList(data.data, data.length, etypes, NULL);
183     krb5_data_free(&data);
184     if (ret)
185         krb5_clear_error_message(context);
186     
187     return ret;
188 }
189
190 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
191 krb5_decrypt_ticket(krb5_context context,
192                     Ticket *ticket,
193                     krb5_keyblock *key,
194                     EncTicketPart *out,
195                     krb5_flags flags)
196 {
197     EncTicketPart t;
198     krb5_error_code ret;
199     ret = decrypt_tkt_enc_part (context, key, &ticket->enc_part, &t);
200     if (ret)
201         return ret;
202
203     {
204         krb5_timestamp now;
205         time_t start = t.authtime;
206
207         krb5_timeofday (context, &now);
208         if(t.starttime)
209             start = *t.starttime;
210         if(start - now > context->max_skew
211            || (t.flags.invalid
212                && !(flags & KRB5_VERIFY_AP_REQ_IGNORE_INVALID))) {
213             free_EncTicketPart(&t);
214             krb5_clear_error_message (context);
215             return KRB5KRB_AP_ERR_TKT_NYV;
216         }
217         if(now - t.endtime > context->max_skew) {
218             free_EncTicketPart(&t);
219             krb5_clear_error_message (context);
220             return KRB5KRB_AP_ERR_TKT_EXPIRED;
221         }
222
223         if(!t.flags.transited_policy_checked) {
224             ret = check_transited(context, ticket, &t);
225             if(ret) {
226                 free_EncTicketPart(&t);
227                 return ret;
228             }
229         }
230     }
231
232     if(out)
233         *out = t;
234     else
235         free_EncTicketPart(&t);
236     return 0;
237 }
238
239 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
240 krb5_verify_authenticator_checksum(krb5_context context,
241                                    krb5_auth_context ac,
242                                    void *data,
243                                    size_t len)
244 {
245     krb5_error_code ret;
246     krb5_keyblock *key = NULL;
247     krb5_authenticator authenticator;
248     krb5_crypto crypto;
249
250     ret = krb5_auth_con_getauthenticator(context, ac, &authenticator);
251     if (ret)
252         return ret;
253     if (authenticator->cksum == NULL) {
254         ret = -17;
255         goto out;
256     }
257     ret = krb5_auth_con_getkey(context, ac, &key);
258     if (ret)
259         goto out;
260     ret = krb5_crypto_init(context, key, 0, &crypto);
261     if (ret)
262         goto out;
263
264     _krb5_crypto_set_flags(context, crypto, KRB5_CRYPTO_FLAG_ALLOW_UNKEYED_CHECKSUM);
265     ret = krb5_verify_checksum(context, crypto,
266                                KRB5_KU_AP_REQ_AUTH_CKSUM,
267                                data, len, authenticator->cksum);
268     krb5_crypto_destroy(context, crypto);
269 out:
270     krb5_free_authenticator(context, &authenticator);
271     krb5_free_keyblock(context, key);
272     return ret;
273 }
274
275
276 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
277 krb5_verify_ap_req(krb5_context context,
278                    krb5_auth_context *auth_context,
279                    krb5_ap_req *ap_req,
280                    krb5_const_principal server,
281                    krb5_keyblock *keyblock,
282                    krb5_flags flags,
283                    krb5_flags *ap_req_options,
284                    krb5_ticket **ticket)
285 {
286     return krb5_verify_ap_req2 (context,
287                                 auth_context,
288                                 ap_req,
289                                 server,
290                                 keyblock,
291                                 flags,
292                                 ap_req_options,
293                                 ticket,
294                                 KRB5_KU_AP_REQ_AUTH);
295 }
296
297 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
298 krb5_verify_ap_req2(krb5_context context,
299                     krb5_auth_context *auth_context,
300                     krb5_ap_req *ap_req,
301                     krb5_const_principal server,
302                     krb5_keyblock *keyblock,
303                     krb5_flags flags,
304                     krb5_flags *ap_req_options,
305                     krb5_ticket **ticket,
306                     krb5_key_usage usage)
307 {
308     krb5_ticket *t;
309     krb5_auth_context ac;
310     krb5_error_code ret;
311     EtypeList etypes;
312     int badaddr = 0;
313
314     memset(&etypes, 0, sizeof(etypes));
315
316     if (ticket)
317         *ticket = NULL;
318
319     if (auth_context && *auth_context) {
320         ac = *auth_context;
321     } else {
322         ret = krb5_auth_con_init (context, &ac);
323         if (ret)
324             return ret;
325     }
326
327     t = calloc(1, sizeof(*t));
328     if (t == NULL) {
329         ret = krb5_enomem(context);
330         goto out;
331     }
332
333     if (ap_req->ap_options.use_session_key && ac->keyblock){
334         ret = krb5_decrypt_ticket(context, &ap_req->ticket,
335                                   ac->keyblock,
336                                   &t->ticket,
337                                   flags);
338         krb5_free_keyblock(context, ac->keyblock);
339         ac->keyblock = NULL;
340     }else
341         ret = krb5_decrypt_ticket(context, &ap_req->ticket,
342                                   keyblock,
343                                   &t->ticket,
344                                   flags);
345
346     if(ret)
347         goto out;
348
349     ret = _krb5_principalname2krb5_principal(context,
350                                              &t->server,
351                                              ap_req->ticket.sname,
352                                              ap_req->ticket.realm);
353     if (ret) goto out;
354
355     ret = decrypt_authenticator (context,
356                                  &t->ticket.key,
357                                  &ap_req->authenticator,
358                                  ac->authenticator,
359                                  usage);
360     if (ret)
361         goto out;
362
363     {
364         krb5_principal p1, p2;
365         krb5_boolean res;
366
367         _krb5_principalname2krb5_principal(context,
368                                            &p1,
369                                            ac->authenticator->cname,
370                                            ac->authenticator->crealm);
371         _krb5_principalname2krb5_principal(context,
372                                            &p2,
373                                            t->ticket.cname,
374                                            t->ticket.crealm);
375         res = krb5_principal_compare (context, p1, p2);
376         krb5_free_principal (context, p1);
377         krb5_free_principal (context, p2);
378         if (!res) {
379             ret = KRB5KRB_AP_ERR_BADMATCH;
380             krb5_clear_error_message (context);
381             goto out;
382         }
383     }
384
385     /*
386      * The ticket authenticates the client, and conveys naming attributes that
387      * we want to expose in GSS using RFC6680 APIs.
388      *
389      * So we same the ticket enc-part in the client's krb5_principal object
390      * (note though that the session key will be absent in that copy of the
391      * ticket enc-part).
392      */
393     ret = _krb5_ticket2krb5_principal(context, &t->client, &t->ticket,
394                                       ac->authenticator->authorization_data);
395     if (ret) goto out;
396
397     t->client->nameattrs->peer_realm =
398         calloc(1, sizeof(t->client->nameattrs->peer_realm[0]));
399     if (t->client->nameattrs->peer_realm == NULL) {
400         ret = krb5_enomem(context);
401         goto out;
402     }
403     ret = copy_Realm(&ap_req->ticket.realm, t->client->nameattrs->peer_realm);
404     if (ret) goto out;
405
406     /* check addresses */
407
408     if (t->ticket.caddr
409         && ac->remote_address
410         && !krb5_address_search (context,
411                                  ac->remote_address,
412                                  t->ticket.caddr)) {
413         /*
414          * Hack alert.  If KRB5_VERIFY_AP_REQ_IGNORE_ADDRS and the client's
415          * address didn't check out then we'll return KRB5KRB_AP_ERR_BADADDR
416          * even on success, and we'll let the caller figure it out because
417          * `*ticket != NULL' or `*auth_context != NULL'.
418          */
419         if ((flags & KRB5_VERIFY_AP_REQ_IGNORE_ADDRS)) {
420             badaddr = 1;
421         } else {
422             ret = KRB5KRB_AP_ERR_BADADDR;
423             krb5_clear_error_message(context);
424             goto out;
425         }
426     }
427
428     /* check timestamp in authenticator */
429     {
430         krb5_timestamp now;
431
432         krb5_timeofday (context, &now);
433
434         if (krb5_time_abs(ac->authenticator->ctime, now) > context->max_skew) {
435             ret = KRB5KRB_AP_ERR_SKEW;
436             krb5_clear_error_message (context);
437             goto out;
438         }
439     }
440
441     if (ac->authenticator->seq_number)
442         krb5_auth_con_setremoteseqnumber(context, ac,
443                                          *ac->authenticator->seq_number);
444
445     /* XXX - Xor sequence numbers */
446
447     if (ac->authenticator->subkey) {
448         ret = krb5_auth_con_setremotesubkey(context, ac,
449                                             ac->authenticator->subkey);
450         if (ret)
451             goto out;
452     }
453
454     ret = find_etypelist(context, ac, &etypes);
455     if (ret)
456         goto out;
457
458     ac->keytype = ETYPE_NULL;
459
460     if (etypes.val) {
461         size_t i;
462
463         for (i = 0; i < etypes.len; i++) {
464             if (krb5_enctype_valid(context, etypes.val[i]) == 0) {
465                 ac->keytype = etypes.val[i];
466                 break;
467             }
468         }
469     }
470
471     /* save key */
472     ret = krb5_copy_keyblock(context, &t->ticket.key, &ac->keyblock);
473     if (ret) goto out;
474
475     if (ap_req_options) {
476         *ap_req_options = 0;
477         if (ac->keytype != ETYPE_NULL)
478             *ap_req_options |= AP_OPTS_USE_SUBKEY;
479         if (ap_req->ap_options.use_session_key)
480             *ap_req_options |= AP_OPTS_USE_SESSION_KEY;
481         if (ap_req->ap_options.mutual_required)
482             *ap_req_options |= AP_OPTS_MUTUAL_REQUIRED;
483     }
484
485     if(ticket)
486         *ticket = t;
487     else
488         krb5_free_ticket (context, t);
489     if (auth_context) {
490         if (*auth_context == NULL)
491             *auth_context = ac;
492     } else
493         krb5_auth_con_free (context, ac);
494     free_EtypeList(&etypes);
495
496     if (badaddr) {
497         krb5_clear_error_message(context);
498         return KRB5KRB_AP_ERR_BADADDR;
499     }
500     return 0;
501  out:
502     free_EtypeList(&etypes);
503     if (t)
504         krb5_free_ticket (context, t);
505     if (auth_context == NULL || *auth_context == NULL)
506         krb5_auth_con_free (context, ac);
507     return ret;
508 }
509
510 /*
511  *
512  */
513
514 struct krb5_rd_req_in_ctx_data {
515     krb5_keytab keytab;
516     krb5_keyblock *keyblock;
517     krb5_boolean check_pac;
518     krb5_flags verify_ap_req_flags;
519 };
520
521 struct krb5_rd_req_out_ctx_data {
522     krb5_keyblock *keyblock;
523     krb5_flags ap_req_options;
524     krb5_ticket *ticket;
525     krb5_principal server;
526 };
527
528 /**
529  * Allocate a krb5_rd_req_in_ctx as an input parameter to
530  * krb5_rd_req_ctx(). The caller should free the context with
531  * krb5_rd_req_in_ctx_free() when done with the context.
532  *
533  * @param context Keberos 5 context.
534  * @param ctx in ctx to krb5_rd_req_ctx().
535  *
536  * @return Kerberos 5 error code, see krb5_get_error_message().
537  *
538  * @ingroup krb5_auth
539  */
540
541 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
542 krb5_rd_req_in_ctx_alloc(krb5_context context, krb5_rd_req_in_ctx *ctx)
543 {
544     *ctx = calloc(1, sizeof(**ctx));
545     if (*ctx == NULL)
546         return krb5_enomem(context);
547     (*ctx)->check_pac = (context->flags & KRB5_CTX_F_CHECK_PAC) ? 1 : 0;
548     return 0;
549 }
550
551 /**
552  * Set the keytab that krb5_rd_req_ctx() will use.
553  *
554  * @param context Keberos 5 context.
555  * @param in in ctx to krb5_rd_req_ctx().
556  * @param keytab keytab that krb5_rd_req_ctx() will use, only copy the
557  *        pointer, so the caller must free they keytab after
558  *        krb5_rd_req_in_ctx_free() is called.
559  *
560  * @return Kerberos 5 error code, see krb5_get_error_message().
561  *
562  * @ingroup krb5_auth
563  */
564
565 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
566 krb5_rd_req_in_set_keytab(krb5_context context,
567                           krb5_rd_req_in_ctx in,
568                           krb5_keytab keytab)
569 {
570     in->keytab = keytab;
571     return 0;
572 }
573
574 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
575 krb5_rd_req_in_set_verify_ap_req_flags(krb5_context context,
576                              krb5_rd_req_in_ctx in,
577                              krb5_flags flags)
578 {
579     in->verify_ap_req_flags = flags;
580     return 0;
581 }
582
583 /**
584  * Set if krb5_rq_red() is going to check the Windows PAC or not
585  *
586  * @param context Keberos 5 context.
587  * @param in krb5_rd_req_in_ctx to check the option on.
588  * @param flag flag to select if to check the pac (TRUE) or not (FALSE).
589  *
590  * @return Kerberos 5 error code, see krb5_get_error_message().
591  *
592  * @ingroup krb5_auth
593  */
594
595 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
596 krb5_rd_req_in_set_pac_check(krb5_context context,
597                              krb5_rd_req_in_ctx in,
598                              krb5_boolean flag)
599 {
600     in->check_pac = flag;
601     return 0;
602 }
603
604
605 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
606 krb5_rd_req_in_set_keyblock(krb5_context context,
607                             krb5_rd_req_in_ctx in,
608                             krb5_keyblock *keyblock)
609 {
610     in->keyblock = keyblock; /* XXX should make copy */
611     return 0;
612 }
613
614 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
615 krb5_rd_req_out_get_ap_req_options(krb5_context context,
616                                    krb5_rd_req_out_ctx out,
617                                    krb5_flags *ap_req_options)
618 {
619     *ap_req_options = out->ap_req_options;
620     return 0;
621 }
622
623 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
624 krb5_rd_req_out_get_ticket(krb5_context context,
625                             krb5_rd_req_out_ctx out,
626                             krb5_ticket **ticket)
627 {
628     return krb5_copy_ticket(context, out->ticket, ticket);
629 }
630
631 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
632 krb5_rd_req_out_get_keyblock(krb5_context context,
633                             krb5_rd_req_out_ctx out,
634                             krb5_keyblock **keyblock)
635 {
636     return krb5_copy_keyblock(context, out->keyblock, keyblock);
637 }
638
639 /**
640  * Get the principal that was used in the request from the
641  * client. Might not match whats in the ticket if krb5_rd_req_ctx()
642  * searched in the keytab for a matching key.
643  *
644  * @param context a Kerberos 5 context.
645  * @param out a krb5_rd_req_out_ctx from krb5_rd_req_ctx().
646  * @param principal return principal, free with krb5_free_principal().
647  *
648  * @ingroup krb5_auth
649  */
650
651 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
652 krb5_rd_req_out_get_server(krb5_context context,
653                             krb5_rd_req_out_ctx out,
654                             krb5_principal *principal)
655 {
656     return krb5_copy_principal(context, out->server, principal);
657 }
658
659 KRB5_LIB_FUNCTION void KRB5_LIB_CALL
660 krb5_rd_req_in_ctx_free(krb5_context context, krb5_rd_req_in_ctx ctx)
661 {
662     free(ctx);
663 }
664
665 /**
666  * Free the krb5_rd_req_out_ctx.
667  *
668  * @param context Keberos 5 context.
669  * @param ctx krb5_rd_req_out_ctx context to free.
670  *
671  * @ingroup krb5_auth
672  */
673
674 KRB5_LIB_FUNCTION void KRB5_LIB_CALL
675 krb5_rd_req_out_ctx_free(krb5_context context, krb5_rd_req_out_ctx ctx)
676 {
677     if (ctx->ticket)
678         krb5_free_ticket(context, ctx->ticket);
679     if (ctx->keyblock)
680         krb5_free_keyblock(context, ctx->keyblock);
681     if (ctx->server)
682         krb5_free_principal(context, ctx->server);
683     free(ctx);
684 }
685
686 /**
687  * Process an AP_REQ message.
688  *
689  * @param context        Kerberos 5 context.
690  * @param auth_context   authentication context of the peer.
691  * @param inbuf          the AP_REQ message, obtained for example with krb5_read_message().
692  * @param server         server principal.
693  * @param keytab         server keytab.
694  * @param ap_req_options set to the AP_REQ options. See the AP_OPTS_* defines.
695  * @param ticket         on success, set to the authenticated client credentials.
696  *                       Must be deallocated with krb5_free_ticket(). If not
697  *                       interested, pass a NULL value.
698  *
699  * @return 0 to indicate success. Otherwise a Kerberos error code is
700  *         returned, see krb5_get_error_message().
701  */
702 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
703 krb5_rd_req(krb5_context context,
704             krb5_auth_context *auth_context,
705             const krb5_data *inbuf,
706             krb5_const_principal server,
707             krb5_keytab keytab,
708             krb5_flags *ap_req_options,
709             krb5_ticket **ticket)
710 {
711     krb5_error_code ret;
712     krb5_rd_req_in_ctx in;
713     krb5_rd_req_out_ctx out;
714
715     ret = krb5_rd_req_in_ctx_alloc(context, &in);
716     if (ret)
717         return ret;
718
719     ret = krb5_rd_req_in_set_keytab(context, in, keytab);
720     if (ret) {
721         krb5_rd_req_in_ctx_free(context, in);
722         return ret;
723     }
724
725     ret = krb5_rd_req_ctx(context, auth_context, inbuf, server, in, &out);
726     krb5_rd_req_in_ctx_free(context, in);
727     if (ret)
728         return ret;
729
730     if (ap_req_options)
731         *ap_req_options = out->ap_req_options;
732     if (ticket) {
733         ret = krb5_copy_ticket(context, out->ticket, ticket);
734         if (ret)
735             goto out;
736     }
737
738 out:
739     krb5_rd_req_out_ctx_free(context, out);
740     return ret;
741 }
742
743 /*
744  *
745  */
746
747 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
748 krb5_rd_req_with_keyblock(krb5_context context,
749                           krb5_auth_context *auth_context,
750                           const krb5_data *inbuf,
751                           krb5_const_principal server,
752                           krb5_keyblock *keyblock,
753                           krb5_flags *ap_req_options,
754                           krb5_ticket **ticket)
755 {
756     krb5_error_code ret;
757     krb5_rd_req_in_ctx in;
758     krb5_rd_req_out_ctx out;
759
760     ret = krb5_rd_req_in_ctx_alloc(context, &in);
761     if (ret)
762         return ret;
763
764     ret = krb5_rd_req_in_set_keyblock(context, in, keyblock);
765     if (ret) {
766         krb5_rd_req_in_ctx_free(context, in);
767         return ret;
768     }
769
770     ret = krb5_rd_req_ctx(context, auth_context, inbuf, server, in, &out);
771     krb5_rd_req_in_ctx_free(context, in);
772     if (ret)
773         return ret;
774
775     if (ap_req_options)
776         *ap_req_options = out->ap_req_options;
777     if (ticket) {
778         ret = krb5_copy_ticket(context, out->ticket, ticket);
779         if (ret)
780             goto out;
781     }
782
783 out:
784     krb5_rd_req_out_ctx_free(context, out);
785     return ret;
786 }
787
788 /*
789  *
790  */
791
792 static krb5_error_code
793 get_key_from_keytab(krb5_context context,
794                     krb5_ap_req *ap_req,
795                     krb5_const_principal server,
796                     krb5_keytab keytab,
797                     krb5_keyblock **out_key)
798 {
799     krb5_keytab_entry entry;
800     krb5_error_code ret;
801     int kvno;
802     krb5_keytab real_keytab;
803
804     if(keytab == NULL)
805         krb5_kt_default(context, &real_keytab);
806     else
807         real_keytab = keytab;
808
809     if (ap_req->ticket.enc_part.kvno)
810         kvno = *ap_req->ticket.enc_part.kvno;
811     else
812         kvno = 0;
813
814     ret = krb5_kt_get_entry (context,
815                              real_keytab,
816                              server,
817                              kvno,
818                              ap_req->ticket.enc_part.etype,
819                              &entry);
820     if(ret == 0) {
821         ret = krb5_copy_keyblock(context, &entry.keyblock, out_key);
822         krb5_kt_free_entry(context, &entry);
823     }
824     if(keytab == NULL)
825         krb5_kt_close(context, real_keytab);
826
827     return ret;
828 }
829
830 /**
831  * The core server function that verify application authentication
832  * requests from clients.
833  *
834  * @param context Keberos 5 context.
835  * @param auth_context the authentication context, can be NULL, then
836  *        default values for the authentication context will used.
837  * @param inbuf the (AP-REQ) authentication buffer
838  *
839  * @param server the server to authenticate to. If NULL the function
840  *        will try to find any available credential in the keytab
841  *        that will verify the reply. The function will prefer the
842  *        server specified in the AP-REQ, but if
843  *        there is no mach, it will try all keytab entries for a
844  *        match. This has serious performance issues for large keytabs.
845  *
846  * @param inctx control the behavior of the function, if NULL, the
847  *        default behavior is used.
848  * @param outctx the return outctx, free with krb5_rd_req_out_ctx_free().
849  * @return Kerberos 5 error code, see krb5_get_error_message().
850  *
851  * @ingroup krb5_auth
852  */
853
854 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
855 krb5_rd_req_ctx(krb5_context context,
856                 krb5_auth_context *auth_context,
857                 const krb5_data *inbuf,
858                 krb5_const_principal server,
859                 krb5_rd_req_in_ctx inctx,
860                 krb5_rd_req_out_ctx *outctx)
861 {
862     krb5_error_code ret;
863     krb5_ap_req ap_req;
864     krb5_rd_req_out_ctx o = NULL;
865     krb5_keytab id = NULL, keytab = NULL;
866     krb5_principal service = NULL;
867     krb5_flags verify_ap_req_flags = 0;
868
869     if (outctx)
870         *outctx = NULL;
871
872     o = calloc(1, sizeof(*o));
873     if (o == NULL)
874         return krb5_enomem(context);
875
876     if (*auth_context == NULL) {
877         ret = krb5_auth_con_init(context, auth_context);
878         if (ret)
879             goto out;
880     }
881
882     ret = krb5_decode_ap_req(context, inbuf, &ap_req);
883     if(ret)
884         goto out;
885
886     /* Save the principal that was in the request */
887     ret = _krb5_principalname2krb5_principal(context,
888                                              &o->server,
889                                              ap_req.ticket.sname,
890                                              ap_req.ticket.realm);
891     if (ret)
892         goto out;
893
894     if (ap_req.ap_options.use_session_key &&
895         (*auth_context)->keyblock == NULL) {
896         ret = KRB5KRB_AP_ERR_NOKEY;
897         krb5_set_error_message(context, ret,
898                                N_("krb5_rd_req: user to user auth "
899                                   "without session key given", ""));
900         goto out;
901     }
902
903     if (inctx && inctx->keytab)
904         id = inctx->keytab;
905
906     if (inctx)
907         verify_ap_req_flags = inctx->verify_ap_req_flags;
908
909     if((*auth_context)->keyblock){
910         ret = krb5_copy_keyblock(context,
911                                  (*auth_context)->keyblock,
912                                  &o->keyblock);
913         if (ret)
914             goto out;
915     } else if(inctx && inctx->keyblock){
916         ret = krb5_copy_keyblock(context,
917                                  inctx->keyblock,
918                                  &o->keyblock);
919         if (ret)
920             goto out;
921     } else {
922
923         if(id == NULL) {
924             krb5_kt_default(context, &keytab);
925             id = keytab;
926         }
927         if (id == NULL)
928             goto out;
929
930         if (server == NULL) {
931             ret = _krb5_principalname2krb5_principal(context,
932                                                      &service,
933                                                      ap_req.ticket.sname,
934                                                      ap_req.ticket.realm);
935             if (ret)
936                 goto out;
937             server = service;
938         }
939
940         ret = get_key_from_keytab(context,
941                                   &ap_req,
942                                   server,
943                                   id,
944                                   &o->keyblock);
945         if (ret) {
946             /* If caller specified a server, fail. */
947             if (service == NULL && (context->flags & KRB5_CTX_F_RD_REQ_IGNORE) == 0)
948                 goto out;
949             /* Otherwise, fall back to iterating over the keytab. This
950              * have serious performace issues for larger keytab.
951              */
952             o->keyblock = NULL;
953         }
954     }
955
956     if (o->keyblock) {
957         /*
958          * We got an exact keymatch, use that.
959          */
960
961         ret = krb5_verify_ap_req2(context,
962                                   auth_context,
963                                   &ap_req,
964                                   server,
965                                   o->keyblock,
966                                   verify_ap_req_flags,
967                                   &o->ap_req_options,
968                                   &o->ticket,
969                                   KRB5_KU_AP_REQ_AUTH);
970
971         if (ret)
972             goto out;
973
974     } else {
975         /*
976          * Interate over keytab to find a key that can decrypt the request.
977          */
978
979         krb5_keytab_entry entry;
980         krb5_kt_cursor cursor;
981         int done = 0, kvno = 0;
982
983         memset(&cursor, 0, sizeof(cursor));
984
985         if (ap_req.ticket.enc_part.kvno)
986             kvno = *ap_req.ticket.enc_part.kvno;
987
988         ret = krb5_kt_start_seq_get(context, id, &cursor);
989         if (ret)
990             goto out;
991
992         done = 0;
993         while (!done) {
994             krb5_principal p;
995
996             ret = krb5_kt_next_entry(context, id, &entry, &cursor);
997             if (ret) {
998                 _krb5_kt_principal_not_found(context, ret, id, o->server,
999                                              ap_req.ticket.enc_part.etype,
1000                                              kvno);
1001                 break;
1002             }
1003
1004             if (entry.keyblock.keytype != ap_req.ticket.enc_part.etype) {
1005                 krb5_kt_free_entry (context, &entry);
1006                 continue;
1007             }
1008
1009             ret = krb5_verify_ap_req2(context,
1010                                       auth_context,
1011                                       &ap_req,
1012                                       server,
1013                                       &entry.keyblock,
1014                                       verify_ap_req_flags,
1015                                       &o->ap_req_options,
1016                                       &o->ticket,
1017                                       KRB5_KU_AP_REQ_AUTH);
1018             if (ret) {
1019                 krb5_kt_free_entry (context, &entry);
1020                 continue;
1021             }
1022
1023             /*
1024              * Found a match, save the keyblock for PAC processing,
1025              * and update the service principal in the ticket to match
1026              * whatever is in the keytab.
1027              */
1028
1029             ret = krb5_copy_keyblock(context,
1030                                      &entry.keyblock,
1031                                      &o->keyblock);
1032             if (ret) {
1033                 krb5_kt_free_entry (context, &entry);
1034                 break;
1035             }
1036
1037             ret = krb5_copy_principal(context, entry.principal, &p);
1038             if (ret) {
1039                 krb5_kt_free_entry (context, &entry);
1040                 break;
1041             }
1042             krb5_free_principal(context, o->ticket->server);
1043             o->ticket->server = p;
1044
1045             krb5_kt_free_entry (context, &entry);
1046
1047             done = 1;
1048         }
1049         krb5_kt_end_seq_get (context, id, &cursor);
1050         if (ret)
1051             goto out;
1052     }
1053
1054     ret = krb5_ticket_get_authorization_data_type(context, o->ticket,
1055                                                   KRB5_AUTHDATA_KDC_ISSUED,
1056                                                   NULL);
1057     if (ret == 0)
1058         o->ticket->client->nameattrs->kdc_issued_verified = 1;
1059
1060     /* If there is a PAC, verify its server signature */
1061     if (inctx == NULL || inctx->check_pac) {
1062         krb5_pac pac;
1063         krb5_data data;
1064
1065         ret = krb5_ticket_get_authorization_data_type(context,
1066                                                       o->ticket,
1067                                                       KRB5_AUTHDATA_WIN2K_PAC,
1068                                                       &data);
1069         if (ret == 0) {
1070             ret = krb5_pac_parse(context, data.data, data.length, &pac);
1071             krb5_data_free(&data);
1072             if (ret)
1073                 goto out;
1074
1075             ret = krb5_pac_verify(context,
1076                                   pac,
1077                                   o->ticket->ticket.authtime,
1078                                   o->ticket->client,
1079                                   o->keyblock,
1080                                   NULL);
1081             if (ret == 0)
1082                 o->ticket->client->nameattrs->pac_verified = 1;
1083             if (ret == 0 && (context->flags & KRB5_CTX_F_REPORT_CANONICAL_CLIENT_NAME)) {
1084                 krb5_error_code ret2;
1085                 krb5_principal canon_name;
1086
1087                 ret2 = _krb5_pac_get_canon_principal(context, pac, &canon_name);
1088                 if (ret2 == 0) {
1089                     free_Realm(&o->ticket->client->realm);
1090                     free_PrincipalName(&o->ticket->client->name);
1091                     ret = copy_Realm(&canon_name->realm, &o->ticket->client->realm);
1092                     if (ret == 0)
1093                         ret = copy_PrincipalName(&canon_name->name, &o->ticket->client->name);
1094                     krb5_free_principal(context, canon_name);
1095                 } else if (ret2 != ENOENT)
1096                     ret = ret2;
1097             }
1098             if (ret) {
1099                 krb5_pac_free(context, pac);
1100                 goto out;
1101             }
1102             o->ticket->client->nameattrs->pac = pac;
1103         } else
1104           ret = 0;
1105     }
1106 out:
1107
1108     if (ret || outctx == NULL)
1109         krb5_rd_req_out_ctx_free(context, o);
1110     else
1111         *outctx = o;
1112
1113     free_AP_REQ(&ap_req);
1114
1115     if (service)
1116         krb5_free_principal(context, service);
1117
1118     if (keytab)
1119         krb5_kt_close(context, keytab);
1120
1121     return ret;
1122 }