Skip to content

Latest commit

 

History

History
106 lines (82 loc) · 3.03 KB

README.md

File metadata and controls

106 lines (82 loc) · 3.03 KB

Roxy

Roxy is a root proxy that executes a system command requiring the root privilege.

  • The Roxy binary, roxy, should be owned by root with its setuid flag set. It should also belong to the same group as the services invoking roxy, e.g. "roxy", and the group should have execute permission. Note that "other" should not have execute permission.

    chown root:roxy roxy
    chmod 750 roxy
    chmod u+s roxy
  • Version format in /etc/version file

  OS: AICE OS v1.0.9
  Product: AICE security v1.2.0
  • To control machine, following utilities and files are used

    • utilities
      • ip
      • netplan
      • systemctl (ntp, rsyslog, sshd)
      • ufw
    • files
      • /etc/netplan/01-netcfg.yaml
      • /etc/ntp.conf
      • /etc/rsyslog.d/50-default.conf
      • /etc/ssh/sshd_config
      • /etc/version
  • To find utilities, following path will be searched

    • /usr/bin
    • /usr/sbin
    • /bin
    • /sbin
  • Roxy is supposed to be located in "/usr/local/aice/bin"

  • Tips for services

    • netplan, ip

      • netplan did not set ip address for a interface if it's not running. This can cause an error when delete ip address.
      • Sometimes netplan did not remove ip address when netplan apply command executed with conf ip address removed.
        • Few lines of code are added to solve this problem.

        • ip command is used to do this.

          ip addr del <ip-address/prefixlen> dev <interface-name>
    • ntp

      • all "pool ?.ubuntu.pool.ntp.org iburst" or "pool x.x.x.x" lines should be deleted as a default except appended things by Roxy

      • Roxy will add new ntp server or replace it

        server new.ntpserver.from.webui iburst
        
    • sshd

      • New lines will be appended or replaced if exist at the end of /etc/ssh/sshd_config

        Port 10022
        
    • rsyslog

      • New remote syslog server will be appended or replaced at the end of /etc/rsyslogd/50-default.conf

        user.*    @@192.168.0.2:7500
        user.*     @192.168.0.3:500
        
    • ufw

      • To enable or disable ufw, ufw enable/disable command will be used instead of systemctl
      • systemctl did not detect ufw status exactly

License

Copyright 2022-2024 ClumL Inc.

Licensed under Apache License, Version 2.0 (the "License"); you may not use this crate except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See LICENSE for the specific language governing permissions and limitations under the License.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.