@@ -2,60 +2,59 @@ defmodule NervesHub.AuditLogs.DeviceTemplates do
22 @ moduledoc """
33 Templates for and handling of audit logging for device operations.
44 """
5- alias NervesHub.Firmwares.Firmware
65 alias NervesHub.Accounts.User
76 alias NervesHub.AuditLogs
8- alias NervesHub.AuditLogs.AuditLog
97 alias NervesHub.Deployments.Deployment
108 alias NervesHub.Devices.Device
9+ alias NervesHub.Firmwares.Firmware
1110
1211 require Logger
1312
1413 ## General
1514
16- @ spec audit_reboot ( User . t ( ) , Device . t ( ) ) :: AuditLog . t ( )
15+ @ spec audit_reboot ( User . t ( ) , Device . t ( ) ) :: :ok
1716 def audit_reboot ( user , device ) do
1817 description = "User #{ user . name } rebooted device #{ device . identifier } "
1918 AuditLogs . audit! ( user , device , description )
2019 end
2120
22- @ spec audit_request_action ( User . t ( ) , Device . t ( ) , String . t ( ) ) :: AuditLog . t ( )
21+ @ spec audit_request_action ( User . t ( ) , Device . t ( ) , String . t ( ) ) :: :ok
2322 def audit_request_action ( user , device , action ) do
2423 description = "User #{ user . name } requested the device (#{ device . identifier } ) #{ action } "
2524 AuditLogs . audit! ( user , device , description )
2625 end
2726
2827 ## Firmware and upgrades
2928
30- @ spec audit_update_attempt ( Device . t ( ) ) :: AuditLog . t ( )
29+ @ spec audit_update_attempt ( Device . t ( ) ) :: :ok
3130 def audit_update_attempt ( device ) do
3231 description = "Device #{ device . identifier } is attempting to update"
3332 AuditLogs . audit ( device , device , description )
3433 end
3534
36- @ spec audit_pushed_available_update ( User . t ( ) , Device . t ( ) , Deployment . t ( ) ) :: AuditLog . t ( )
35+ @ spec audit_pushed_available_update ( User . t ( ) , Device . t ( ) , Deployment . t ( ) ) :: :ok
3736 def audit_pushed_available_update ( user , device , deployment ) do
3837 description =
3938 "User #{ user . name } pushed available firmware update #{ deployment . firmware . version } #{ deployment . firmware . uuid } to device #{ device . identifier } "
4039
4140 AuditLogs . audit! ( user , device , description )
4241 end
4342
44- @ spec audit_firmware_pushed ( User . t ( ) , Device . t ( ) , Firmware . t ( ) ) :: AuditLog . t ( )
43+ @ spec audit_firmware_pushed ( User . t ( ) , Device . t ( ) , Firmware . t ( ) ) :: :ok
4544 def audit_firmware_pushed ( user , device , firmware ) do
4645 description =
4746 "User #{ user . name } pushed firmware #{ firmware . version } #{ firmware . uuid } to device #{ device . identifier } "
4847
4948 AuditLogs . audit! ( user , device , description )
5049 end
5150
52- @ spec audit_firmware_metadata_updated ( Device . t ( ) ) :: AuditLog . t ( )
51+ @ spec audit_firmware_metadata_updated ( Device . t ( ) ) :: :ok
5352 def audit_firmware_metadata_updated ( device ) do
5453 description = "Device #{ device . identifier } updated firmware metadata"
5554 AuditLogs . audit! ( device , device , description )
5655 end
5756
58- @ spec audit_firmware_upgrade_blocked ( Deployment . t ( ) , Device . t ( ) ) :: AuditLog . t ( )
57+ @ spec audit_firmware_upgrade_blocked ( Deployment . t ( ) , Device . t ( ) ) :: :ok
5958 def audit_firmware_upgrade_blocked ( deployment , device ) do
6059 description = """
6160 Device #{ device . identifier } automatically blocked firmware upgrades for #{ deployment . penalty_timeout_minutes } minutes.
@@ -65,15 +64,15 @@ defmodule NervesHub.AuditLogs.DeviceTemplates do
6564 AuditLogs . audit! ( deployment , device , description )
6665 end
6766
68- @ spec audit_firmware_updated ( Device . t ( ) ) :: AuditLog . t ( )
67+ @ spec audit_firmware_updated ( Device . t ( ) ) :: :ok
6968 def audit_firmware_updated ( device ) do
7069 description =
7170 "Device #{ device . identifier } firmware set to version #{ device . firmware_metadata . version } (#{ device . firmware_metadata . uuid } )"
7271
7372 AuditLogs . audit! ( device , device , description )
7473 end
7574
76- @ spec audit_device_deployment_update_triggered ( Device . t ( ) , UUIDv7 . t ( ) ) :: AuditLog . t ( )
75+ @ spec audit_device_deployment_update_triggered ( Device . t ( ) , UUIDv7 . t ( ) ) :: :ok
7776 def audit_device_deployment_update_triggered ( device , reference_id ) do
7877 deployment = device . deployment
7978 firmware = deployment . firmware
@@ -84,7 +83,7 @@ defmodule NervesHub.AuditLogs.DeviceTemplates do
8483 AuditLogs . audit_with_ref! ( deployment , device , description , reference_id )
8584 end
8685
87- @ spec audit_device_deployment_update ( User . t ( ) , Device . t ( ) , Deployment . t ( ) ) :: AuditLog . t ( )
86+ @ spec audit_device_deployment_update ( User . t ( ) , Device . t ( ) , Deployment . t ( ) ) :: :ok
8887 def audit_device_deployment_update ( user , device , deployment ) do
8988 AuditLogs . audit! (
9089 user ,
@@ -93,8 +92,7 @@ defmodule NervesHub.AuditLogs.DeviceTemplates do
9392 )
9493 end
9594
96- @ spec audit_device_deployment_update ( Device . t ( ) , Deployment . t ( ) , :one_found | :multiple_found ) ::
97- AuditLog . t ( )
95+ @ spec audit_set_deployment ( Device . t ( ) , Deployment . t ( ) , :one_found | :multiple_found ) :: :ok
9896 def audit_set_deployment ( device , deployment , :one_found ) do
9997 AuditLogs . audit! (
10098 device ,
@@ -103,8 +101,6 @@ defmodule NervesHub.AuditLogs.DeviceTemplates do
103101 )
104102 end
105103
106- @ spec audit_set_deployment ( Device . t ( ) , Deployment . t ( ) , :one_found | :multiple_found ) ::
107- AuditLog . t ( )
108104 def audit_set_deployment ( device , deployment , :multiple_found ) do
109105 AuditLogs . audit! (
110106 device ,
0 commit comments