docs/conf/opers.conf.example

   1 #-#-#-#-#-#-#-#-#-#-#-#-  CLASS CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#-
   2 #                                                                     #
   3 #   Classes are a group of commands which are grouped together and    #
   4 #   given a unique name. They're used to define which commands        #
   5 #   are available to certain types of Operators.                      #
   6 #                                                                     #
   7 #                                                                     #
   8 #  Note: It is possible to make a class which covers all available    #
   9 #  commands. To do this, specify commands="*". This is not really     #
  10 #  recommended, as it negates the whole purpose of the class system,  #
  11 #  however it is provided for fast configuration (e.g. in test nets)  #
  12 #                                                                     #
  13
  14 <class
  15      name="Shutdown"
  16
  17      # commands: oper commands that users of this class can run.
  18      commands="DIE RESTART REHASH LOADMODULE UNLOADMODULE RELOAD GUNLOADMODULE GRELOADMODULE SAJOIN SAPART SANICK SAQUIT SATOPIC"
  19
  20      # privs: special privileges that users with this class may utilise.
  21      #  VIEWING:
  22      #   - channels/auspex: allows opers with this priv to see more detail about channels than normal users.
  23      #   - users/auspex: allows opers with this priv to view more details about users than normal users.
  24      #   - servers/auspex: allows opers with this priv to see more detail about server information than normal users.
  25      # ACTIONS:
  26      #   - users/mass-message: allows opers with this priv to PRIVMSG and NOTICE to a server mask (e.g. NOTICE $*)
  27      #   - channels/high-join-limit: allows opers with this priv to join <channels:opers> total channels instead of <channels:users> total channels.
  28      # PERMISSIONS:
  29      #   - users/flood/no-throttle: allows opers with this priv to send commands without being throttled (*NOTE)
  30      #   - users/flood/increased-buffers: allows opers with this priv to send and recieve data without worrying about being disconnected for exceeding limits (*NOTE)
  31      #
  32      # *NOTE: These privs are potantially dangerous, as they grant users with them the ability to hammer your server's CPU/RAM as much as they want, essentially.
  33      privs="users/auspex channels/auspex servers/auspex users/mass-message channels/high-join-limit users/flood/no-throttle users/flood/increased-buffers"
  34
  35      # usermodes: Oper-only usermodes that opers with this class can use.
  36      usermodes="*"
  37
  38      # chanmodes: Oper-only channel modes that opers with this class can use.
  39      chanmodes="*">
  40
  41 <class name="ServerLink" commands="CONNECT SQUIT CONNECT MKPASSWD ALLTIME SWHOIS CLOSE JUMPSERVER LOCKSERV" usermodes="*" chanmodes="*" privs="servers/auspex">
  42 <class name="BanControl" commands="KILL GLINE KLINE ZLINE QLINE ELINE TLINE RLINE CHECK NICKLOCK SHUN CLONES CBAN" usermodes="*" chanmodes="*">
  43 <class name="OperChat" commands="WALLOPS GLOBOPS SETIDLE" usermodes="*" chanmodes="*" privs="users/mass-message">
  44 <class name="HostCloak" commands="SETHOST SETIDENT SETNAME CHGHOST CHGIDENT" usermodes="*" chanmodes="*" privs="users/auspex">
  45
  46
  47 #-#-#-#-#-#-#-#-#-#-#-#-  OPERATOR COMPOSITION   -#-#-#-#-#-#-#-#-#-#-#
  48 #                                                                     #
  49 #   This is where you specify which types of operators you have on    #
  50 #   your server, as well as the commands they are allowed to use.     #
  51 #   This works alongside with the classes specified above.            #
  52 #                                                                     #
  53
  54 <type
  55     # name: Name of type. Used in actual olines below.
  56     # Cannot contain spaces. If you would like a space, use
  57     # the _ character instead and it will translate to a space on whois.
  58     name="NetAdmin"
  59
  60     # classes: classes (above blocks) that this type belongs to.
  61     classes="OperChat BanControl HostCloak Shutdown ServerLink"
  62
  63     # vhost: host oper gets on oper-up. This is optional.
  64     vhost="netadmin.omega.org.za"
  65
  66     # modes: usermodes besides +o that are set on a oper of this type
  67     # when they oper up. Used for snomasks and other things.
  68     # Requires that m_opermodes.so be loaded.
  69     modes="+s +cCqQ">
  70
  71 <type name="GlobalOp" classes="OperChat BanControl HostCloak ServerLink" vhost="ircop.omega.org.za">
  72 <type name="Helper" classes="HostCloak" vhost="helper.omega.org.za">
  73
  74
  75 #-#-#-#-#-#-#-#-#-#-#-  OPERATOR CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
  76 #                                                                     #
  77 #   Opers are defined here. This is a very important section.         #
  78 #   Remember to only make operators out of trust worthy people.       #
  79 #                                                                     #
  80
  81 # oline with plain-text password
  82 <oper
  83       # name: oper login that is used to oper up (/oper name password).
  84       # Remember: This is case sensitive
  85       name="Brain"
  86
  87       # password: case-sensitive, unhashed...yea...self-explanatory.
  88       password="s3cret"
  89
  90       # host: What hostnames/IP's are allowed to oper up with this oline.
  91       # Multiple options can be separated by spaces and CIDR's are allowed.
  92       # You CAN use just * or *@* for this section, but it is not recommended
  93       # for security reasons.
  94       host="ident@dialup15.isp.com *@localhost *@server.com *@3ffe::0/16"
  95
  96       # ** ADVANCED ** This option is disabled by default.
  97       # fingerprint: When using the m_sslinfo module, you may specify
  98       # a key fingerprint here. This can be obtained by using the /sslinfo
  99       # command while the module is loaded, and is also noticed on connect.
 100       # This enhances security by verifying that the person opering up has
 101       # a matching SSL client certificate, which is very difficult to
 102       # forge (impossible unless preimage attacks on the hash exist).
 103       # If m_sslinfo isn't loaded, this option will be ignored.
 104       #fingerprint="67cb9dc013248a829bb2171ed11becd4"
 105
 106       # autologin: if an SSL fingerprint for this oper is specified, you can
 107       # have the oper block automatically log in. This moves all security of the
 108       # oper block to the protection of the client certificate, so be sure that
 109       # the private key is well-protected! Requires m_sslinfo.
 110       #autologin="on"
 111
 112       # sslonly: This oper can only oper up if they're using a SSL connection.
 113       # Setting this option adds a decent bit of security. Highly recommended
 114       # if the oper is on wifi, or specifically, unsecured wifi. Note that it
 115       # is redundant to specify this option if you specify a fingerprint.
 116       # This setting only takes effect if m_sslinfo is loaded.
 117       #sslonly="yes"
 118
 119       # vhost: overrides the vhost in the type block. Class and modes may also
 120       # be overridden
 121       vhost="brain.netadmin.omega"
 122
 123       # type: What oper type this oline is. See the block above for list
 124       # of types. NOTE: This is case-sensitive as well.
 125       type="NetAdmin">
 126
 127 # oline with plain-text password and no comments..for all who like copy & paste
 128 <oper
 129       name="Brain"
 130       password="s3cret"
 131       host="ident@dialup15.isp.com *@localhost *@server.com *@3ffe::0/16"
 132       #fingerprint="67cb9dc013248a829bb2171ed11becd4"
 133       type="NetAdmin">
 134
 135 # oline with hashed password. It is highly recommended to use hashed passwords.
 136 <oper
 137       # name: oper login that is used to oper up (/oper name password).
 138       # Remember: This is case sensitive
 139       name="Brain"
 140
 141       # hash: what hash this password is hashed with. requires the module
 142       # for selected hash (m_md5.so, m_sha256.so or m_ripemd160.so) be
 143       # loaded and the password hashing module (m_password_hash.so)
 144       # loaded. Options here are: "md5", "sha256" and "ripemd160".
 145       # Create hashed password with: /mkpasswd <hash> <password>
 146       hash="sha256"
 147
 148       # password: a hash of your password (see above option) hashed
 149       # with /mkpasswd <hash> <password> . See m_password_hash in modules.conf
 150       # for more information about password hashing.
 151       password="1ec1c26b50d5d3c58d9583181af8076655fe00756bf7285940ba3670f99fcba0"
 152
 153       # host: What hostnames/IP's are allowed to oper up with this oline.
 154       # Multiple options can be separated by spaces and CIDR's are allowed.
 155       # You CAN use just * or *@* for this section, but it is not recommended
 156       # for security reasons.
 157       host="ident@dialup15.isp.com *@localhost *@server.com *@3ffe::0/16"
 158
 159       # type: What oper type this oline is. See the block above for list
 160       # of types. NOTE: This is case-sensitive as well.
 161       type="NetAdmin">