Merge branch 'master' into deprecate-webprops

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 2.187.0
+current_version = 2.188.0
 commit = True
 tag = True
 tag_message = 

CHANGELOG.rst

@@ -6,6 +6,68 @@
 Synapse Changelog
 *****************
 
+v2.188.0 - 2024-11-08
+=====================
+
+Model Changes
+-------------
+- Added ``meta:aggregate`` to represent aggregate counts.
+  (`#3968 <https://github.com/vertexproject/synapse/pull/3968>`_)
+- Added ``risk:outage`` to represent outage events.
+  (`#3968 <https://github.com/vertexproject/synapse/pull/3968>`_)
+- Added ``:reporter`` and ``:reporter:name`` to the ``ou:industry`` form to
+  allow reporter specific industries.
+  (`#3968 <https://github.com/vertexproject/synapse/pull/3968>`_)
+- Added ``file:attachment`` to unify file attachment types.
+  (`#3969 <https://github.com/vertexproject/synapse/pull/3969>`_)
+- Added ``ou:candidate`` to track job applications and candidates.
+  (`#3969 <https://github.com/vertexproject/synapse/pull/3969>`_)
+- Added ``:src:txfiles`` and ``:dst:txfiles`` to ``inet:flow`` to capture
+  transferred files.
+  (`#3969 <https://github.com/vertexproject/synapse/pull/3969>`_)
+- Added ``inet:service:emote`` to track account emotes.
+  (`#3988 <https://github.com/vertexproject/synapse/pull/3988>`_)
+- Added ``inet:service:relationship`` to track service object relationships.
+  (`#3988 <https://github.com/vertexproject/synapse/pull/3988>`_)
+- Add a ``uses`` light edge between ``ou:technique`` and ``risk:vuln`` forms.
+  (`#3994 <https://github.com/vertexproject/synapse/pull/3994>`_)
+- See :ref:`userguide_model_v2_188_0` for more detailed model changes.
+
+Features and Enhancements
+-------------------------
+- Add support for `ndef` types in embed property definitions.
+  (`#3979 <https://github.com/vertexproject/synapse/pull/3979>`_)
+- Add ``children()`` method on Storm ``view`` objects.
+  (`#3984 <https://github.com/vertexproject/synapse/pull/3984>`_)
+- Update the ``cron.list`` command to use a tabular printer for table
+  generation.
+  (`#3986 <https://github.com/vertexproject/synapse/pull/3986>`_)
+- Add ``$lib.model.ext.addType()`` and ``$lib.model.ext.delType()`` Storm APIs
+  for managing extended model types.
+  (`#3989 <https://github.com/vertexproject/synapse/pull/3989>`_)
+- Allow optionally specifying typeopts to the ``Cortex.getPropNorm`` and
+  ``Cortex.getTypeNorm`` APIs.
+  (`#3992 <https://github.com/vertexproject/synapse/pull/3992>`_)
+- Update async scrape APIs to use the forked process pool rather than spawned
+  processes.
+  (`#3993 <https://github.com/vertexproject/synapse/pull/3993>`_)
+
+Bugfixes
+--------
+- Fixed an issue where creating a cron job with a stable iden could overlap
+  with existing authgates.
+  (`#3981 <https://github.com/vertexproject/synapse/pull/3981>`_)
+- Fixed an issue where Nexus events from updated mirrors pushed to a leader on
+  an older version which did not yet support those events were not handled
+  correctly.
+  (`#3985 <https://github.com/vertexproject/synapse/pull/3985>`_)
+- Fix an issue where extended model types could be deleted while still in use
+  by other extended model types.
+  (`#3989 <https://github.com/vertexproject/synapse/pull/3989>`_)
+- Fix an issue where the Storm ``background`` and ``parallel`` commands could
+  incorrectly throw NoSuchVar exceptions when validating query arguments.
+  (`#3991 <https://github.com/vertexproject/synapse/pull/3991>`_)
+
 v2.187.0 - 2024-11-01
 =====================
 

docs/synapse/userguides/model_updates/update_v2_188_0.rst

@@ -0,0 +1,122 @@
+
+
+.. _userguide_model_v2_188_0:
+
+######################
+v2.188.0 Model Updates
+######################
+
+The following model updates were made during the ``v2.188.0`` Synapse release.
+
+*********
+New Types
+*********
+
+``inet:service:object``
+  An ndef type including all forms which implement the ``inet:service:object``
+  interface.
+
+
+
+*********
+New Forms
+*********
+
+``risk:outage``
+  An outage event which affected resource availability.
+
+
+``meta:aggregate:type:taxonomy``
+  A type of item being counted in aggregate.
+
+
+``ou:candidate:method:taxonomy``
+  A taxonomy of methods by which a candidate came under consideration.
+
+
+``risk:outage:type:taxonomy``
+  An outage type taxonomy.
+
+
+``file:attachment``
+  A file attachment.
+
+
+``risk:outage:cause:taxonomy``
+  An outage cause taxonomy.
+
+
+``inet:service:relationship``
+  A relationship between two service objects.
+
+
+``meta:aggregate``
+  A node which represents an aggregate count of a specific type.
+
+
+``inet:service:relationship:type:taxonomy``
+  A service object relationship type taxonomy.
+
+
+``inet:service:emote``
+  An emote or reaction by an account.
+
+
+``ou:candidate``
+  A candidate being considered for a role within an organization.
+
+
+
+**************
+New Properties
+**************
+
+``inet:flow``
+  The form had the following properties added to it:
+
+
+  ``dst:txfiles``
+    An array of files sent by the destination host.
+
+
+  ``src:txfiles``
+    An array of files sent by the source host.
+
+
+``ou:industry``
+  The form had the following properties added to it:
+
+
+  ``reporter``
+    The organization reporting on the industry.
+
+
+  ``reporter:name``
+    The name of the organization reporting on the industry.
+
+
+
+***********
+Light Edges
+***********
+
+``caused``
+    When used with a ``risk:attack`` and an ``risk:outage`` node, the edge
+    indicates the attack caused the outage.
+
+    When used with a ``meta:event`` and an ``risk:outage`` node, the edge
+    indicates the event caused the outage.
+
+
+``impacted``
+    When used with a ``risk:outage`` node, the edge indicates the outage event
+    impacted the availability of the target node.
+
+    When used with a ``risk:vuln`` and an ``ou:technique`` node, the edge
+    indicates the vulnerability uses the technique.
+
+
+``uses``
+    When used with a ``ou:technique`` and an ``risk:vuln`` node, the edge
+    indicates the technique uses the vulnerability.
+

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = 'setuptools.build_meta'
 
 [project]
 name = 'synapse'
-version = '2.187.0'
+version = '2.188.0'
 authors = [
     { name = 'The Vertex Project LLC', email = '[email protected]'},
 ]

synapse/lib/version.py

@@ -223,6 +223,6 @@ def reqVersion(valu, reqver,
 ##############################################################################
 # The following are touched during the release process by bumpversion.
 # Do not modify these directly.
-version = (2, 187, 0)
+version = (2, 188, 0)
 verstring = '.'.join([str(x) for x in version])
 commit = ''

synapse/models/inet.py

@@ -1369,7 +1369,7 @@ def getModelDefs(self):
                         'doc': 'A username string.'
                     }),
 
-                    ('inet:service:object', ('ndef', {'interface': 'inet:service:object'}), {
+                    ('inet:service:object', ('ndef', {'interfaces': ('inet:service:object',)}), {
                         'doc': 'An ndef type including all forms which implement the inet:service:object interface.'}),
 
                     ('inet:search:query', ('guid', {}), {

synapse/tests/test_model_inet.py

@@ -3404,3 +3404,6 @@ async def test_model_inet_service(self):
             self.eq(':gothparrot:', nodes[0].get('text'))
             self.len(1, await core.nodes('inet:service:emote :about -> it:dev:repo +:name=vertex'))
             self.len(1, await core.nodes('inet:service:emote :creator -> inet:service:account +:user=visi'))
+
+            with self.raises(s_exc.BadTypeValu):
+                await core.nodes('[ inet:service:relationship=* :source={[it:dev:str=foo]} ]')