1 #-#-#-#-#-#-#-#-#-#-#-#-# CLASS CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#
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. #
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). #
17 # commands: Oper-only commands that opers of this class can run.
18 commands="DIE RESTART REHASH LOADMODULE UNLOADMODULE RELOADMODULE GLOADMODULE GUNLOADMODULE GRELOADMODULE"
20 # privs: Special privileges that users with this class may utilise.
22 # - channels/auspex: allows opers with this priv to see more details about channels than normal users.
23 # - users/auspex: allows opers with this priv to view more details about users than normal users, e.g. real host and IP.
24 # - users/channel-spy: allows opers with this priv to view the private/secret channels that a user is on.
25 # - servers/auspex: allows opers with this priv to see more details about server information than normal users.
27 # - users/mass-message: allows opers with this priv to PRIVMSG and NOTICE to a server mask (e.g. NOTICE $*).
28 # - users/samode-usermodes: allows opers with this priv to change the user modes of any other user using /SAMODE.
30 # - channels/ignore-noctcp: allows opers with this priv to send a CTCP to a +C channel.
31 # - channels/ignore-nonicks: allows opers with this priv to change their nick when on a +N channel.
32 # - channels/restricted-create: allows opers with this priv to create channels if the restrictchans module is loaded.
33 # - users/flood/no-fakelag: prevents opers from being penalized with fake lag for flooding (*NOTE).
34 # - users/flood/no-throttle: allows opers with this priv to send commands without being throttled (*NOTE).
35 # - users/flood/increased-buffers: allows opers with this priv to send and receive data without worrying about being disconnected for exceeding limits (*NOTE).
36 # - users/callerid-override: allows opers with this priv to message people using callerid without being on their callerid list.
37 # - users/ignore-commonchans: allows opers with this priv to send a message to a +c user without sharing common channels.
38 # - users/ignore-noctcp: allows opers with this priv to send a CTCP to a +T user.
39 # - users/privdeaf-override: allows opers with this priv to message users with +D set.
40 # - users/sajoin-others: allows opers with this priv to /SAJOIN users other than themselves.
41 # - servers/use-disabled-commands: allows opers with this priv to use disabled commands.
42 # - servers/use-disabled-modes: allows opers with this priv to use disabled modes.
44 # *NOTE: These privs are potentially dangerous, as they grant users with them the ability to hammer your server's CPU/RAM as much as they want, essentially.
45 privs="users/auspex channels/auspex servers/auspex users/mass-message users/flood/no-throttle users/flood/increased-buffers"
47 # usermodes: Oper-only usermodes that opers with this class can use.
50 # chanmodes: Oper-only channel modes that opers with this class can use.
53 <class name="SACommands" commands="SAJOIN SAPART SANICK SAQUIT SATOPIC SAKICK SAMODE OJOIN">
54 <class name="ServerLink" commands="CONNECT SQUIT RCONNECT RSQUIT MKPASSWD ALLTIME SWHOIS LOCKSERV UNLOCKSERV" usermodes="*" chanmodes="*" privs="servers/auspex">
55 <class name="BanControl" commands="KILL GLINE KLINE ZLINE QLINE ELINE TLINE RLINE CHECK NICKLOCK NICKUNLOCK SHUN CLONES CBAN" usermodes="*" chanmodes="*">
56 <class name="OperChat" commands="WALLOPS GLOBOPS" usermodes="*" chanmodes="*" privs="users/mass-message">
57 <class name="HostCloak" commands="SETHOST SETIDENT SETIDLE CHGNAME CHGHOST CHGIDENT" usermodes="*" chanmodes="*" privs="users/auspex">
60 #-#-#-#-#-#-#-#-#-#-#-#- OPERATOR COMPOSITION -#-#-#-#-#-#-#-#-#-#-#
62 # This is where you specify which types of operators you have on #
63 # your server, as well as the commands they are allowed to use. #
64 # This works alongside with the classes specified above. #
68 # name: Name of the type. Used in actual server operator accounts below.
71 # classes: Classes (blocks above) that this type belongs to.
72 classes="SACommands OperChat BanControl HostCloak Shutdown ServerLink"
74 # vhost: Host that opers of this type get when they log in (oper up). This is optional.
75 vhost="netadmin.omega.example.org"
77 # maxchans: Maximum number of channels opers of this type can be in at once.
80 # modes: User modes besides +o that are set on an oper of this type
81 # when they oper up. Used for snomasks and other things.
82 # Requires the opermodes module to be loaded.
85 <type name="GlobalOp" classes="SACommands OperChat BanControl HostCloak ServerLink" vhost="ircop.omega.example.org">
86 <type name="Helper" classes="HostCloak" vhost="helper.omega.example.org">
89 #-#-#-#-#-#-#-#-#-#-#- OPERATOR CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#
91 # Opers are defined here. This is a very important section. #
92 # Remember to only make operators out of trustworthy people. #
95 # Operator account with a plaintext password.
97 # name: Oper login that is used to oper up (/OPER <username> <password>).
98 # Remember: This is case sensitive.
101 # password: Case-sensitive, unhashed (plaintext).
104 # host: What hostnames and IPs are allowed to use this operator account.
105 # Multiple options can be separated by spaces and CIDRs are allowed.
106 # You can use just * or *@* for this section, but it is not recommended
107 # for security reasons.
108 host="attila@inspircd.org *@2001:db8::/32"
110 # ** ADVANCED ** This option is disabled by default.
111 # fingerprint: When using the sslinfo module, you may specify
112 # a key fingerprint here. This can be obtained by using the /SSLINFO
113 # command while the module is loaded, and is also noticed on connect.
114 # This enhances security by verifying that the person opering up has
115 # a matching SSL client certificate, which is very difficult to
116 # forge (impossible unless preimage attacks on the hash exist).
117 # If the sslinfo module isn't loaded, this option will be ignored.
118 #fingerprint="67cb9dc013248a829bb2171ed11becd4"
120 # autologin: If an SSL certificate fingerprint for this oper is specified,
121 # you can have the oper block automatically log in. This moves all security
122 # of the oper block to the protection of the client certificate, so be sure
123 # that the private key is well-protected! Requires the sslinfo module.
126 # sslonly: If on, this oper can only oper up if they're using an SSL connection.
127 # Setting this option adds a decent bit of security. Highly recommended
128 # if the oper is on wifi, or specifically, unsecured wifi. Note that it
129 # is redundant to specify this option if you specify a fingerprint.
130 # This setting only takes effect if the sslinfo module is loaded.
133 # vhost: Overrides the vhost in the type block. Class and modes may also
135 vhost="attila.example.org"
137 # type: Which type of operator this person is; see the block
138 # above for the list of types. NOTE: This is case-sensitive as well.
141 # Operator with a plaintext password and no comments, for easy copy & paste.
144 password="youshouldhashthis"
145 host="brain@dialup15.isp.test.com *@localhost *@example.com *@2001:db8::/32"
146 #fingerprint="67cb9dc013248a829bb2171ed11becd4"
149 # Operator with a hashed password. It is highly recommended to use hashed passwords.
151 # name: Oper login that is used to oper up (/OPER <username> <password>).
152 # Remember: This is case sensitive.
155 # hash: The hash function this password is hashed with. Requires the
156 # module for the selected function (bcrypt, md5, sha1, or sha256) and
157 # the password hashing module (password_hash) to be loaded.
159 # You may also use any of the above other than bcrypt prefixed with
160 # either "hmac-" or "pbkdf2-hmac-" (requires the pbkdf2 module).
161 # Create hashed passwords with: /MKPASSWD <hashtype> <plaintext>.
164 # password: A hash of the password (see above option) hashed
165 # with /MKPASSWD <hashtype> <plaintext>. See the password_hash module
166 # in modules.conf for more information about password hashing.
167 password="qQmv3LcF$Qh63wzmtUqWp9OXnLwe7yv1GcBwHpq59k2a0UrY8xe0"
169 # host: What hostnames and IPs are allowed to use this operator account.
170 # Multiple options can be separated by spaces and CIDRs are allowed.
171 # You can use just * or *@* for this section, but it is not recommended
172 # for security reasons.
173 host="*@127.0.0.1 *@192.0.2.40 *@198.51.100.4"
175 # type: Which type of operator this person is; see the block
176 # above for the list of types. NOTE: This is case-sensitive as well.
179 # Once you have edited this file you can remove this line. This is just to
180 # ensure that you don't hastily include the file without reading it.
181 <die reason="Using opers.conf.example without editing it is a security risk">