Skip to content

@justin-fyfe justin-fyfe released this Feb 8, 2021

This represents the initial release of the pre-packaged plugins for SanteGuard.

Installation

  1. Extract the provided plugins to the same directory as SanteDB
  2. In the SanteDB configuration file, define the SanteGuard namespace: xmlns:santeguard="http://santedb.org/configuration/santeguard"
  3. Register the configuration sections in the config file:
   <add type="SanteGuard.Configuration.SanteGuardConfiguration, SanteGuard.Core, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
    <add type="SanteGuard.Persistence.Ado.Configuration.SanteGuardAdoConfiguration, SanteGuard.Persistence.Ado, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />

Using the Syslog RFC-3881 and DICOM Receiver

To enable the Syslog receiver:

  1. Add the appropriate configuration to the SanteDB configuration file:
  <section xsi:type="santeguard:SanteGuardConfiguration">
    <santeguard:endpoints>
      <santeguard:add name="UDP Audit Transport" timeout="00:00:10" readTimeout="00:00:10" maxMessageSize="655340" address="udp://0.0.0.0:514">
        <santeguard:actions>
          <santeguard:add>SanteGuard.Messaging.Syslog.Action.LogAction, SanteGuard.Messaging.Syslog, Version=1.0.0.0</santeguard:add>
          <santeguard:add>SanteGuard.Messaging.Syslog.Action.StorageAction, SanteGuard.Messaging.Syslog, Version=1.0.0.0</santeguard:add>
        </santeguard:actions>
        <santeguard:logFile>/var/log/santedb/syslog.txt</santeguard:logFile>
      </santeguard:add>
    </santeguard:endpoints>
    <santeguard:defaultEnterpriseSite>value</santeguard:defaultEnterpriseSite>
  </section>
  1. Enable the Syslog Service in the primary service configuration:
<add type="SanteGuard.Messaging.Syslog.SyslogMessageHandler, SanteGuard.Messaging.Syslog, Version=1.0.0.0"/>

Enable Enhanced Audit Storage (Untested / New Feature)

The default audit repository service is compatible with SanteGuard's Syslog receiver. However, if you would like to configure the service as a dedicated audit repository endpoint. You should enable the enhanced audit storage facility:

  1. Deploy the database schema santeguard-ddl.sql
  2. Add the ADO configuration for SanteGuard
  <section xsi:type="santeguard:SanteGuardAdoConfiguration"
        readWriteConnectionString="PSQL"
        readOnlyConnectionString="PSQL"
        traceSql="false"
        providerType="npgsql"
        perpareStatements="false" />
  1. Add services for storage:
      <add type="SanteGuard.Services.LocalAuditTermLookupService, SanteGuard.Core, Version=1.0.0.0"/>
      <add type="SanteGuard.Services.Repositories.SanteGuardDataRepository, SanteGuard.Core, Version=1.0.0.0"/>
      <add type="SanteGuard.Persistence.Ado.Services.AdoAuditPersistenceService, SanteGuard.Persistence.Ado, Version=1.0.0.0"/>
      <add type="SanteGuard.Services.Repositories.SanteGuardAuditRepository, SanteGuard.Core, Version=1.0.0.0"/>
Assets 4
Jan 23, 2021
Updated version refs and manifest file for SG applet
Jan 2, 2021
Updated version codes
Dec 15, 2020
Updated the applet to fix activity log appearing on remote records: