2 * CIFS user-space helper.
3 * Copyright (C) Igor Mammedov (niallain@gmail.com) 2007
4 * Copyright (C) Jeff Layton (jlayton@redhat.com) 2009
6 * Used by /sbin/request-key for handling
7 * cifs upcall for kerberos authorization of access to share and
8 * cifs upcall for DFS srver name resolving (IPv4/IPv6 aware).
9 * You should have keyutils installed and add something like the
10 * following lines to /etc/request-key.conf file:
12 create cifs.spnego * * /usr/local/sbin/cifs.upcall %k
13 create dns_resolver * * /usr/local/sbin/cifs.upcall %k
15 * This program is free software; you can redistribute it and/or modify
16 * it under the terms of the GNU General Public License as published by
17 * the Free Software Foundation; either version 2 of the License, or
18 * (at your option) any later version.
19 * This program is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
23 * You should have received a copy of the GNU General Public License
24 * along with this program; if not, write to the Free Software
25 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
29 #include "../libcli/auth/spnego.h"
34 #include "cifs_spnego.h"
36 #define CIFS_DEFAULT_KRB5_DIR "/tmp"
37 #define CIFS_DEFAULT_KRB5_PREFIX "krb5cc_"
39 #define MAX_CCNAME_LEN PATH_MAX + 5
41 const char *CIFSSPNEGO_VERSION
= "1.3";
42 static const char *prog
= "cifs.upcall";
43 typedef enum _sectype
{
49 /* does the ccache have a valid TGT? */
51 get_tgt_time(const char *ccname
) {
56 krb5_principal principal
;
61 if (krb5_init_context(&context
)) {
62 syslog(LOG_DEBUG
, "%s: unable to init krb5 context", __func__
);
66 if (krb5_cc_resolve(context
, ccname
, &ccache
)) {
67 syslog(LOG_DEBUG
, "%s: unable to resolve krb5 cache", __func__
);
71 if (krb5_cc_set_flags(context
, ccache
, 0)) {
72 syslog(LOG_DEBUG
, "%s: unable to set flags", __func__
);
76 if (krb5_cc_get_principal(context
, ccache
, &principal
)) {
77 syslog(LOG_DEBUG
, "%s: unable to get principal", __func__
);
81 if (krb5_cc_start_seq_get(context
, ccache
, &cur
)) {
82 syslog(LOG_DEBUG
, "%s: unable to seq start", __func__
);
86 if ((realm
= smb_krb5_principal_get_realm(context
, principal
)) == NULL
) {
87 syslog(LOG_DEBUG
, "%s: unable to get realm", __func__
);
91 mem_ctx
= talloc_init("cifs.upcall");
92 while (!credtime
&& !krb5_cc_next_cred(context
, ccache
, &cur
, &creds
)) {
94 if (smb_krb5_unparse_name(mem_ctx
, context
, creds
.server
, &name
)) {
95 syslog(LOG_DEBUG
, "%s: unable to unparse name", __func__
);
98 if (krb5_realm_compare(context
, creds
.server
, principal
) &&
99 strnequal(name
, KRB5_TGS_NAME
, KRB5_TGS_NAME_SIZE
) &&
100 strnequal(name
+KRB5_TGS_NAME_SIZE
+1, realm
, strlen(realm
)) &&
101 creds
.times
.endtime
> time(NULL
))
102 credtime
= creds
.times
.endtime
;
103 krb5_free_cred_contents(context
, &creds
);
107 TALLOC_FREE(mem_ctx
);
108 krb5_cc_end_seq_get(context
, ccache
, &cur
);
110 krb5_free_principal(context
, principal
);
112 #if defined(KRB5_TC_OPENCLOSE)
113 krb5_cc_set_flags(context
, ccache
, KRB5_TC_OPENCLOSE
);
115 krb5_cc_close(context
, ccache
);
117 krb5_free_context(context
);
122 krb5cc_filter(const struct dirent
*dirent
)
124 if (strstr(dirent
->d_name
, CIFS_DEFAULT_KRB5_PREFIX
))
130 /* search for a credcache that looks like a likely candidate */
132 find_krb5_cc(const char *dirname
, uid_t uid
)
134 struct dirent
**namelist
;
136 char ccname
[MAX_CCNAME_LEN
], *credpath
, *best_cache
= NULL
;
138 time_t cred_time
, best_time
= 0;
140 n
= scandir(dirname
, &namelist
, krb5cc_filter
, NULL
);
142 syslog(LOG_DEBUG
, "%s: scandir error on directory '%s': %s",
143 __func__
, dirname
, strerror(errno
));
147 for (i
= 0; i
< n
; i
++) {
148 snprintf(ccname
, sizeof(ccname
), "FILE:%s/%s", dirname
,
149 namelist
[i
]->d_name
);
150 credpath
= ccname
+ 5;
151 syslog(LOG_DEBUG
, "%s: considering %s", __func__
, credpath
);
153 if (lstat(credpath
, &sbuf
)) {
154 syslog(LOG_DEBUG
, "%s: stat error on '%s': %s",
155 __func__
, credpath
, strerror(errno
));
159 if (sbuf
.st_uid
!= uid
) {
160 syslog(LOG_DEBUG
, "%s: %s is owned by %u, not %u",
161 __func__
, credpath
, sbuf
.st_uid
, uid
);
165 if (!S_ISREG(sbuf
.st_mode
)) {
166 syslog(LOG_DEBUG
, "%s: %s is not a regular file",
171 if (!(cred_time
= get_tgt_time(ccname
))) {
172 syslog(LOG_DEBUG
, "%s: %s is not a valid credcache.",
178 if (cred_time
<= best_time
) {
179 syslog(LOG_DEBUG
, "%s: %s expires sooner than current "
180 "best.", __func__
, ccname
);
185 syslog(LOG_DEBUG
, "%s: %s is valid ccache", __func__
, ccname
);
187 best_cache
= SMB_STRNDUP(ccname
, MAX_CCNAME_LEN
);
188 best_time
= cred_time
;
197 * Prepares AP-REQ data for mechToken and gets session key
198 * Uses credentials from cache. It will not ask for password
199 * you should receive credentials for yuor name manually using
200 * kinit or whatever you wish.
203 * oid - string with OID/ Could be OID_KERBEROS5
204 * or OID_KERBEROS5_OLD
205 * principal - Service name.
206 * Could be "cifs/FQDN" for KRB5 OID
207 * or for MS_KRB5 OID style server principal
208 * like "pdc$@YOUR.REALM.NAME"
211 * secblob - pointer for spnego wrapped AP-REQ data to be stored
212 * sess_key- pointer for SessionKey data to be stored
214 * ret: 0 - success, others - failure
217 handle_krb5_mech(const char *oid
, const char *principal
, DATA_BLOB
*secblob
,
218 DATA_BLOB
*sess_key
, const char *ccname
)
221 DATA_BLOB tkt
, tkt_wrapped
;
223 syslog(LOG_DEBUG
, "%s: getting service ticket for %s", __func__
,
226 /* get a kerberos ticket for the service and extract the session key */
227 retval
= cli_krb5_get_ticket(principal
, 0, &tkt
, sess_key
, 0, ccname
,
231 syslog(LOG_DEBUG
, "%s: failed to obtain service ticket (%d)",
236 syslog(LOG_DEBUG
, "%s: obtained service ticket", __func__
);
238 /* wrap that up in a nice GSS-API wrapping */
239 tkt_wrapped
= spnego_gen_krb5_wrap(tkt
, TOK_ID_KRB_AP_REQ
);
241 /* and wrap that in a shiny SPNEGO wrapper */
242 *secblob
= gen_negTokenInit(oid
, tkt_wrapped
);
244 data_blob_free(&tkt_wrapped
);
245 data_blob_free(&tkt
);
249 #define DKD_HAVE_HOSTNAME 0x1
250 #define DKD_HAVE_VERSION 0x2
251 #define DKD_HAVE_SEC 0x4
252 #define DKD_HAVE_IP 0x8
253 #define DKD_HAVE_UID 0x10
254 #define DKD_HAVE_PID 0x20
255 #define DKD_MUSTHAVE_SET (DKD_HAVE_HOSTNAME|DKD_HAVE_VERSION|DKD_HAVE_SEC)
257 struct decoded_args
{
267 decode_key_description(const char *desc
, struct decoded_args
*arg
)
272 const char *tkn
= desc
;
275 pos
= index(tkn
, ';');
276 if (strncmp(tkn
, "host=", 5) == 0) {
284 SAFE_FREE(arg
->hostname
);
285 arg
->hostname
= SMB_XMALLOC_ARRAY(char, len
);
286 strlcpy(arg
->hostname
, tkn
+ 5, len
);
287 retval
|= DKD_HAVE_HOSTNAME
;
288 } else if (!strncmp(tkn
, "ip4=", 4) ||
289 !strncmp(tkn
, "ip6=", 4)) {
297 arg
->ip
= SMB_XMALLOC_ARRAY(char, len
);
298 strlcpy(arg
->ip
, tkn
+ 4, len
);
299 retval
|= DKD_HAVE_IP
;
300 } else if (strncmp(tkn
, "pid=", 4) == 0) {
302 arg
->pid
= strtol(tkn
+ 4, NULL
, 0);
304 syslog(LOG_ERR
, "Invalid pid format: %s",
308 retval
|= DKD_HAVE_PID
;
310 } else if (strncmp(tkn
, "sec=", 4) == 0) {
311 if (strncmp(tkn
+ 4, "krb5", 4) == 0) {
312 retval
|= DKD_HAVE_SEC
;
314 } else if (strncmp(tkn
+ 4, "mskrb5", 6) == 0) {
315 retval
|= DKD_HAVE_SEC
;
318 } else if (strncmp(tkn
, "uid=", 4) == 0) {
320 arg
->uid
= strtol(tkn
+ 4, NULL
, 16);
322 syslog(LOG_ERR
, "Invalid uid format: %s",
326 retval
|= DKD_HAVE_UID
;
328 } else if (strncmp(tkn
, "ver=", 4) == 0) { /* if version */
330 arg
->ver
= strtol(tkn
+ 4, NULL
, 16);
332 syslog(LOG_ERR
, "Invalid version format: %s",
336 retval
|= DKD_HAVE_VERSION
;
347 cifs_resolver(const key_serial_t key
, const char *key_descr
)
350 struct addrinfo
*addr
;
351 char ip
[INET6_ADDRSTRLEN
];
353 const char *keyend
= key_descr
;
354 /* skip next 4 ';' delimiters to get to description */
355 for (c
= 1; c
<= 4; c
++) {
356 keyend
= index(keyend
+1, ';');
358 syslog(LOG_ERR
, "invalid key description: %s",
365 /* resolve name to ip */
366 c
= getaddrinfo(keyend
, NULL
, NULL
, &addr
);
368 syslog(LOG_ERR
, "unable to resolve hostname: %s [%s]",
369 keyend
, gai_strerror(c
));
373 /* conver ip to string form */
374 if (addr
->ai_family
== AF_INET
)
375 p
= &(((struct sockaddr_in
*)addr
->ai_addr
)->sin_addr
);
377 p
= &(((struct sockaddr_in6
*)addr
->ai_addr
)->sin6_addr
);
379 if (!inet_ntop(addr
->ai_family
, p
, ip
, sizeof(ip
))) {
380 syslog(LOG_ERR
, "%s: inet_ntop: %s", __func__
, strerror(errno
));
386 c
= keyctl_instantiate(key
, ip
, strlen(ip
)+1, 0);
388 syslog(LOG_ERR
, "%s: keyctl_instantiate: %s", __func__
,
399 * Older kernels sent IPv6 addresses without colons. Well, at least
400 * they're fixed-length strings. Convert these addresses to have colon
401 * delimiters to make getaddrinfo happy.
404 convert_inet6_addr(const char *from
, char *to
)
410 if (!(i
++ % 4) && *from
)
417 ip_to_fqdn(const char *addrstr
, char *host
, size_t hostlen
)
420 struct addrinfo hints
= { .ai_flags
= AI_NUMERICHOST
};
421 struct addrinfo
*res
;
422 const char *ipaddr
= addrstr
;
423 char converted
[INET6_ADDRSTRLEN
+ 1];
425 if ((strlen(ipaddr
) > INET_ADDRSTRLEN
) && !strchr(ipaddr
, ':')) {
426 convert_inet6_addr(ipaddr
, converted
);
430 rc
= getaddrinfo(ipaddr
, NULL
, &hints
, &res
);
432 syslog(LOG_DEBUG
, "%s: failed to resolve %s to "
433 "ipaddr: %s", __func__
, ipaddr
,
434 rc
== EAI_SYSTEM
? strerror(errno
) : gai_strerror(rc
));
438 rc
= getnameinfo(res
->ai_addr
, res
->ai_addrlen
, host
, hostlen
,
439 NULL
, 0, NI_NAMEREQD
);
442 syslog(LOG_DEBUG
, "%s: failed to resolve %s to fqdn: %s",
444 rc
== EAI_SYSTEM
? strerror(errno
) : gai_strerror(rc
));
448 syslog(LOG_DEBUG
, "%s: resolved %s to %s", __func__
, ipaddr
, host
);
455 syslog(LOG_INFO
, "Usage: %s [-t] [-v] key_serial", prog
);
456 fprintf(stderr
, "Usage: %s [-t] [-v] key_serial\n", prog
);
459 const struct option long_options
[] = {
460 { "trust-dns", 0, NULL
, 't' },
461 { "version", 0, NULL
, 'v' },
465 int main(const int argc
, char *const argv
[])
467 struct cifs_spnego_msg
*keydata
= NULL
;
468 DATA_BLOB secblob
= data_blob_null
;
469 DATA_BLOB sess_key
= data_blob_null
;
470 key_serial_t key
= 0;
475 char *buf
, *princ
= NULL
, *ccname
= NULL
;
476 char hostbuf
[NI_MAXHOST
], *host
;
477 struct decoded_args arg
= { };
482 openlog(prog
, 0, LOG_DAEMON
);
484 while ((c
= getopt_long(argc
, argv
, "ctv", long_options
, NULL
)) != -1) {
487 /* legacy option -- skip it */
493 printf("version: %s\n", CIFSSPNEGO_VERSION
);
496 syslog(LOG_ERR
, "unknown option: %c", c
);
501 /* is there a key? */
502 if (argc
<= optind
) {
507 /* get key and keyring values */
509 key
= strtol(argv
[optind
], NULL
, 10);
512 syslog(LOG_ERR
, "Invalid key format: %s", strerror(errno
));
516 rc
= keyctl_describe_alloc(key
, &buf
);
518 syslog(LOG_ERR
, "keyctl_describe_alloc failed: %s",
524 syslog(LOG_DEBUG
, "key description: %s", buf
);
526 if ((strncmp(buf
, "cifs.resolver", sizeof("cifs.resolver")-1) == 0) ||
527 (strncmp(buf
, "dns_resolver", sizeof("dns_resolver")-1) == 0)) {
528 rc
= cifs_resolver(key
, buf
);
532 have
= decode_key_description(buf
, &arg
);
534 if ((have
& DKD_MUSTHAVE_SET
) != DKD_MUSTHAVE_SET
) {
535 syslog(LOG_ERR
, "unable to get necessary params from key "
536 "description (0x%x)", have
);
541 if (arg
.ver
> CIFS_SPNEGO_UPCALL_VERSION
) {
542 syslog(LOG_ERR
, "incompatible kernel upcall version: 0x%x",
548 if (have
& DKD_HAVE_UID
) {
549 rc
= setuid(arg
.uid
);
551 syslog(LOG_ERR
, "setuid: %s", strerror(errno
));
555 ccname
= find_krb5_cc(CIFS_DEFAULT_KRB5_DIR
, arg
.uid
);
560 // do mech specific authorization
565 /* for "cifs/" service name + terminating 0 */
566 datalen
= strlen(host
) + 5 + 1;
567 princ
= SMB_XMALLOC_ARRAY(char, datalen
);
573 if (arg
.sec
== MS_KRB5
)
574 oid
= OID_KERBEROS5_OLD
;
579 * try getting a cifs/ principal first and then fall back to
580 * getting a host/ principal if that doesn't work.
582 strlcpy(princ
, "cifs/", datalen
);
583 strlcpy(princ
+ 5, host
, datalen
- 5);
584 rc
= handle_krb5_mech(oid
, princ
, &secblob
, &sess_key
, ccname
);
588 memcpy(princ
, "host/", 5);
589 rc
= handle_krb5_mech(oid
, princ
, &secblob
, &sess_key
, ccname
);
593 if (!try_dns
|| !(have
& DKD_HAVE_IP
))
596 rc
= ip_to_fqdn(arg
.ip
, hostbuf
, sizeof(hostbuf
));
603 goto retry_new_hostname
;
605 syslog(LOG_ERR
, "sectype: %d is not implemented", arg
.sec
);
615 /* pack SecurityBLob and SessionKey into downcall packet */
617 sizeof(struct cifs_spnego_msg
) + secblob
.length
+ sess_key
.length
;
618 keydata
= (struct cifs_spnego_msg
*)SMB_XMALLOC_ARRAY(char, datalen
);
623 keydata
->version
= arg
.ver
;
625 keydata
->sesskey_len
= sess_key
.length
;
626 keydata
->secblob_len
= secblob
.length
;
627 memcpy(&(keydata
->data
), sess_key
.data
, sess_key
.length
);
628 memcpy(&(keydata
->data
) + keydata
->sesskey_len
,
629 secblob
.data
, secblob
.length
);
632 rc
= keyctl_instantiate(key
, keydata
, datalen
, 0);
634 syslog(LOG_ERR
, "keyctl_instantiate: %s", strerror(errno
));
638 /* BB: maybe we need use timeout for key: for example no more then
639 * ticket lifietime? */
640 /* keyctl_set_timeout( key, 60); */
643 * on error, negatively instantiate the key ourselves so that we can
644 * make sure the kernel doesn't hang it off of a searchable keyring
645 * and interfere with the next attempt to instantiate the key.
647 if (rc
!= 0 && key
== 0)
648 keyctl_negate(key
, 1, KEY_REQKEY_DEFL_DEFAULT
);
649 data_blob_free(&secblob
);
650 data_blob_free(&sess_key
);
652 SAFE_FREE(arg
.hostname
);