Synapse

=====================

Model Changes
-------------
- Added ``ou:requirement:type`` taxonomy property to track requirement types.
(`3954 <https://github.com/vertexproject/synapse/pull/3954>`_)
- Added ``it:app:snort:hit:dropped`` property to track when hits result in the
traffic being dropped.
(`3954 <https://github.com/vertexproject/synapse/pull/3954>`_)
- Added ``ou:vitals:budget`` property to track budget allocations.
(`3954 <https://github.com/vertexproject/synapse/pull/3954>`_)
- Added ``risk:mitigation:type`` as a ``taxonomy`` to track mitigation types.
(`3957 <https://github.com/vertexproject/synapse/pull/3957>`_)
- Added ``ou:asset`` form and associated properties to model organizational
asset tracking.
(`3957 <https://github.com/vertexproject/synapse/pull/3957>`_)
- See :ref:`userguide_model_v2_184_0` for more detailed model changes.

Features and Enhancements
-------------------------
- Add ``$lib.graph.revoke()`` API for revoking user/role permissions on a graph
projection.
(`3950 <https://github.com/vertexproject/synapse/pull/3950>`_)
- Mark all functions in a deprecated Storm library as deprecated.
(`3952 <https://github.com/vertexproject/synapse/pull/3952>`_)

Bugfixes
--------
- Fix a Storm bug where a runtsafe list unpacking operation which was executed
per-node would be executed one additional time after all nodes had finished
moving through the pipeline.
(`3949 <https://github.com/vertexproject/synapse/pull/3949>`_)
- Fix an issue where the default permission level specified when adding a graph
projection was overwritten.
(`3950 <https://github.com/vertexproject/synapse/pull/3950>`_)
- Fixed an issue where extended model forms which implemented interfaces could
not be removed due to inherited props.
(`3958 <https://github.com/vertexproject/synapse/pull/3958>`_)

Deprecations
------------
- Deprecate ``$lib.inet.whois.guid``.
(`3951 <https://github.com/vertexproject/synapse/pull/3951>`_)

=====================

Model Changes
-------------
- Fix an issue where the ``:path:base``, ``:path:dir``, and ``:path:ext``
secondary properties were marked readonly on the ``it:fs:file``,
``it:exec:file:add``, ``it:exec:file:del``, ``it:exec:file:read``, and
``it:exec:file:write`` forms.
(`3942 <https://github.com/vertexproject/synapse/pull/3942>`_)
- See :ref:`userguide_model_v2_183_0` for more detailed model changes.

Features and Enhancements
-------------------------
- Expose Stormlib deprecation status from the Python API.
(`3929 <https://github.com/vertexproject/synapse/pull/3929>`_)
- Add ``$lib.random.generator()`` to get a random number generator in Storm.
(`3945 <https://github.com/vertexproject/synapse/pull/3945>`_)

Bugfixes
--------
- Tag add operations with the try syntax ( ``+?`` ) now catch BadTag
exceptions raised by tags which are not valid for a defined tag model.
(`3941 <https://github.com/vertexproject/synapse/pull/3941>`_)
- Added ``task.get`` and ``task.del`` permissions declarations so they get
included in the output of the ``auth.perms.list`` command.
(`3944 <https://github.com/vertexproject/synapse/pull/3944>`_)

Improved documentation
----------------------
- Clarify parts of the Storm automation guide.
(`3938 <https://github.com/vertexproject/synapse/pull/3938>`_)
- Clarify Storm type specific documentation for ``guid`` types.
(`3939 <https://github.com/vertexproject/synapse/pull/3939>`_)

=====================

Features and Enhancements
-------------------------
- Update the allowed version of the ``packaging`` and ``xxhash`` libraries.
(`3931 <https://github.com/vertexproject/synapse/pull/3931>`_)
- Allow a user to specify a role iden when creating a role with the
``$lib.auth.role.add()`` Storm API.
(`3932 <https://github.com/vertexproject/synapse/pull/3932>`_)

Bugfixes
--------
- Fix an issue in the ``merge`` command where errors in establishing the node
in the parent view could result in an exception. These errors are now
surfaced as warnings in the runtime, and the node will be skipped.
(`3925 <https://github.com/vertexproject/synapse/pull/3925>`_)
- Fix an issue where the Cell would log that the free space write hold was
removed irrespective of the write hold reason.
(`3934 <https://github.com/vertexproject/synapse/pull/3934>`_)

=====================

Automatic Migrations
--------------------
- Update ``inet:ipv4`` and ``inet:ipv6`` sub properties for values affected by
IANA Special Purpose Registry updates.
(`3902 <https://github.com/vertexproject/synapse/pull/3902>`_)
- A small migration to populate ``ou:industry:type:taxonomy`` nodes from
existing ``ou:industry:type`` values.
(`3912 <https://github.com/vertexproject/synapse/pull/3912>`_)
- See :ref:`datamigration` for more information about automatic migrations.

Model Changes
-------------
- The ``inet:rfc2822:addr`` type now rejects malformed inputs which could cause
incorrect email addresses to be recorded.
(`3902 <https://github.com/vertexproject/synapse/pull/3902>`_)
- The ``inet:ipv4:type`` and ``inet:ipv6:type`` secondary properties now
reflect updated behaviors from the IANA Special Purposes registries.
(`3902 <https://github.com/vertexproject/synapse/pull/3902>`_)
- Added ``math:algorithm`` form to model algorithms and link to generated
output.
(`3906 <https://github.com/vertexproject/synapse/pull/3906>`_)
- Added ``:mitigated=<bool>`` and ``:mitigations=[<risk:mitigation>]``
properties to the ``risk:vulnerable`` form to track mitigations used to
address vulnerable nodes.
(`3910 <https://github.com/vertexproject/synapse/pull/3910>`_)
(`3911 <https://github.com/vertexproject/synapse/pull/3911>`_)
- Added ``ou:org:motto`` and ``ou:campaign:slogan`` properties and the
``lang:phrase`` form.
(`3915 <https://github.com/vertexproject/synapse/pull/3915>`_)
- See :ref:`userguide_model_v2_181_0` for more detailed model changes.

Features and Enhancements
-------------------------
- Storm lists now have a ``remove`` method that can be used to remove a single
item from the list without having to iterate through the list.
(`3815 <https://github.com/vertexproject/synapse/pull/3815>`_)
- Added ``opts`` field to ``model:type`` Storm type. This field contains the
property type options as defined in the data model.
(`3815 <https://github.com/vertexproject/synapse/pull/3815>`_)
- Updated Storm coverage tracker to support ``pragma: no cover`` for ignoring
single lines of code and ``pragma: no cover start``/``pragma: no cover stop``
for ignoring multi-line blocks of Storm code.
(`3815 <https://github.com/vertexproject/synapse/pull/3815>`_)
- Make the ``Slab.putmulti()`` API an async function.
(`3896 <https://github.com/vertexproject/synapse/pull/3896>`_)
- Expose the response URL on the Storm ``http:resp`` object.
(`3898 <https://github.com/vertexproject/synapse/pull/3898>`_)
- Expose the HTTP request headers on the Storm ``http:resp`` object.
(`3899 <https://github.com/vertexproject/synapse/pull/3899>`_)
- Add request history on the Storm ``inet:http:resp`` object.
(`3900 <https://github.com/vertexproject/synapse/pull/3900>`_)
- Add a ``getPropValues()`` API to Storm View and Layer objects for yielding
distinct values of a property.
(`3903 <https://github.com/vertexproject/synapse/pull/3903>`_)
- Update Storm language to add support for matching multiple switch case values
to a single Storm query.
(`3904 <https://github.com/vertexproject/synapse/pull/3904>`_)
- Provide additional handling for Storm pool members who are online but
unresponsive to new Telepath calls.
(`3914 <https://github.com/vertexproject/synapse/pull/3914>`_)
- Add the ability to provide an iden when creating a new HTTP Extended API.
(`3920 <https://github.com/vertexproject/synapse/pull/3920>`_)
- Added initial dictionary validator and deconfliction for guid based node
constructor logic to Storm.
(`3917 <https://github.com/vertexproject/synapse/pull/3917>`_)

Bugfixes
--------
- Fix an issue where user defined Storm functions could be greedy with the IO
loop.
(`3894 <https://github.com/vertexproject/synapse/pull/3894>`_)
- Fixed bug where nodedata may not be properly removed when it's in a
view/layer above the actual node.
(`3923 <https://github.com/vertexproject/synapse/pull/3923>`_)

Improved documentation
----------------------
- Added documentation about ``tls:ca:dir`` configuration option for specifying
custom TLS CA certificates.
(`3895 <https://github.com/vertexproject/synapse/pull/3895>`_)
- Added an example of using ``scrape`` on the primary property to the command
usage statement.
(`3907 <https://github.com/vertexproject/synapse/pull/3907>`_)

Deprecations
------------
- Remove deprecated ``synapse.lib.jupyter`` module.
(`3897 <https://github.com/vertexproject/synapse/pull/3897>`_)

=====================

Features and Enhancements
-------------------------
- Update the ``cryptography`` library to require its latest version.
(`3890 <https://github.com/vertexproject/synapse/pull/3890>`_)

Improved documentation
----------------------
- Fixed a typo in the ``trigger.enable`` docs which mistakenly referred to the
``trigger-enable`` command.
(`3889 <https://github.com/vertexproject/synapse/pull/3889>`_)

=====================

Automatic Migrations
--------------------
- A small migration to normalize ``it:dev:repo:commit:id`` to remove leading
and trailing whitespace.
(`3884 <https://github.com/vertexproject/synapse/pull/3884>`_)
- See :ref:`datamigration` for more information about automatic migrations.

Model Changes
-------------
- Added ``pol:candidate:id`` to track election authority issued candidate IDs.
(`3878 <https://github.com/vertexproject/synapse/pull/3878>`_)
- Updated ``it:dev:repo`` elements to inherit ``inet:service:object``.
(`3879 <https://github.com/vertexproject/synapse/pull/3879>`_)
- Add ``inet:service:account`` properties to forms with ``inet:web:acct``
properties.
(`3880 <https://github.com/vertexproject/synapse/pull/3880>`_)
- See :ref:`userguide_model_v2_180_0` for more detailed model changes.

Features and Enhancements
-------------------------
- Include detailed link traversal information from the Storm runtime when the
``link`` option is set.
(`3862 <https://github.com/vertexproject/synapse/pull/3862>`_)
- Add support for disabling readahead on layer slabs by setting the
``SYNDEV_CORTEX_LAYER_READAHEAD`` environment variable.
(`3877 <https://github.com/vertexproject/synapse/pull/3877>`_)

Improved documentation
----------------------
- Add Devops task for using ``onboot:optimize`` to optimize LMDB databases in
services.
(`3876 <https://github.com/vertexproject/synapse/pull/3876>`_)
- Clarify documentation on taxonomy types.
(`3883 <https://github.com/vertexproject/synapse/pull/3883>`_)