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
31 #include "cifs_spnego.h"
33 const char *CIFSSPNEGO_VERSION = "1.3";
34 static const char *prog = "cifs.upcall";
35 typedef enum _sectype {
42 * given a process ID, get the value of the KRB5CCNAME environment variable
43 * in the context of that process. On error, just return NULL.
46 get_krb5_ccname(pid_t pid)
52 * FIXME: sysconf for ARG_MAX instead? Kernel seems to be limited to a
53 * page however, so it may not matter.
56 char *p, *value = NULL;
59 snprintf(buf, 4095, "/proc/%d/environ", pid);
60 fd = open(buf, O_RDONLY);
62 syslog(LOG_DEBUG, "%s: unable to open %s: %d", __func__, buf,
67 /* FIXME: don't assume that we get it all in the first read? */
68 len = read(fd, buf, 4096);
71 syslog(LOG_DEBUG, "%s: unable to read from /proc/%d/environ: "
72 "%d", __func__, pid, errno);
79 /* can't have valid KRB5CCNAME if there are < 13 bytes left */
81 if (strncmp("KRB5CCNAME=", p, 11)) {
82 p += strnlen(p, left);
89 value = SMB_STRNDUP(p, left);
92 syslog(LOG_DEBUG, "%s: KRB5CCNAME=%s", __func__,
93 value ? value : "(null)");
98 * Prepares AP-REQ data for mechToken and gets session key
99 * Uses credentials from cache. It will not ask for password
100 * you should receive credentials for yuor name manually using
101 * kinit or whatever you wish.
104 * oid - string with OID/ Could be OID_KERBEROS5
105 * or OID_KERBEROS5_OLD
106 * principal - Service name.
107 * Could be "cifs/FQDN" for KRB5 OID
108 * or for MS_KRB5 OID style server principal
109 * like "pdc$@YOUR.REALM.NAME"
112 * secblob - pointer for spnego wrapped AP-REQ data to be stored
113 * sess_key- pointer for SessionKey data to be stored
115 * ret: 0 - success, others - failure
118 handle_krb5_mech(const char *oid, const char *principal, DATA_BLOB *secblob,
119 DATA_BLOB *sess_key, const char *ccname)
122 DATA_BLOB tkt, tkt_wrapped;
124 syslog(LOG_DEBUG, "%s: getting service ticket for %s", __func__,
127 /* get a kerberos ticket for the service and extract the session key */
128 retval = cli_krb5_get_ticket(principal, 0, &tkt, sess_key, 0, ccname,
132 syslog(LOG_DEBUG, "%s: failed to obtain service ticket (%d)",
137 syslog(LOG_DEBUG, "%s: obtained service ticket", __func__);
139 /* wrap that up in a nice GSS-API wrapping */
140 tkt_wrapped = spnego_gen_krb5_wrap(tkt, TOK_ID_KRB_AP_REQ);
142 /* and wrap that in a shiny SPNEGO wrapper */
143 *secblob = gen_negTokenInit(oid, tkt_wrapped);
145 data_blob_free(&tkt_wrapped);
146 data_blob_free(&tkt);
150 #define DKD_HAVE_HOSTNAME 0x1
151 #define DKD_HAVE_VERSION 0x2
152 #define DKD_HAVE_SEC 0x4
153 #define DKD_HAVE_IP 0x8
154 #define DKD_HAVE_UID 0x10
155 #define DKD_HAVE_PID 0x20
156 #define DKD_MUSTHAVE_SET (DKD_HAVE_IP|DKD_HAVE_VERSION|DKD_HAVE_SEC)
158 static struct decoded_args {
168 decode_key_description(const char *desc, struct decoded_args *arg)
173 const char *tkn = desc;
176 pos = index(tkn, ';');
177 if (strncmp(tkn, "host=", 5) == 0) {
185 SAFE_FREE(arg->hostname);
186 arg->hostname = SMB_XMALLOC_ARRAY(char, len);
187 strlcpy(arg->hostname, tkn + 5, len);
188 retval |= DKD_HAVE_HOSTNAME;
189 } else if (!strncmp(tkn, "ip4=", 4) ||
190 !strncmp(tkn, "ip6=", 4)) {
198 arg->ip = SMB_XMALLOC_ARRAY(char, len);
199 strlcpy(arg->ip, tkn + 4, len);
200 retval |= DKD_HAVE_IP;
201 } else if (strncmp(tkn, "pid=", 4) == 0) {
203 arg->pid = strtol(tkn + 4, NULL, 0);
205 syslog(LOG_ERR, "Invalid pid format: %s",
209 retval |= DKD_HAVE_PID;
211 } else if (strncmp(tkn, "sec=", 4) == 0) {
212 if (strncmp(tkn + 4, "krb5", 4) == 0) {
213 retval |= DKD_HAVE_SEC;
215 } else if (strncmp(tkn + 4, "mskrb5", 6) == 0) {
216 retval |= DKD_HAVE_SEC;
219 } else if (strncmp(tkn, "uid=", 4) == 0) {
221 arg->uid = strtol(tkn + 4, NULL, 16);
223 syslog(LOG_ERR, "Invalid uid format: %s",
227 retval |= DKD_HAVE_UID;
229 } else if (strncmp(tkn, "ver=", 4) == 0) { /* if version */
231 arg->ver = strtol(tkn + 4, NULL, 16);
233 syslog(LOG_ERR, "Invalid version format: %s",
237 retval |= DKD_HAVE_VERSION;
248 cifs_resolver(const key_serial_t key, const char *key_descr)
251 struct addrinfo *addr;
252 char ip[INET6_ADDRSTRLEN];
254 const char *keyend = key_descr;
255 /* skip next 4 ';' delimiters to get to description */
256 for (c = 1; c <= 4; c++) {
257 keyend = index(keyend+1, ';');
259 syslog(LOG_ERR, "invalid key description: %s",
266 /* resolve name to ip */
267 c = getaddrinfo(keyend, NULL, NULL, &addr);
269 syslog(LOG_ERR, "unable to resolve hostname: %s [%s]",
270 keyend, gai_strerror(c));
274 /* conver ip to string form */
275 if (addr->ai_family == AF_INET)
276 p = &(((struct sockaddr_in *)addr->ai_addr)->sin_addr);
278 p = &(((struct sockaddr_in6 *)addr->ai_addr)->sin6_addr);
280 if (!inet_ntop(addr->ai_family, p, ip, sizeof(ip))) {
281 syslog(LOG_ERR, "%s: inet_ntop: %s", __func__, strerror(errno));
287 c = keyctl_instantiate(key, ip, strlen(ip)+1, 0);
289 syslog(LOG_ERR, "%s: keyctl_instantiate: %s", __func__,
300 * Older kernels sent IPv6 addresses without colons. Well, at least
301 * they're fixed-length strings. Convert these addresses to have colon
302 * delimiters to make getaddrinfo happy.
305 convert_inet6_addr(const char *from, char *to)
311 if (!(i++ % 4) && *from)
318 ip_to_fqdn(const char *addrstr, char *host, size_t hostlen)
321 struct addrinfo hints = { .ai_flags = AI_NUMERICHOST };
322 struct addrinfo *res;
323 const char *ipaddr = addrstr;
324 char converted[INET6_ADDRSTRLEN + 1];
326 if ((strlen(ipaddr) > INET_ADDRSTRLEN) && !strchr(ipaddr, ':')) {
327 convert_inet6_addr(ipaddr, converted);
331 rc = getaddrinfo(ipaddr, NULL, &hints, &res);
333 syslog(LOG_DEBUG, "%s: failed to resolve %s to "
334 "ipaddr: %s", __func__, ipaddr,
335 rc == EAI_SYSTEM ? strerror(errno) : gai_strerror(rc));
339 rc = getnameinfo(res->ai_addr, res->ai_addrlen, host, hostlen,
340 NULL, 0, NI_NAMEREQD);
343 syslog(LOG_DEBUG, "%s: failed to resolve %s to fqdn: %s",
345 rc == EAI_SYSTEM ? strerror(errno) : gai_strerror(rc));
349 syslog(LOG_DEBUG, "%s: resolved %s to %s", __func__, ipaddr, host);
356 syslog(LOG_INFO, "Usage: %s [-v] key_serial", prog);
357 fprintf(stderr, "Usage: %s [-v] key_serial\n", prog);
360 int main(const int argc, char *const argv[])
362 struct cifs_spnego_msg *keydata = NULL;
363 DATA_BLOB secblob = data_blob_null;
364 DATA_BLOB sess_key = data_blob_null;
365 key_serial_t key = 0;
370 char *buf, *princ, *ccname = NULL;
371 char hostbuf[NI_MAXHOST];
372 struct decoded_args arg = { };
375 openlog(prog, 0, LOG_DAEMON);
377 while ((c = getopt(argc, argv, "cv")) != -1) {
380 /* legacy option -- skip it */
383 printf("version: %s\n", CIFSSPNEGO_VERSION);
386 syslog(LOG_ERR, "unknown option: %c", c);
391 /* is there a key? */
392 if (argc <= optind) {
397 /* get key and keyring values */
399 key = strtol(argv[optind], NULL, 10);
402 syslog(LOG_ERR, "Invalid key format: %s", strerror(errno));
406 rc = keyctl_describe_alloc(key, &buf);
408 syslog(LOG_ERR, "keyctl_describe_alloc failed: %s",
414 syslog(LOG_DEBUG, "key description: %s", buf);
416 if ((strncmp(buf, "cifs.resolver", sizeof("cifs.resolver")-1) == 0) ||
417 (strncmp(buf, "dns_resolver", sizeof("dns_resolver")-1) == 0)) {
418 rc = cifs_resolver(key, buf);
422 have = decode_key_description(buf, &arg);
424 if ((have & DKD_MUSTHAVE_SET) != DKD_MUSTHAVE_SET) {
425 syslog(LOG_ERR, "unable to get necessary params from key "
426 "description (0x%x)", have);
431 if (arg.ver > CIFS_SPNEGO_UPCALL_VERSION) {
432 syslog(LOG_ERR, "incompatible kernel upcall version: 0x%x",
438 if (have & DKD_HAVE_UID) {
439 rc = setuid(arg.uid);
441 syslog(LOG_ERR, "setuid: %s", strerror(errno));
446 if (have & DKD_HAVE_PID)
447 ccname = get_krb5_ccname(arg.pid);
449 if (have & DKD_HAVE_IP) {
450 rc = ip_to_fqdn(arg.ip, hostbuf, sizeof(hostbuf));
455 // do mech specific authorization
459 /* for "cifs/" service name + terminating 0 */
460 datalen = strnlen(hostbuf, sizeof(hostbuf)) + 5 + 1;
461 princ = SMB_XMALLOC_ARRAY(char, datalen);
467 if (arg.sec == MS_KRB5)
468 oid = OID_KERBEROS5_OLD;
473 * try getting a cifs/ principal first and then fall back to
474 * getting a host/ principal if that doesn't work.
476 strlcpy(princ, "cifs/", datalen);
477 strlcpy(princ + 5, hostbuf, datalen - 5);
478 rc = handle_krb5_mech(oid, princ, &secblob, &sess_key, ccname);
480 memcpy(princ, "host/", 5);
481 rc = handle_krb5_mech(oid, princ, &secblob, &sess_key,
487 syslog(LOG_ERR, "sectype: %d is not implemented", arg.sec);
495 /* pack SecurityBLob and SessionKey into downcall packet */
497 sizeof(struct cifs_spnego_msg) + secblob.length + sess_key.length;
498 keydata = (struct cifs_spnego_msg*)SMB_XMALLOC_ARRAY(char, datalen);
503 keydata->version = arg.ver;
505 keydata->sesskey_len = sess_key.length;
506 keydata->secblob_len = secblob.length;
507 memcpy(&(keydata->data), sess_key.data, sess_key.length);
508 memcpy(&(keydata->data) + keydata->sesskey_len,
509 secblob.data, secblob.length);
512 rc = keyctl_instantiate(key, keydata, datalen, 0);
514 syslog(LOG_ERR, "keyctl_instantiate: %s", strerror(errno));
518 /* BB: maybe we need use timeout for key: for example no more then
519 * ticket lifietime? */
520 /* keyctl_set_timeout( key, 60); */
523 * on error, negatively instantiate the key ourselves so that we can
524 * make sure the kernel doesn't hang it off of a searchable keyring
525 * and interfere with the next attempt to instantiate the key.
527 if (rc != 0 && key == 0)
528 keyctl_negate(key, 1, KEY_REQKEY_DEFL_DEFAULT);
529 data_blob_free(&secblob);
530 data_blob_free(&sess_key);
532 SAFE_FREE(arg.hostname);