2 * Copyright (C) 2011-2014 Andreas Steffen
3 * HSR Hochschule fuer Technik Rapperswil
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License as published by the
7 * Free Software Foundation; either version 2 of the License, or (at your
8 * option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
12 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 #include "imc_os_state.h"
18 #include <imc/imc_agent.h>
19 #include <imc/imc_msg.h>
20 #include <imc/imc_os_info.h>
21 #include <ietf/ietf_attr.h>
22 #include <ietf/ietf_attr_attr_request.h>
23 #include <ietf/ietf_attr_default_pwd_enabled.h>
24 #include <ietf/ietf_attr_fwd_enabled.h>
25 #include <ietf/ietf_attr_installed_packages.h>
26 #include <ietf/ietf_attr_numeric_version.h>
27 #include <ietf/ietf_attr_op_status.h>
28 #include <ietf/ietf_attr_product_info.h>
29 #include <ietf/ietf_attr_string_version.h>
30 #include <ita/ita_attr.h>
31 #include <ita/ita_attr_get_settings.h>
32 #include <ita/ita_attr_settings.h>
33 #include <ita/ita_attr_angel.h>
34 #include <ita/ita_attr_device_id.h>
36 #include <tncif_pa_subtypes.h>
39 #include <utils/debug.h>
43 static const char imc_name
[] = "OS";
45 static pen_type_t msg_types
[] = {
46 { PEN_IETF
, PA_SUBTYPE_IETF_OPERATING_SYSTEM
}
49 static imc_agent_t
*imc_os
;
50 static imc_os_info_t
*os
;
53 * see section 3.8.1 of TCG TNC IF-IMC Specification 1.3
55 TNC_Result TNC_IMC_API
TNC_IMC_Initialize(TNC_IMCID imc_id
,
56 TNC_Version min_version
,
57 TNC_Version max_version
,
58 TNC_Version
*actual_version
)
62 DBG1(DBG_IMC
, "IMC \"%s\" has already been initialized", imc_name
);
63 return TNC_RESULT_ALREADY_INITIALIZED
;
65 imc_os
= imc_agent_create(imc_name
, msg_types
, countof(msg_types
),
66 imc_id
, actual_version
);
69 return TNC_RESULT_FATAL
;
72 os
= imc_os_info_create();
75 imc_os
->destroy(imc_os
);
78 return TNC_RESULT_FATAL
;
81 if (min_version
> TNC_IFIMC_VERSION_1
|| max_version
< TNC_IFIMC_VERSION_1
)
83 DBG1(DBG_IMC
, "no common IF-IMC version");
84 return TNC_RESULT_NO_COMMON_VERSION
;
86 return TNC_RESULT_SUCCESS
;
90 * see section 3.8.2 of TCG TNC IF-IMC Specification 1.3
92 TNC_Result TNC_IMC_API
TNC_IMC_NotifyConnectionChange(TNC_IMCID imc_id
,
93 TNC_ConnectionID connection_id
, TNC_ConnectionState new_state
)
99 DBG1(DBG_IMC
, "IMC \"%s\" has not been initialized", imc_name
);
100 return TNC_RESULT_NOT_INITIALIZED
;
104 case TNC_CONNECTION_STATE_CREATE
:
105 state
= imc_os_state_create(connection_id
);
106 return imc_os
->create_state(imc_os
, state
);
107 case TNC_CONNECTION_STATE_HANDSHAKE
:
108 if (imc_os
->change_state(imc_os
, connection_id
, new_state
,
109 &state
) != TNC_RESULT_SUCCESS
)
111 return TNC_RESULT_FATAL
;
113 state
->set_result(state
, imc_id
,
114 TNC_IMV_EVALUATION_RESULT_DONT_KNOW
);
115 return TNC_RESULT_SUCCESS
;
116 case TNC_CONNECTION_STATE_DELETE
:
117 return imc_os
->delete_state(imc_os
, connection_id
);
119 return imc_os
->change_state(imc_os
, connection_id
,
125 * Add IETF Product Information attribute to the send queue
127 static void add_product_info(imc_msg_t
*msg
)
131 pen_t vendor_id
= PEN_IETF
;
134 typedef struct vendor_pen_t
{
139 vendor_pen_t vendor_pens
[] = {
140 { OS_TYPE_DEBIAN
, PEN_DEBIAN
},
141 { OS_TYPE_UBUNTU
, PEN_CANONICAL
},
142 { OS_TYPE_FEDORA
, PEN_FEDORA
},
143 { OS_TYPE_REDHAT
, PEN_REDHAT
},
144 { OS_TYPE_ANDROID
, PEN_GOOGLE
}
147 os_type
= os
->get_type(os
);
148 for (i
= 0; i
< countof(vendor_pens
); i
++)
150 if (os_type
== vendor_pens
[i
].os_type
)
152 vendor_id
= vendor_pens
[i
].pen
;
156 attr
= ietf_attr_product_info_create(vendor_id
, 0, os
->get_name(os
));
157 msg
->add_attribute(msg
, attr
);
161 * Add IETF Numeric Version attribute to the send queue
163 static void add_numeric_version(imc_msg_t
*msg
)
166 u_int32_t major
, minor
;
168 os
->get_numeric_version(os
, &major
, &minor
);
169 DBG1(DBG_IMC
, "operating system numeric version is %d.%d",
172 attr
= ietf_attr_numeric_version_create(major
, minor
, 0, 0, 0);
173 msg
->add_attribute(msg
, attr
);
177 * Add IETF String Version attribute to the send queue
179 static void add_string_version(imc_msg_t
*msg
)
183 attr
= ietf_attr_string_version_create(os
->get_version(os
),
184 chunk_empty
, chunk_empty
);
185 msg
->add_attribute(msg
, attr
);
189 * Add IETF Operational Status attribute to the send queue
191 static void add_op_status(imc_msg_t
*msg
)
194 time_t uptime
, last_boot
;
196 uptime
= os
->get_uptime(os
);
197 last_boot
= uptime ?
time(NULL
) - uptime
: UNDEFINED_TIME
;
198 if (last_boot
!= UNDEFINED_TIME
)
200 DBG1(DBG_IMC
, "last boot: %T, %u s ago", &last_boot
, TRUE
, uptime
);
202 attr
= ietf_attr_op_status_create(OP_STATUS_OPERATIONAL
,
203 OP_RESULT_SUCCESSFUL
, last_boot
);
204 msg
->add_attribute(msg
, attr
);
208 * Add IETF Forwarding Enabled attribute to the send queue
210 static void add_fwd_enabled(imc_msg_t
*msg
)
213 os_fwd_status_t fwd_status
;
215 fwd_status
= os
->get_fwd_status(os
);
216 DBG1(DBG_IMC
, "IPv4 forwarding is %N",
217 os_fwd_status_names
, fwd_status
);
218 attr
= ietf_attr_fwd_enabled_create(fwd_status
);
219 msg
->add_attribute(msg
, attr
);
223 * Add IETF Factory Default Password Enabled attribute to the send queue
225 static void add_default_pwd_enabled(imc_msg_t
*msg
)
229 DBG1(DBG_IMC
, "factory default password is disabled");
230 attr
= ietf_attr_default_pwd_enabled_create(FALSE
);
231 msg
->add_attribute(msg
, attr
);
235 * Add ITA Device ID attribute to the send queue
237 static void add_device_id(imc_msg_t
*msg
)
240 chunk_t value
= chunk_empty
, keyid
;
241 char *name
, *device_id
, *cert_path
;
242 certificate_t
*cert
= NULL
;
243 public_key_t
*pubkey
;
245 /* Get the device ID as a character string */
246 device_id
= lib
->settings
->get_str(lib
->settings
,
247 "%s.plugins.imc-os.device_id", NULL
, lib
->ns
);
250 value
= chunk_clone(chunk_from_str(device_id
));
255 /* Derive the device ID from a raw public key */
256 cert_path
= lib
->settings
->get_str(lib
->settings
,
257 "%s.plugins.imc-os.device_pubkey", NULL
, lib
->ns
);
260 cert
= lib
->creds
->create(lib
->creds
, CRED_CERTIFICATE
,
261 CERT_TRUSTED_PUBKEY
, BUILD_FROM_FILE
,
262 cert_path
, BUILD_END
);
265 DBG2(DBG_IMC
, "loaded device public key from '%s'", cert_path
);
269 DBG1(DBG_IMC
, "loading device public key from '%s' failed",
276 /* Derive the device ID from the public key contained in a certificate */
277 cert_path
= lib
->settings
->get_str(lib
->settings
,
278 "%s.plugins.imc-os.device_cert", NULL
, lib
->ns
);
281 cert
= lib
->creds
->create(lib
->creds
, CRED_CERTIFICATE
,
282 CERT_X509
, BUILD_FROM_FILE
,
283 cert_path
, BUILD_END
);
286 DBG2(DBG_IMC
, "loaded device certificate from '%s'", cert_path
);
290 DBG1(DBG_IMC
, "loading device certificate from '%s' failed",
296 /* Compute the SHA-1 keyid of the retrieved device public key */
299 pubkey
= cert
->get_public_key(cert
);
302 if (pubkey
->get_fingerprint(pubkey
, KEYID_PUBKEY_INFO_SHA1
,
305 value
= chunk_to_hex(keyid
, NULL
, FALSE
);
307 pubkey
->destroy(pubkey
);
315 /* Derive the device ID from some unique OS settings */
316 name
= os
->get_type(os
) == OS_TYPE_ANDROID ?
317 "android_id" : "/var/lib/dbus/machine-id";
318 value
= os
->get_setting(os
, name
);
320 /* Trim trailing newline character */
321 if (value
.len
> 0 && value
.ptr
[value
.len
- 1] == '\n')
329 DBG1(DBG_IMC
, "no device ID available");
333 DBG1(DBG_IMC
, "device ID is %.*s", value
.len
, value
.ptr
);
334 attr
= ita_attr_device_id_create(value
);
335 msg
->add_attribute(msg
, attr
);
340 * Add an IETF Installed Packages attribute to the send queue
342 static void add_installed_packages(imc_state_t
*state
, imc_msg_t
*msg
)
344 pa_tnc_attr_t
*attr
= NULL
, *attr_angel
;
345 ietf_attr_installed_packages_t
*attr_cast
;
346 enumerator_t
*enumerator
;
347 chunk_t name
, version
;
348 size_t max_attr_size
, attr_size
, entry_size
;
352 * Compute the maximum IETF Installed Packages attribute size
353 * leaving space for an additional ITA Angel attribute
355 max_attr_size
= state
->get_max_msg_len(state
) -
356 PA_TNC_HEADER_SIZE
- PA_TNC_ATTR_HEADER_SIZE
;
358 /* At least one IETF Installed Packages attribute is sent */
359 attr
= ietf_attr_installed_packages_create();
360 attr_size
= PA_TNC_ATTR_HEADER_SIZE
+ IETF_INSTALLED_PACKAGES_MIN_SIZE
;
362 enumerator
= os
->create_package_enumerator(os
);
365 while (enumerator
->enumerate(enumerator
, &name
, &version
))
367 DBG2(DBG_IMC
, "package '%.*s' (%.*s)",
368 name
.len
, name
.ptr
, version
.len
, version
.ptr
);
370 entry_size
= 2 + name
.len
+ version
.len
;
371 if (attr_size
+ entry_size
> max_attr_size
)
376 * Send an ITA Start Angel attribute to the IMV signalling
377 * that multiple ITA Installed Package attributes follow.
379 attr_angel
= ita_attr_angel_create(TRUE
);
380 msg
->add_attribute(msg
, attr_angel
);
383 msg
->add_attribute(msg
, attr
);
385 /* create the next IETF Installed Packages attribute */
386 attr
= ietf_attr_installed_packages_create();
387 attr_size
= PA_TNC_ATTR_HEADER_SIZE
+
388 IETF_INSTALLED_PACKAGES_MIN_SIZE
;
390 attr_cast
= (ietf_attr_installed_packages_t
*)attr
;
391 attr_cast
->add(attr_cast
, name
, version
);
392 attr_size
+= entry_size
;
394 enumerator
->destroy(enumerator
);
396 msg
->add_attribute(msg
, attr
);
401 * If we sent an ITA Start Angel attribute in the first place,
402 * terminate by appending a matching ITA Stop Angel attribute.
404 attr_angel
= ita_attr_angel_create(FALSE
);
405 msg
->add_attribute(msg
, attr_angel
);
410 * Add ITA Settings attribute to the send queue
412 static void add_settings(enumerator_t
*enumerator
, imc_msg_t
*msg
)
414 pa_tnc_attr_t
*attr
= NULL
;
415 ita_attr_settings_t
*attr_cast
;
420 while (enumerator
->enumerate(enumerator
, &name
))
422 DBG1(DBG_IMC
, "setting '%s'", name
);
424 value
= os
->get_setting(os
, name
);
431 attr
= ita_attr_settings_create();
434 attr_cast
= (ita_attr_settings_t
*)attr
;
435 attr_cast
->add(attr_cast
, name
, value
);
441 msg
->add_attribute(msg
, attr
);
446 * see section 3.8.3 of TCG TNC IF-IMC Specification 1.3
448 TNC_Result TNC_IMC_API
TNC_IMC_BeginHandshake(TNC_IMCID imc_id
,
449 TNC_ConnectionID connection_id
)
453 TNC_Result result
= TNC_RESULT_SUCCESS
;
457 DBG1(DBG_IMC
, "IMC \"%s\" has not been initialized", imc_name
);
458 return TNC_RESULT_NOT_INITIALIZED
;
460 if (!imc_os
->get_state(imc_os
, connection_id
, &state
))
462 return TNC_RESULT_FATAL
;
464 if (lib
->settings
->get_bool(lib
->settings
,
465 "%s.plugins.imc-os.push_info", TRUE
, lib
->ns
))
467 out_msg
= imc_msg_create(imc_os
, state
, connection_id
, imc_id
,
468 TNC_IMVID_ANY
, msg_types
[0]);
469 add_product_info(out_msg
);
470 add_string_version(out_msg
);
471 add_numeric_version(out_msg
);
472 add_op_status(out_msg
);
473 add_fwd_enabled(out_msg
);
474 add_default_pwd_enabled(out_msg
);
475 add_device_id(out_msg
);
477 /* send PA-TNC message with the excl flag not set */
478 result
= out_msg
->send(out_msg
, FALSE
);
479 out_msg
->destroy(out_msg
);
485 static TNC_Result
receive_message(imc_state_t
*state
, imc_msg_t
*in_msg
)
488 enumerator_t
*enumerator
;
492 bool fatal_error
= FALSE
;
494 /* generate an outgoing PA-TNC message - we might need it */
495 out_msg
= imc_msg_create_as_reply(in_msg
);
497 /* parse received PA-TNC message and handle local and remote errors */
498 result
= in_msg
->receive(in_msg
, out_msg
, &fatal_error
);
499 if (result
!= TNC_RESULT_SUCCESS
)
501 out_msg
->destroy(out_msg
);
505 /* analyze PA-TNC attributes */
506 enumerator
= in_msg
->create_attribute_enumerator(in_msg
);
507 while (enumerator
->enumerate(enumerator
, &attr
))
509 type
= attr
->get_type(attr
);
511 if (type
.vendor_id
== PEN_IETF
)
513 if (type
.type
== IETF_ATTR_ATTRIBUTE_REQUEST
)
515 ietf_attr_attr_request_t
*attr_cast
;
519 attr_cast
= (ietf_attr_attr_request_t
*)attr
;
521 e
= attr_cast
->create_enumerator(attr_cast
);
522 while (e
->enumerate(e
, &entry
))
524 if (entry
->vendor_id
== PEN_IETF
)
528 case IETF_ATTR_PRODUCT_INFORMATION
:
529 add_product_info(out_msg
);
531 case IETF_ATTR_STRING_VERSION
:
532 add_string_version(out_msg
);
534 case IETF_ATTR_NUMERIC_VERSION
:
535 add_numeric_version(out_msg
);
537 case IETF_ATTR_OPERATIONAL_STATUS
:
538 add_op_status(out_msg
);
540 case IETF_ATTR_FORWARDING_ENABLED
:
541 add_fwd_enabled(out_msg
);
543 case IETF_ATTR_FACTORY_DEFAULT_PWD_ENABLED
:
544 add_default_pwd_enabled(out_msg
);
546 case IETF_ATTR_INSTALLED_PACKAGES
:
547 add_installed_packages(state
, out_msg
);
553 else if (entry
->vendor_id
== PEN_ITA
)
557 case ITA_ATTR_DEVICE_ID
:
558 add_device_id(out_msg
);
568 else if (type
.vendor_id
== PEN_ITA
&& type
.type
== ITA_ATTR_GET_SETTINGS
)
570 ita_attr_get_settings_t
*attr_cast
;
573 attr_cast
= (ita_attr_get_settings_t
*)attr
;
575 e
= attr_cast
->create_enumerator(attr_cast
);
576 add_settings(e
, out_msg
);
580 enumerator
->destroy(enumerator
);
584 result
= TNC_RESULT_FATAL
;
588 /* send PA-TNC message with the EXCL flag set */
589 result
= out_msg
->send(out_msg
, TRUE
);
591 out_msg
->destroy(out_msg
);
597 * see section 3.8.4 of TCG TNC IF-IMC Specification 1.3
600 TNC_Result TNC_IMC_API
TNC_IMC_ReceiveMessage(TNC_IMCID imc_id
,
601 TNC_ConnectionID connection_id
,
602 TNC_BufferReference msg
,
604 TNC_MessageType msg_type
)
612 DBG1(DBG_IMC
, "IMC \"%s\" has not been initialized", imc_name
);
613 return TNC_RESULT_NOT_INITIALIZED
;
615 if (!imc_os
->get_state(imc_os
, connection_id
, &state
))
617 return TNC_RESULT_FATAL
;
619 in_msg
= imc_msg_create_from_data(imc_os
, state
, connection_id
, msg_type
,
620 chunk_create(msg
, msg_len
));
621 result
= receive_message(state
, in_msg
);
622 in_msg
->destroy(in_msg
);
628 * see section 3.8.6 of TCG TNC IF-IMV Specification 1.3
630 TNC_Result TNC_IMC_API
TNC_IMC_ReceiveMessageLong(TNC_IMCID imc_id
,
631 TNC_ConnectionID connection_id
,
632 TNC_UInt32 msg_flags
,
633 TNC_BufferReference msg
,
635 TNC_VendorID msg_vid
,
636 TNC_MessageSubtype msg_subtype
,
637 TNC_UInt32 src_imv_id
,
638 TNC_UInt32 dst_imc_id
)
646 DBG1(DBG_IMC
, "IMC \"%s\" has not been initialized", imc_name
);
647 return TNC_RESULT_NOT_INITIALIZED
;
649 if (!imc_os
->get_state(imc_os
, connection_id
, &state
))
651 return TNC_RESULT_FATAL
;
653 in_msg
= imc_msg_create_from_long_data(imc_os
, state
, connection_id
,
654 src_imv_id
, dst_imc_id
,msg_vid
, msg_subtype
,
655 chunk_create(msg
, msg_len
));
656 result
=receive_message(state
, in_msg
);
657 in_msg
->destroy(in_msg
);
663 * see section 3.8.7 of TCG TNC IF-IMC Specification 1.3
665 TNC_Result TNC_IMC_API
TNC_IMC_BatchEnding(TNC_IMCID imc_id
,
666 TNC_ConnectionID connection_id
)
670 DBG1(DBG_IMC
, "IMC \"%s\" has not been initialized", imc_name
);
671 return TNC_RESULT_NOT_INITIALIZED
;
673 return TNC_RESULT_SUCCESS
;
677 * see section 3.8.8 of TCG TNC IF-IMC Specification 1.3
679 TNC_Result TNC_IMC_API
TNC_IMC_Terminate(TNC_IMCID imc_id
)
683 DBG1(DBG_IMC
, "IMC \"%s\" has not been initialized", imc_name
);
684 return TNC_RESULT_NOT_INITIALIZED
;
686 imc_os
->destroy(imc_os
);
692 return TNC_RESULT_SUCCESS
;
696 * see section 4.2.8.1 of TCG TNC IF-IMC Specification 1.3
698 TNC_Result TNC_IMC_API
TNC_IMC_ProvideBindFunction(TNC_IMCID imc_id
,
699 TNC_TNCC_BindFunctionPointer bind_function
)
703 DBG1(DBG_IMC
, "IMC \"%s\" has not been initialized", imc_name
);
704 return TNC_RESULT_NOT_INITIALIZED
;
706 return imc_os
->bind_functions(imc_os
, bind_function
);