xref: /openbmc/phosphor-dbus-interfaces/yaml/xyz/openbmc_project/Chassis/Intrusion.interface.yaml (revision 6cfd0d08a7083263102cb8e7a216f818a4c210eb)
1b1b4d261SWilliam A. Kennington IIIdescription: >
2b1b4d261SWilliam A. Kennington III    Interface to query intrusion detector status.
3b1b4d261SWilliam A. Kennington III
4b1b4d261SWilliam A. Kennington IIIproperties:
5b1b4d261SWilliam A. Kennington III    - name: Status
6fd1e87a7SChau Ly      type: enum[self.Status]
7fd1e87a7SChau Ly      default: "Normal"
8b1b4d261SWilliam A. Kennington III      description: >
9a1347418SPatrick Williams          Status string of chassis intrusion detector. The value is defined in
10fd1e87a7SChau Ly          chassis redfish schema. Can be "Normal", "HardwareIntrusion" or
11fd1e87a7SChau Ly          "TamperingDetected".
127b1b723dSChau Ly    - name: Rearm
137b1b723dSChau Ly      type: enum[self.RearmMode]
147b1b723dSChau Ly      default: "Automatic"
157b1b723dSChau Ly      description: >
167b1b723dSChau Ly          Mode string of chassis intrusion detector. The value is defined in
177b1b723dSChau Ly          chassis redfish schema. Can be "Automatic" or "Manual".
187b1b723dSChau Ly
197b1b723dSChau Lyenumerations:
207b1b723dSChau Ly    - name: RearmMode
217b1b723dSChau Ly      description: >
227b1b723dSChau Ly          Methods to rearm the chassis intrusion status.
237b1b723dSChau Ly      values:
247b1b723dSChau Ly          - name: "Automatic"
257b1b723dSChau Ly            description: >
267b1b723dSChau Ly                Automatic Rearm method.
277b1b723dSChau Ly          - name: "Manual"
287b1b723dSChau Ly            description: >
297b1b723dSChau Ly                Manual Rearm method.
30fd1e87a7SChau Ly    - name: Status
31fd1e87a7SChau Ly      description: >
32fd1e87a7SChau Ly          The physical security state of the chassis.
33fd1e87a7SChau Ly      values:
34fd1e87a7SChau Ly          - name: "Normal"
35fd1e87a7SChau Ly            description: >
36fd1e87a7SChau Ly                No physical security condition is detected at this time.
37fd1e87a7SChau Ly          - name: "HardwareIntrusion"
38fd1e87a7SChau Ly            description: >
39fd1e87a7SChau Ly                Any mechanism protecting the chassis's internal hardwares from
40fd1e87a7SChau Ly                being accessed is detected to be in an insecure state.
41fd1e87a7SChau Ly          - name: "TamperingDetected"
42fd1e87a7SChau Ly            description: >
43fd1e87a7SChau Ly                Physical tampering is detected.
44*6cfd0d08SChau Ly
45*6cfd0d08SChau Lyassociations:
46*6cfd0d08SChau Ly    - name: monitoring
47*6cfd0d08SChau Ly      description: >
48*6cfd0d08SChau Ly          One chassis intrusion sensor needs to implement the 'monitoring'
49*6cfd0d08SChau Ly          association to provide links to the inventory items that it is
50*6cfd0d08SChau Ly          monitoring the security state against intrusion events.
51*6cfd0d08SChau Ly      reverse_name: monitored_by
52*6cfd0d08SChau Ly      required_endpoint_interfaces:
53*6cfd0d08SChau Ly          - xyz.openbmc_project.Inventory.Item
54