def post(self, bundle: TransactionBundle): """ Upgrade the response from a AdvertiseMessage to a ReplyMessage if appropriate :param bundle: The transaction bundle """ # Does this transaction even allow rapid commit? if not bundle.allow_rapid_commit: return # We only look for SolicitMessages that have a RapidCommitOption if not isinstance(bundle.request, SolicitMessage) or not bundle.request.get_option_of_type(RapidCommitOption): return # And only if the current response is an AdvertiseMessage if not isinstance(bundle.response, AdvertiseMessage): return # Ok, this looks promising, do extra checks if requested if not self.rapid_commit_rejections: # Ok, we don't want to rapid-commit rejections. Check for them. if bundle.get_unanswered_ia_options() or bundle.get_unanswered_iapd_options(): # Unhandled options. We are post-processing, so they are not going to be answered anymore return # Did we already refuse anything? ia_options = [option for option in bundle.response.options if isinstance(option, (IANAOption, IATAOption))] for option in ia_options: status = option.get_option_of_type(StatusCodeOption) if status and status.status_code == STATUS_NOADDRSAVAIL: # Refusal: don't do anything return iapd_options = [option for option in bundle.response.options if isinstance(option, IAPDOption)] for option in iapd_options: status = option.get_option_of_type(StatusCodeOption) if status and status.status_code == STATUS_NOPREFIXAVAIL: # Refusal: don't do anything return # It seems the request and response qualify: upgrade to ReplyMessage bundle.response = ReplyMessage(bundle.response.transaction_id, [RapidCommitOption()] + bundle.response.options)
def handle(self, bundle: TransactionBundle): """ Make sure that every :class:`.IANAOption` and :class:`.IATAOption` is answered. :param bundle: The transaction bundle """ for option in bundle.get_unanswered_ia_options(): ia_class = type(option) if isinstance(bundle.request, (SolicitMessage, RequestMessage)): # If the server will not assign any addresses to any IAs in a subsequent Request from the client, the # server MUST send an Advertise message to the client that includes only a Status Code option with code # NoAddrsAvail and a status message for the user # # We do the same for unanswered requests bundle.response.options.append(ia_class(option.iaid, options=[ StatusCodeOption(STATUS_NOADDRSAVAIL, "No addresses available") ])) elif isinstance(bundle.request, ConfirmMessage): # When the server receives a Confirm message, the server determines whether the addresses in the # Confirm message are appropriate for the link to which the client is attached. If all of the # addresses in the Confirm message pass this test, the server returns a status of Success. If any of # the addresses do not pass this test, the server returns a status of NotOnLink. If the server is # unable to perform this test (for example, the server does not have information about prefixes on the # link to which the client is connected), or there were no addresses in any of the IAs sent by the # client, the server MUST NOT send a reply to the client. # # The "there were no addresses in any of the IAs sent by the client" check is done by the message # handler. if not self.authoritative: raise CannotRespondError addresses = ', '.join([str(suboption.address) for suboption in option.get_options_of_type(IAAddressOption)]) logger.warning("No handler confirmed {} for {}: " "sending NotOnLink status".format(addresses, bundle.get_link_address())) force_status(bundle.response.options, StatusCodeOption(STATUS_NOTONLINK, "Those addresses are not appropriate on this link")) elif isinstance(bundle.request, RenewMessage): # If the server cannot find a client entry for the IA the server returns the IA containing no addresses # with a Status Code option set to NoBinding in the Reply message. # # If the server finds that any of the addresses are not appropriate for the link to which the client is # attached, the server returns the address to the client with lifetimes of 0. addresses = ', '.join([str(suboption.address) for suboption in option.get_options_of_type(IAAddressOption)]) if self.authoritative: logger.warning("No handler renewed {} for {}: " "withdrawing addresses".format(addresses, bundle.get_link_address())) reply_suboptions = [] for suboption in option.get_options_of_type(IAAddressOption): reply_suboptions.append(IAAddressOption(suboption.address, preferred_lifetime=0, valid_lifetime=0)) bundle.response.options.append(ia_class(option.iaid, options=reply_suboptions)) else: logger.warning("No handler renewed {} for {}: " "sending NoBinding status".format(addresses, bundle.get_link_address())) bundle.response.options.append(ia_class(option.iaid, options=[ StatusCodeOption(STATUS_NOBINDING, "No addresses assigned to you") ])) elif isinstance(bundle.request, RebindMessage): # If the server cannot find a client entry for the IA and the server determines that the addresses in # the IA are not appropriate for the link to which the client's interface is attached according to the # server's explicit configuration information, the server MAY send a Reply message to the client # containing the client's IA, with the lifetimes for the addresses in the IA set to zero. This Reply # constitutes an explicit notification to the client that the addresses in the IA are no longer valid. # In this situation, if the server does not send a Reply message it silently discards the Rebind # message. # # If the server finds that any of the addresses are no longer appropriate for the link to which the # client is attached, the server returns the address to the client with lifetimes of 0. if not self.authoritative: raise CannotRespondError addresses = ', '.join([str(suboption.address) for suboption in option.get_options_of_type(IAAddressOption)]) logger.warning("No handler answered rebind of {} for {}: " "withdrawing addresses".format(addresses, bundle.get_link_address())) reply_suboptions = [] for suboption in option.get_options_of_type(IAAddressOption): reply_suboptions.append(IAAddressOption(suboption.address, preferred_lifetime=0, valid_lifetime=0)) bundle.response.options.append(ia_class(option.iaid, options=reply_suboptions)) elif isinstance(bundle.request, DeclineMessage): # For each IA in the Decline message for which the server has no binding information, the server adds # an IA option using the IAID from the Release message and includes a Status Code option with the value # NoBinding in the IA option. No other options are included in the IA option. bundle.response.options.append(ia_class(option.iaid, options=[ StatusCodeOption(STATUS_NOBINDING, "No addresses assigned to you") ])) elif isinstance(bundle.request, ReleaseMessage): # For each IA in the Release message for which the server has no binding information, the server adds an # IA option using the IAID from the Release message, and includes a Status Code option with the value # NoBinding in the IA option. No other options are included in the IA option. bundle.response.options.append(ia_class(option.iaid, options=[ StatusCodeOption(STATUS_NOBINDING, "No addresses assigned to you") ]))
class TransactionBundleTestCase(unittest.TestCase): def setUp(self): self.bundle = TransactionBundle(relayed_solicit_message, True) self.ia_bundle = TransactionBundle(SolicitMessage(options=[ IANAOption(b'0001'), IANAOption(b'0002'), IATAOption(b'0003'), IATAOption(b'0004'), IAPDOption(b'0005'), IAPDOption(b'0006'), ]), False) self.option_handlers = [ InterfaceIdOptionHandler(), ] def test_request(self): self.assertEqual(self.bundle.request, solicit_message) def test_incoming_relay_messages(self): self.assertEqual(len(self.bundle.incoming_relay_messages), 2) self.assertEqual(self.bundle.incoming_relay_messages[0].hop_count, 0) self.assertEqual(self.bundle.incoming_relay_messages[1].hop_count, 1) def test_no_response(self): self.assertRaisesRegex(ValueError, 'Cannot create outgoing', self.bundle.create_outgoing_relay_messages) def test_bad_response(self): self.bundle.response = SolicitMessage() with self.assertLogs() as cm: self.assertIsNone(self.bundle.outgoing_message) self.assertEqual(len(cm.output), 1) self.assertRegex(cm.output[0], 'server should not send') def test_outgoing_message(self): # Set the response and let the option handlers do their work # Which in this case is copy the InterfaceId to the response self.bundle.response = advertise_message self.bundle.create_outgoing_relay_messages() for option_handler in self.option_handlers: option_handler.handle(self.bundle) self.assertEqual(self.bundle.outgoing_message, relayed_advertise_message) def test_direct_outgoing_message(self): self.ia_bundle.response = advertise_message self.assertEqual(self.ia_bundle.outgoing_message, advertise_message) def test_auto_create_outgoing_relay_messages(self): self.bundle.response = advertise_message self.assertIsInstance(self.bundle.outgoing_message, RelayReplyMessage) def test_no_outgoing_message(self): self.assertIsNone(self.bundle.outgoing_message) def test_unanswered_ia_options(self): unanswered_options = self.ia_bundle.get_unanswered_ia_options() self.assertEqual(len(unanswered_options), 4) self.assertIn(IANAOption(b'0001'), unanswered_options) self.assertIn(IANAOption(b'0002'), unanswered_options) self.assertIn(IATAOption(b'0003'), unanswered_options) self.assertIn(IATAOption(b'0004'), unanswered_options) def test_mark_handled(self): self.ia_bundle.mark_handled(IANAOption(b'0001')) self.ia_bundle.mark_handled(IATAOption(b'0004')) unanswered_options = self.ia_bundle.get_unanswered_ia_options() self.assertEqual(len(unanswered_options), 2) self.assertIn(IANAOption(b'0002'), unanswered_options) self.assertIn(IATAOption(b'0003'), unanswered_options) def test_unanswered_iana_options(self): unanswered_options = self.ia_bundle.get_unanswered_iana_options() self.assertEqual(len(unanswered_options), 2) self.assertIn(IANAOption(b'0001'), unanswered_options) self.assertIn(IANAOption(b'0002'), unanswered_options) def test_unanswered_iata_options(self): unanswered_options = self.ia_bundle.get_unanswered_iata_options() self.assertEqual(len(unanswered_options), 2) self.assertIn(IATAOption(b'0003'), unanswered_options) self.assertIn(IATAOption(b'0004'), unanswered_options) def test_unanswered_iapd_options(self): unanswered_options = self.ia_bundle.get_unanswered_iapd_options() self.assertEqual(len(unanswered_options), 2) self.assertIn(IAPDOption(b'0005'), unanswered_options) self.assertIn(IAPDOption(b'0006'), unanswered_options) def test_unknown_message(self): with self.assertLogs() as cm: TransactionBundle(UnknownMessage(1608, b'Unknown'), False) self.assertEqual(len(cm.output), 1) self.assertRegex(cm.output[0], 'unrecognised message') def test_wrong_way(self): with self.assertLogs() as cm: TransactionBundle(ReplyMessage(), False) self.assertEqual(len(cm.output), 1) self.assertRegex(cm.output[0], 'server should not receive') def test_link_address(self): self.assertEqual(self.bundle.get_link_address(), IPv6Address('2001:db8:ffff:1::1')) self.assertEqual(self.ia_bundle.get_link_address(), IPv6Address('::'))