Advertisement
Guest User

Untitled

a guest
Mar 29th, 2017
142
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 40.77 KB | None | 0 0
  1. /*
  2. * Example configuration file for Services. After making the appropriate
  3. * changes to this file, place it in the Services conf directory (as
  4. * specified in the "configure" script, default /home/username/services/conf)
  5. * under the name "services.conf".
  6. *
  7. * The format of this file is fairly simple: three types of comments are supported:
  8. * - All text after a '#' on a line is ignored, as in shell scripting
  9. * - All text after '//' on a line is ignored, as in C++
  10. * - A block of text like this one is ignored, as in C
  11. *
  12. * Outside of comments, there are three structures: blocks, keys, and values.
  13. *
  14. * A block is a named container, which contains a number of key to value pairs
  15. * - you may think of this as an array.
  16. *
  17. * A block is created like so:
  18. * foobar
  19. * {
  20. * moo = "cow"
  21. * foo = bar
  22. * }
  23. *
  24. * Note that nameless blocks are allowed and are often used with comments to allow
  25. * easily commenting an entire block, for example:
  26. * #foobar
  27. * {
  28. * moo = "cow"
  29. * foo = bar
  30. * }
  31. * is an entirely commented block.
  32. *
  33. * Keys are case insensitive. Values depend on what key - generally, information is
  34. * given in the key comment. The quoting of values (and most other syntax) is quite
  35. * flexible, however, please do not forget to quote your strings:
  36. *
  37. * "This is a parameter string with spaces in it"
  38. *
  39. * If you need to include a double quote inside a quoted string, precede it
  40. * by a backslash:
  41. *
  42. * "This string has \"double quotes\" in it"
  43. *
  44. * Time parameters can be specified either as an integer representing a
  45. * number of seconds (e.g. "3600" = 1 hour), or as an integer with a unit
  46. * specifier: "s" = seconds, "m" = minutes, "h" = hours, "d" = days.
  47. * Combinations (such as "1h30m") are not permitted. Examples (all of which
  48. * represent the same length of time, one day):
  49. *
  50. * "86400", "86400s", "1440m", "24h", "1d"
  51. *
  52. * In the documentation for each directive, one of the following will be
  53. * included to indicate whether an option is required:
  54. *
  55. * [REQUIRED]
  56. * Indicates a directive which must be given. Without it, Services will
  57. * not start.
  58. *
  59. * [RECOMMENDED]
  60. * Indicates a directive which may be omitted, but omitting it may cause
  61. * undesirable side effects.
  62. *
  63. * [OPTIONAL]
  64. * Indicates a directive which is optional. If not given, the feature
  65. * will typically be disabled. If this is not the case, more
  66. * information will be given in the documentation.
  67. *
  68. * [DISCOURAGED]
  69. * Indicates a directive which may cause undesirable side effects if
  70. * specified.
  71. *
  72. * [DEPRECATED]
  73. * Indicates a directive which will disappear in a future version of
  74. * Services, usually because its functionality has been either
  75. * superseded by that of other directives or incorporated into the main
  76. * program.
  77. */
  78.  
  79. /*
  80. * [OPTIONAL] Defines
  81. *
  82. * You can define values to other values, which can be used to easily change
  83. * many values in the configuration. at once.
  84. */
  85.  
  86. /*
  87. * The services.host define is used in multiple different locations throughout the
  88. * configuration for services clients hostnames.
  89. */
  90. define
  91. {
  92. name = "services.mynet"
  93. value = "services.mynet.com"
  94. }
  95.  
  96. /*
  97. * [OPTIONAL] Additional Includes
  98. *
  99. * You can include additional configuration files here.
  100. * You may also include executable files, which will be executed and
  101. * the output from it will be included into your configuration.
  102. */
  103.  
  104. #include
  105. {
  106. type = "file"
  107. name = "some.conf"
  108. }
  109.  
  110. #include
  111. {
  112. type = "executable"
  113. name = "/usr/bin/wget -q -O - http://some.misconfigured.network.com/services.conf"
  114. }
  115.  
  116. /*
  117. * [REQUIRED] IRCd Config
  118. *
  119. * This section is used to set up Anope to connect to your IRC network.
  120. * This section can be included multiple times, and Anope will attempt to
  121. * connect to each server until it finally connects.
  122. *
  123. * Each uplink IRCd should have a corresponding configuration to allow Services
  124. * to link to it.
  125. *
  126. * An example configuration for InspIRCd that is compatible with the below uplink
  127. * and serverinfo configuration would look like:
  128. *
  129. * <link name="services.localhost.net"
  130. * ipaddr="127.0.0.1"
  131. * port="7000"
  132. * sendpass="mypassword"
  133. * recvpass="mypassword">
  134. * <uline server="services.localhost.net" silent="yes">
  135. * <bind address="127.0.0.1" port="7000" type="servers">
  136. *
  137. * An example configuration for UnrealIRCd that is compatible with the below uplink
  138. * and serverinfo configuration would look like:
  139. *
  140. * link services.localhost.net
  141. * {
  142. * username *;
  143. * hostname *;
  144. * bind-ip "127.0.0.1";
  145. * port 7000;
  146. * hub *;
  147. * password-connect "mypassword";
  148. * password-receive "mypassword";
  149. * class servers;
  150. * };
  151. * ulines { services.localhost.net; };
  152. * listen 127.0.0.1:7000;
  153. */
  154. uplink
  155. {
  156. /*
  157. * The IP or hostname of the IRC server you wish to connect Services to.
  158. * Usually, you will want to connect Services over 127.0.0.1 (aka localhost).
  159. *
  160. * NOTE: On some shell providers, this will not be an option.
  161. */
  162. host = "server ip"
  163.  
  164. /*
  165. * Enable if Services should connect using IPv6.
  166. */
  167. ipv6 = no
  168.  
  169. /*
  170. * Enable if Services should connect using SSL.
  171. * You must have an SSL module loaded for this to work.
  172. */
  173. ssl = no
  174.  
  175. /*
  176. * The port to connect to.
  177. * The IRCd *MUST* be configured to listen on this port, and to accept
  178. * server connections.
  179. *
  180. * Refer to your IRCd documentation for how this is to be done.
  181. */
  182. port = 7000
  183.  
  184. /*
  185. * The password to send to the IRC server for authentication.
  186. * This must match the link block on your IRCd.
  187. *
  188. * Refer to your IRCd documentation for more information on link blocks.
  189. */
  190. password = "mypass"
  191. }
  192.  
  193. /*
  194. * [REQUIRED] Server Information
  195. *
  196. * This section contains information about the Services server.
  197. */
  198. serverinfo
  199. {
  200. /*
  201. * The hostname that Services will be seen as, it must have no conflicts with any
  202. * other server names on the rest of your IRC network. Note that it does not have
  203. * to be an existing hostname, just one that isn't on your network already.
  204. */
  205. name = "services.mynet.com"
  206.  
  207. /*
  208. * The text which should appear as the server's information in /whois and similar
  209. * queries.
  210. */
  211. description = "Services for IRC Networks"
  212.  
  213. /*
  214. * The local address that Services will bind to before connecting to the remote
  215. * server. This may be useful for multihomed hosts. If omitted, Services will let
  216. * the Operating System choose the local address. This directive is optional.
  217. *
  218. * If you don't know what this means or don't need to use it, just leave this
  219. * directive commented out.
  220. */
  221. #localhost = "nowhere."
  222.  
  223. /*
  224. * What Server ID to use for this connection?
  225. * Note: This should *ONLY* be used for TS6/P10 IRCds. Refer to your IRCd documentation
  226. * to see if this is needed.
  227. */
  228. id = "00A"
  229.  
  230. /*
  231. * The filename containing the Services process ID. The path is relative to the
  232. * services root directory.
  233. */
  234. pid = "data/services.pid"
  235.  
  236. /*
  237. * The filename containing the Message of the Day. The path is relative to the
  238. * services root directory.
  239. */
  240. motd = "conf/services.motd"
  241. }
  242.  
  243. /*
  244. * [REQUIRED] Protocol module
  245. *
  246. * This directive tells Anope which IRCd Protocol to speak when connecting.
  247. * You MUST modify this to match the IRCd you run.
  248. *
  249. * Supported:
  250. * - bahamut
  251. * - charybdis
  252. * - hybrid
  253. * - inspircd12
  254. * - inspircd20
  255. * - ngircd
  256. * - plexus
  257. * - ratbox
  258. * - unreal (for 3.2.x)
  259. * - unreal4
  260. */
  261. module
  262. {
  263. name = "inspircd20"
  264.  
  265. /*
  266. * Some protocol modules can enforce mode locks server-side. This reduces the spam caused by
  267. * services immediately reversing mode changes for locked modes.
  268. *
  269. * If the protocol module you have loaded does not support this, this setting will have no effect.
  270. */
  271. use_server_side_mlock = yes
  272.  
  273. /*
  274. * Some protocol modules can enforce topic locks server-side. This reduces the spam caused by
  275. * services immediately reversing topic changes.
  276. *
  277. * If the protocol module you have loaded does not support this, this setting will have no effect.
  278. */
  279. use_server_side_topiclock = yes
  280. }
  281.  
  282. /*
  283. * [REQUIRED] Network Information
  284. *
  285. * This section contains information about the IRC network that Services will be
  286. * connecting to.
  287. */
  288. networkinfo
  289. {
  290. /*
  291. * This is the name of the network that Services will be running on.
  292. */
  293. networkname = "mynet"
  294.  
  295. /*
  296. * Set this to the maximum allowed nick length on your network.
  297. * Be sure to set this correctly, as setting this wrong can result in
  298. * Services being disconnected from the network.
  299. */
  300. nicklen = 31
  301.  
  302. /* Set this to the maximum allowed ident length on your network.
  303. * Be sure to set this correctly, as setting this wrong can result in
  304. * Services being disconnected from the network.
  305. */
  306. userlen = 10
  307.  
  308. /* Set this to the maximum allowed hostname length on your network.
  309. * Be sure to set this correctly, as setting this wrong can result in
  310. * Services being disconnected from the network.
  311. */
  312. hostlen = 64
  313.  
  314. /* Set this to the maximum allowed channel length on your network.
  315. */
  316. chanlen = 32
  317.  
  318. /* The maximum number of list modes settable on a channel (such as b, e, I).
  319. * Comment out or set to 0 to disable.
  320. */
  321. modelistsize = 100
  322.  
  323. /*
  324. * Characters allowed in nicknames. This always includes the characters described
  325. * in RFC1459, and so does not need to be set for normal behavior. Changing this to
  326. * include characters your IRCd doesn't support will cause your IRCd and/or Services
  327. * to break. Multibyte characters are not supported, nor are escape sequences.
  328. *
  329. * It is recommended you DON'T change this. /
  330. #nick_chars = ""
  331.  
  332. /*
  333. * The characters allowed in hostnames. This is used for validating hostnames given
  334. * to services, such as BotServ bot hostnames and user vhosts. Changing this is not
  335. * recommended unless you know for sure your IRCd supports whatever characters you are
  336. * wanting to use. Telling services to set a vHost containing characters your IRCd
  337. * disallows could potentially break the IRCd and/or Services.
  338. *
  339. * It is recommended you DON'T change this.
  340. */
  341. vhost_chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789.-"
  342.  
  343. /*
  344. * If set to true, allows vHosts to not contain dots (.).
  345. * Newer IRCds generally do not have a problem with this, but the same warning as
  346. * vhost_chars applies.
  347. *
  348. * It is recommended you DON'T change this.
  349. */
  350. allow_undotted_vhosts = false
  351.  
  352. /*
  353. * The characters that are not allowed to be at the very beginning or very ending
  354. * of a vHost. The same warning as vhost_chars applies.
  355. *
  356. * It is recommended you DON'T change this.
  357. */
  358. disallow_start_or_end = ".-"
  359. }
  360.  
  361. /*
  362. * [REQUIRED] Services Options
  363. *
  364. * This section contains various options which determine how Services will operate.
  365. */
  366. options
  367. {
  368. /*
  369. * On Linux/UNIX systems Anope can setuid and setgid to this user and group
  370. * after starting up. This is useful if Anope has to bind to privileged ports
  371. */
  372. user = "anope"
  373. group = "anope"
  374.  
  375. /*
  376. * The case mapping used by services. This must be set to a valid locale name
  377. * installed on your machine. Services use this case map to compare, with
  378. * case insensitivity, things such as nick names, channel names, etc.
  379. *
  380. * We provide two special casemaps shipped with Anope, ascii and rfc1459.
  381. *
  382. * This value should be set to what your IRCd uses, which is probably rfc1459,
  383. * however Anope has always used ascii for comparison, so the default is ascii.
  384. *
  385. * Changing this value once set is not recommended.
  386. */
  387. casemap = "ascii"
  388.  
  389. /*
  390. * This key is used to initiate the random number generator. This number
  391. * MUST be random as you want your passcodes to be random. Don't give this
  392. * key to anyone! Keep it private!
  393. *
  394. * NOTE: If you don't uncomment this or keep the default values, any talented
  395. * programmer would be able to easily "guess" random strings used to mask
  396. * information. Be safe, and come up with a 7-digit number.
  397. *
  398. * This directive is optional, but highly recommended.
  399. */
  400. seed = seed
  401.  
  402. /*
  403. * If set, Services will perform more stringent checks on passwords. If this
  404. * isn't set, Services will only disallow a password if it is the same as the
  405. * entity (nickname name) with which it is associated. When set, however,
  406. * Services will also check that the password is at least five
  407. * characters long, and in the future will probably check other things
  408. * as well.
  409. *
  410. * This directive is optional, but recommended.
  411. */
  412. strictpasswords = yes
  413.  
  414. /*
  415. * Sets the number of invalid password tries before Services removes a user
  416. * from the network. If a user enters a number of invalid passwords equal to
  417. * the given amount for any Services function or combination of functions
  418. * during a single IRC session (subject to badpasstimeout, below), Services
  419. * will issues a /KILL for the user. If not given, Services will ignore
  420. * failed password attempts (though they will be logged in any case).
  421. *
  422. * This directive is optional, but recommended.
  423. */
  424. badpasslimit = 5
  425.  
  426. /*
  427. * Sets the time after which invalid passwords are forgotten about. If a user
  428. * does not enter any incorrect passwords in this amount of time, the incorrect
  429. * password count will reset to zero. If not given, the timeout will be
  430. * disabled, and the incorrect password count will never be reset until the user
  431. * disconnects.
  432. *
  433. * This directive is optional.
  434. */
  435. badpasstimeout = 1h
  436.  
  437. /*
  438. * Sets the delay between automatic database updates.
  439. */
  440. updatetimeout = 5m
  441.  
  442. /*
  443. * Sets the delay between checks for expired nicknames and channels.
  444. */
  445. expiretimeout = 30m
  446.  
  447. /*
  448. * Sets the timeout period for reading from the uplink.
  449. */
  450. readtimeout = 5s
  451.  
  452. /*
  453. * Sets the interval between sending warning messages for program errors via
  454. * WALLOPS/GLOBOPS.
  455. */
  456. warningtimeout = 4h
  457.  
  458. /*
  459. * Sets the (maximum) frequency at which the timeout list is checked. This,
  460. * combined with readtimeout above, determines how accurately timed events,
  461. * such as nick kills, occur; it also determines how much CPU time Services
  462. * will use doing this. Higher values will cause less accurate timing but
  463. * less CPU usage.
  464. *
  465. * Note that this value is not an absolute limit on the period between
  466. * checks of the timeout list; the previous may be as great as readtimeout
  467. * (above) during periods of inactivity.
  468. *
  469. * If this directive is not given, it will default to 0.
  470. */
  471. timeoutcheck = 3s
  472.  
  473. /*
  474. * If set, this will allow users to let Services send PRIVMSGs to them
  475. * instead of NOTICEs. Also see the "msg" option of nickserv:defaults,
  476. * which also toggles the default communication (PRIVMSG or NOTICE) to
  477. * use for unregistered users.
  478. *
  479. * This is a feature that is against the IRC RFC and should be used ONLY
  480. * if absolutely necessary.
  481. *
  482. * This directive is optional, and not recommended.
  483. */
  484. #useprivmsg = yes
  485.  
  486. /*
  487. * If set, will force Services to only respond to PRIVMSGs addresses to
  488. * Nick@ServerName - e.g. NickServ@localhost.net. This should be used in
  489. * conjunction with IRCd aliases. This directive is optional.
  490. *
  491. * This option will have no effect on some IRCds, such as TS6 IRCds.
  492. */
  493. #usestrictprivmsg = yes
  494.  
  495. /*
  496. * If set, Services will only show /stats o to IRC Operators. This directive
  497. * is optional.
  498. */
  499. hidestatso = yes
  500.  
  501. /*
  502. * A space-separated list of ulined servers on your network, it is assumed that
  503. * the servers in this list are allowed to set channel modes and Services will
  504. * not attempt to reverse their mode changes.
  505. *
  506. * WARNING: Do NOT put your normal IRC user servers in this directive.
  507. *
  508. * This directive is optional.
  509. */
  510. #ulineservers = "stats.your.network"
  511.  
  512. /*
  513. * How long to wait between connection retries with the uplink(s).
  514. */
  515. retrywait = 60s
  516.  
  517. /*
  518. * If set, Services will hide commands that users don't have the privilege to execute
  519. * from HELP output.
  520. */
  521. hideprivilegedcommands = yes
  522.  
  523. /*
  524. * If set, Services will hide commands that users can't execute because they are not
  525. * logged in from HELP output.
  526. */
  527. hideregisteredcommands = yes
  528.  
  529. /* The regex engine to use, as provided by the regex modules.
  530. * Leave commented to disable regex matching.
  531. *
  532. * Note for this to work the regex module providing the regex engine must be loaded.
  533. */
  534. regexengine = "regex/pcre"
  535.  
  536. /*
  537. * A list of languages to load on startup that will be available in /nickserv set language.
  538. * Useful if you translate Anope to your language. (Explained further in docs/LANGUAGE).
  539. * Note that english should not be listed here because it is the base language.
  540. *
  541. * Removing .UTF-8 will instead use the default encoding for the language, eg. iso-8859-1 for western European languages.
  542. */
  543. languages = "ar_AR ar_SA ar_EG"
  544.  
  545. /*
  546. * Default language that non- and newly-registered nicks will receive messages in.
  547. * Set to "en" to enable English. Defaults to the language the system uses.
  548. */
  549. #defaultlanguage = "ar_AR"
  550. }
  551.  
  552. /*
  553. * [OPTIONAL] BotServ
  554. *
  555. * Includes botserv.example.conf, which is necessary for BotServ functionality.
  556. *
  557. * Remove this block to disable BotServ.
  558. */
  559. include
  560. {
  561. type = "file"
  562. name = "botserv.conf"
  563. }
  564.  
  565. /*
  566. * [RECOMMENDED] ChanServ
  567. *
  568. * Includes chanserv.example.conf, which is necessary for ChanServ functionality.
  569. *
  570. * Remove this block to disable ChanServ.
  571. */
  572. include
  573. {
  574. type = "file"
  575. name = "chanserv.conf"
  576. }
  577.  
  578. /*
  579. * [RECOMMENDED] Global
  580. *
  581. * Includes global.example.conf, which is necessary for Global functionality.
  582. *
  583. * Remove this block to disable Global.
  584. */
  585. include
  586. {
  587. type = "file"
  588. name = "global.conf"
  589. }
  590.  
  591. /*
  592. * [OPTIONAL] HostServ
  593. *
  594. * Includes hostserv.example.conf, which is necessary for HostServ functionality.
  595. *
  596. * Remove this block to disable HostServ.
  597. */
  598. include
  599. {
  600. type = "file"
  601. name = "hostserv.conf"
  602. }
  603.  
  604. /*
  605. * [OPTIONAL] MemoServ
  606. *
  607. * Includes memoserv.example.conf, which is necessary for MemoServ functionality.
  608. *
  609. * Remove this block to disable MemoServ.
  610. */
  611. include
  612. {
  613. type = "file"
  614. name = "memoserv.conf"
  615. }
  616.  
  617. /*
  618. * [OPTIONAL] NickServ
  619. *
  620. * Includes nickserv.example.conf, which is necessary for NickServ functionality.
  621. *
  622. * Remove this block to disable NickServ.
  623. */
  624. include
  625. {
  626. type = "file"
  627. name = "nickserv.conf"
  628. }
  629.  
  630. /*
  631. * [RECOMMENDED] OperServ
  632. *
  633. * Includes operserv.example.conf, which is necessary for OperServ functionality.
  634. *
  635. * Remove this block to disable OperServ.
  636. */
  637. include
  638. {
  639. type = "file"
  640. name = "operserv.conf"
  641. }
  642.  
  643. /*
  644. * [RECOMMENDED] Logging Configuration
  645. *
  646. * This section is used for configuring what is logged and where it is logged to.
  647. * You may have multiple log blocks if you wish. Remember to properly secure any
  648. * channels you choose to have Anope log to!
  649. */
  650. log
  651. {
  652. /*
  653. * Target(s) to log to, which may be one of the following:
  654. * - a channel name
  655. * - a filename
  656. * - globops
  657. */
  658. target = "services.log"
  659.  
  660. /* Log to both services.log and the channel #services
  661. *
  662. * Note that some older IRCds, such as Ratbox, require services to be in the
  663. * log channel to be able to message it. To do this, configure service:channels to
  664. * join your logging channel.
  665. */
  666. #target = "services.log #services"
  667.  
  668. /*
  669. * The source(s) to only accept log messages from. Leave commented to allow all sources.
  670. * This can be a users name, a channel name, one of our clients (eg, OperServ), or a server name.
  671. */
  672. #source = ""
  673.  
  674. /*
  675. * The bot used to log generic messages which have no predefined sender if there
  676. * is a channel in the target directive.
  677. */
  678. bot = "Global"
  679.  
  680. /*
  681. * The number of days to keep logfiles, only useful if you are logging to a file.
  682. * Set to 0 to never delete old logfiles.
  683. *
  684. * Note that Anope must run 24 hours a day for this feature to work correctly.
  685. */
  686. logage = 7
  687.  
  688. /*
  689. * What types of log messages should be logged by this block. There are nine general categories:
  690. *
  691. * admin - Execution of admin commands (OperServ, etc).
  692. * override - A services operator using their powers to execute a command they couldn't normally.
  693. * commands - Execution of general commands.
  694. * servers - Server actions, linking, squitting, etc.
  695. * channels - Actions in channels such as joins, parts, kicks, etc.
  696. * users - User actions such as connecting, disconnecting, changing name, etc.
  697. * other - All other messages without a category.
  698. * rawio - Logs raw input and output from services
  699. * debug - Debug messages (log files can become VERY large from this).
  700. *
  701. * These options determine what messages from the categories should be logged. Wildcards are accepted, and
  702. * you can also negate values with a ~. For example, "~operserv/akill operserv/*" would log all operserv
  703. * messages except for operserv/akill. Note that processing stops at the first matching option, which
  704. * means "* ~operserv/*" would log everything because * matches everything.
  705. *
  706. * Valid admin, override, and command options are:
  707. * pesudo-serv/commandname (eg, operserv/akill, chanserv/set)
  708. *
  709. * Valid server options are:
  710. * connect, quit, sync, squit
  711. *
  712. * Valid channel options are:
  713. * create, destroy, join, part, kick, leave, mode
  714. *
  715. * Valid user options are:
  716. * connect, disconnect, quit, nick, ident, host, mode, maxusers, oper, away
  717. *
  718. * Rawio and debug are simple yes/no answers, there are no types for them.
  719. *
  720. * Note that modules may add their own values to these options.
  721. */
  722. admin = "*"
  723. override = "chanserv/* nickserv/* memoserv/set ~botserv/set botserv/*"
  724. commands = "~operserv/* *"
  725. servers = "*"
  726. #channels = "~mode *"
  727. users = "connect disconnect nick"
  728. other = "*"
  729. rawio = no
  730. debug = no
  731. }
  732.  
  733. /*
  734. * A log block to globops some useful things.
  735. */
  736. log
  737. {
  738. target = "globops"
  739. admin = "global/* operserv/chankill operserv/mode operserv/kick operserv/akill operserv/s*line operserv/noop operserv/jupe operserv/oline operserv/set operserv/svsnick operserv/svsjoin operserv/svspart nickserv/getpass */drop"
  740. servers = "squit"
  741. users = "oper"
  742. other = "expire/* bados akill/*"
  743. }
  744.  
  745. /*
  746. * [RECOMMENDED] Oper Access Config
  747. *
  748. * This section is used to set up staff access to restricted oper only commands.
  749. * You may define groups of commands and privileges, as well as who may use them.
  750. *
  751. * This block is recommended, as without it you will be unable to access most oper commands.
  752. * It replaces the old ServicesRoot directive amongst others.
  753. *
  754. * The command names below are defaults and are configured in the *serv.conf's. If you configure
  755. * additional commands with permissions, such as commands from third party modules, the permissions
  756. * must be included in the opertype block before the command can be used.
  757. *
  758. * Available privileges:
  759. * botserv/administration - Can view and assign private BotServ bots
  760. * botserv/fantasy - Can use fantasy commands without the FANTASIA privilege
  761. * chanserv/administration - Can modify the settings of any channel (including changing of the owner!)
  762. * chanserv/access/list - Can view channel access and akick lists, but not modify them
  763. * chanserv/access/modify - Can modify channel access and akick lists, and use /chanserv enforce
  764. * chanserv/auspex - Can see any information with /chanserv info
  765. * chanserv/no-register-limit - May register an unlimited number of channels and nicknames
  766. * chanserv/kick - Can kick and ban users from channels through ChanServ
  767. * memoserv/info - Can see any information with /memoserv info
  768. * memoserv/set-limit - Can set the limit of max stored memos on any user and channel
  769. * memoserv/no-limit - Can send memos through limits and throttles
  770. * nickserv/access - Can modify other users access and certificate lists
  771. * nickserv/alist - Can see the channel access list of other users
  772. * nickserv/auspex - Can see any information with /nickserv info
  773. * nickserv/confirm - Can confirm other users nicknames
  774. * nickserv/drop - Can drop other users nicks
  775. * operserv/config - Can modify services's configuration
  776. * operserv/oper/modify - Can add and remove operators with at most the same privileges
  777. * protected - Can not be kicked from channels by Services
  778. *
  779. * Available commands:
  780. * botserv/bot/del botserv/bot/add botserv/bot/change botserv/set/private
  781. * botserv/set/nobot
  782. *
  783. * chanserv/drop chanserv/getkey chanserv/invite
  784. * chanserv/list chanserv/suspend chanserv/topic
  785. *
  786. * chanserv/saset/noexpire
  787. *
  788. * memoserv/sendall memoserv/staff
  789. *
  790. * nickserv/getpass nickserv/getemail nickserv/suspend nickserv/ajoin
  791. * nickserv/list
  792. *
  793. * nickserv/saset/autoop nickserv/saset/email nickserv/saset/greet nickserv/saset/password
  794. * nickserv/saset/display nickserv/saset/kill nickserv/saset/language nickserv/saset/message
  795. * nickserv/saset/private nickserv/saset/secure nickserv/saset/url nickserv/saset/noexpire
  796. * nickserv/saset/keepmodes
  797. *
  798. * hostserv/set hostserv/del hostserv/list
  799. *
  800. * global/global
  801. *
  802. * operserv/news operserv/stats operserv/kick operserv/exception operserv/seen
  803. * operserv/mode operserv/session operserv/modinfo operserv/ignore operserv/chanlist
  804. * operserv/chankill operserv/akill operserv/sqline operserv/snline operserv/userlist
  805. * operserv/oper operserv/config operserv/umode operserv/logsearch
  806. * operserv/modload operserv/jupe operserv/set operserv/noop
  807. * operserv/quit operserv/update operserv/reload operserv/restart
  808. * operserv/shutdown operserv/svs operserv/oline operserv/kill
  809. *
  810. * Firstly, we define 'opertypes' which are named whatever we want ('Network Administrator', etc).
  811. * These can contain commands for oper-only strings (see above) which grants access to that specific command,
  812. * and privileges (which grant access to more general permissions for the named area).
  813. * Wildcard entries are permitted for both, e.g. 'commands = "operserv/*"' for all OperServ commands.
  814. *
  815. * Below are some default example types, but this is by no means exhaustive,
  816. * and it is recommended that you configure them to your needs.
  817. */
  818.  
  819. opertype
  820. {
  821. /* The name of this opertype */
  822. name = "Helper"
  823.  
  824. /* What commands (see above) this opertype has */
  825. commands = "hostserv/*"
  826. }
  827.  
  828. opertype
  829. {
  830. /* The name of this opertype */
  831. name = "Services Operator"
  832.  
  833. /* What opertype(s) this inherits from. Separate with a comma. */
  834. inherits = "Helper, Another Helper"
  835.  
  836. /* What commands (see above) this opertype may use */
  837. commands = "chanserv/list chanserv/suspend chanserv/topic memoserv/staff nickserv/list nickserv/suspend operserv/mode operserv/chankill operserv/akill operserv/session operserv/modinfo operserv/sqline operserv/oper operserv/kick operserv/ignore operserv/snline"
  838.  
  839. /* What privs (see above) this opertype has */
  840. privs = "chanserv/auspex chanserv/no-register-limit memoserv/* nickserv/auspex nickserv/confirm"
  841.  
  842. /*
  843. * Modes to be set on users when they identify to accounts linked to this opertype.
  844. *
  845. * This can be used to automatically oper users who identify for services operator accounts, and is
  846. * useful for setting modes such as Plexus's user mode +N.
  847. *
  848. * Note that some IRCds, such as InspIRCd, do not allow directly setting +o, and this will not work.
  849. */
  850. #modes = "+o"
  851. }
  852.  
  853. opertype
  854. {
  855. name = "Services Administrator"
  856.  
  857. inherits = "Services Operator"
  858.  
  859. commands = "botserv/* chanserv/access/list chanserv/drop chanserv/getkey chanserv/saset/noexpire memoserv/sendall nickserv/saset/* nickserv/getemail operserv/news operserv/jupe operserv/svs operserv/stats operserv/oline operserv/noop operserv/forbid global/*"
  860.  
  861. privs = "*"
  862. }
  863.  
  864. opertype
  865. {
  866. name = "Services Root"
  867.  
  868. commands = "*"
  869.  
  870. privs = "*"
  871. }
  872.  
  873. /*
  874. * After defining different types of operators in the above opertype section, we now define who is in these groups
  875. * through 'oper' blocks, similar to ircd access.
  876. *
  877. * The default is to comment these out (so NOBODY will have Services access).
  878. * You probably want to add yourself and a few other people at minimum.
  879. *
  880. * As with all permissions, make sure to only give trustworthy people access to Services.
  881. */
  882.  
  883. #oper
  884. {
  885. /* The nickname of this services oper */
  886. #name = "nick1"
  887.  
  888. /* The opertype this person will have */
  889. type = "Services Root"
  890.  
  891. /* If set, the user must be an oper on the IRCd to gain their Services
  892. * oper privileges.
  893. */
  894. require_oper = yes
  895.  
  896. /* An optional password. If defined the user must login using "/msg OperServ LOGIN" first */
  897. #password = "secret"
  898.  
  899. /* An optional SSL fingerprint. If defined, it's required to be able to use this opertype. */
  900. #certfp = "ed3383b3f7d74e89433ddaa4a6e5b2d7"
  901.  
  902. /* An optional list of user@host masks. If defined the user must be connected from one of them */
  903. #host = "*@*.anope.org ident@*"
  904.  
  905. /* An optional vHost to set on users who identify for this oper block.
  906. * This will override HostServ vHosts, and may not be available on all IRCds
  907. */
  908. #vhost = "oper.mynet"
  909. }
  910.  
  911. #oper
  912. {
  913. name = "nick2"
  914. type = "Services Administrator"
  915. }
  916.  
  917. #oper
  918. {
  919. name = "nick3"
  920. type = "Helper"
  921. }
  922.  
  923. /*
  924. * [OPTIONAL] Mail Config
  925. *
  926. * This section contains settings related to the use of e-mail from Services.
  927. * If the usemail directive is set to yes, unless specified otherwise, all other
  928. * directives are required.
  929. *
  930. * NOTE: Users can find the IP of the machine services is running on by examining
  931. * mail headers. If you do not want your IP known, you should set up a mail relay
  932. * to strip the relevant headers.
  933. */
  934. mail
  935. {
  936. /*
  937. * If set, this option enables the mail commands in Services. You may choose
  938. * to disable it if you have no Sendmail-compatible mailer installed. Whilst
  939. * this directive (and entire block) is optional, it is required if
  940. * nickserv:registration is set to yes.
  941. */
  942. usemail = yes
  943.  
  944. /*
  945. * This is the command-line that will be used to call the mailer to send an
  946. * e-mail. It must be called with all the parameters needed to make it
  947. * scan the mail input to find the mail recipient; consult your mailer
  948. * documentation.
  949. *
  950. * Postfix users must use the compatible sendmail utility provided with
  951. * it. This one usually needs no parameters on the command-line. Most
  952. * sendmail applications (or replacements of it) require the -t option
  953. * to be used.
  954. */
  955. sendmailpath = "/usr/sbin/sendmail -t"
  956.  
  957. /*
  958. * This is the e-mail address from which all the e-mails are to be sent from.
  959. * It should really exist.
  960. */
  961. sendfrom = "services@mynet.com"
  962.  
  963. /*
  964. * This controls the minimum amount of time a user must wait before sending
  965. * another e-mail after they have sent one. It also controls the minimum time
  966. * a user must wait before they can receive another e-mail.
  967. *
  968. * This feature prevents users from being mail bombed using Services and
  969. * it is highly recommended that it be used.
  970. *
  971. * This directive is optional, but highly recommended.
  972. */
  973. delay = 5m
  974.  
  975. /*
  976. * If set, Services will not attempt to put quotes around the TO: fields
  977. * in e-mails.
  978. *
  979. * This directive is optional, and as far as we know, it's only needed
  980. * if you are using ESMTP or QMail to send out e-mails.
  981. */
  982. #dontquoteaddresses = yes
  983.  
  984. /*
  985. * The subject and message of emails sent to users when they register accounts.
  986. */
  987. registration_subject = "Nickname registration for %n"
  988. registration_message = "Hi,
  989.  
  990. You have requested to register the nickname %n on %N.
  991. Please type \" /msg NickServ CONFIRM %c \" to complete registration.
  992.  
  993. If you don't know why this mail was sent to you, please ignore it silently.
  994.  
  995. %N administrators."
  996.  
  997. /*
  998. * The subject and message of emails sent to users when they request a new password.
  999. */
  1000. reset_subject = "Reset password request for %n"
  1001. reset_message = "Hi,
  1002.  
  1003. You have requested to have the password for %n reset.
  1004. To reset your password, type \" /msg NickServ CONFIRM %n %c \"
  1005.  
  1006. If you don't know why this mail was sent to you, please ignore it silently.
  1007.  
  1008. %N administrators."
  1009.  
  1010. /*
  1011. * The subject and message of emails sent to users when they request a new email address.
  1012. */
  1013. emailchange_subject = "Email confirmation"
  1014. emailchange_message = "Hi,
  1015.  
  1016. You have requested to change your email address from %e to %E.
  1017. Please type \" /msg NickServ CONFIRM %c \" to confirm this change.
  1018.  
  1019. If you don't know why this mail was sent to you, please ignore it silently.
  1020.  
  1021. %N administrators."
  1022.  
  1023. /*
  1024. * The subject and message of emails sent to users when they receive a new memo.
  1025. */
  1026. memo_subject = "New memo"
  1027. memo_message = "Hi %n,
  1028.  
  1029. You've just received a new memo from %s. This is memo number %d.
  1030.  
  1031. Memo text:
  1032.  
  1033. %t"
  1034. }
  1035.  
  1036. /*
  1037. * [REQUIRED] Database configuration.
  1038. *
  1039. * This section is used to configure databases used by Anope.
  1040. * You should at least load one database method, otherwise any data you
  1041. * have will not be stored!
  1042. */
  1043.  
  1044. /*
  1045. * [DEPRECATED] db_old
  1046. *
  1047. * This is the old binary database format from late Anope 1.7.x, Anope 1.8.x, and
  1048. * early Anope 1.9.x. This module only loads these databases, and will NOT save them.
  1049. * You should only use this to upgrade old databases to a newer database format by loading
  1050. * other database modules in addition to this one, which will be used when saving databases.
  1051. */
  1052. #module
  1053. {
  1054. name = "db_old"
  1055.  
  1056. /*
  1057. * This is the encryption type used by the databases. This must be set correctly or
  1058. * your passwords will not work. Valid options are: md5, oldmd5, sha1, and plain.
  1059. * You must also be sure to load the correct encryption module below in the Encryption
  1060. * Modules section so that your passwords work.
  1061. */
  1062. #hash = "md5"
  1063. }
  1064.  
  1065. /*
  1066. * [RECOMMENDED] db_flatfile
  1067. *
  1068. * This is the default flatfile database format.
  1069. */
  1070. module
  1071. {
  1072. name = "db_flatfile"
  1073.  
  1074. /*
  1075. * The database name db_flatfile should use
  1076. */
  1077. database = "anope.db"
  1078.  
  1079. /*
  1080. * Sets the number of days backups of databases are kept. If you don't give it,
  1081. * or if you set it to 0, Services won't backup the databases.
  1082. *
  1083. * NOTE: Services must run 24 hours a day for this feature to work.
  1084. *
  1085. * This directive is optional, but recommended.
  1086. */
  1087. keepbackups = 3
  1088.  
  1089. /*
  1090. * Allows Services to continue file write operations (i.e. database saving)
  1091. * even if the original file cannot be backed up. Enabling this option may
  1092. * allow Services to continue operation under conditions where it might
  1093. * otherwise fail, such as a nearly-full disk.
  1094. *
  1095. * NOTE: Enabling this option can cause irrecoverable data loss under some
  1096. * conditions, so make CERTAIN you know what you're doing when you enable it!
  1097. *
  1098. * This directive is optional, and you are discouraged against enabling it.
  1099. */
  1100. #nobackupokay = yes
  1101.  
  1102. /*
  1103. * If enabled, services will fork a child process to save databases.
  1104. *
  1105. * This is only useful with very large databases, with hundreds
  1106. * of thousands of objects, that have a noticeable delay from
  1107. * writing databases.
  1108. *
  1109. * If your database is large enough cause a noticeable delay when
  1110. * saving you should consider a more powerful alternative such
  1111. * as db_sql or db_redis, which incrementally update their
  1112. * databases asynchronously in real time.
  1113. */
  1114. fork = no
  1115. }
  1116.  
  1117. /*
  1118. * db_sql and db_sql_live
  1119. *
  1120. * db_sql module allows saving and loading databases using one of the SQL engines.
  1121. * This module loads the databases once on startup, then incrementally updates
  1122. * objects in the database as they are changed within Anope in real time. Changes
  1123. * to the SQL tables not done by Anope will have no effect and will be overwritten.
  1124. *
  1125. * db_sql_live module allows saving and loading databases using one of the SQL engines.
  1126. * This module reads and writes to SQL in real time. Changes to the SQL tables
  1127. * will be immediately reflected into Anope. This module should not be loaded
  1128. * in conjunction with db_sql.
  1129. *
  1130. */
  1131. #module
  1132. {
  1133. name = "db_sql"
  1134. #name = "db_sql_live"
  1135.  
  1136. /*
  1137. * The SQL service db_sql(_live) should use, these are configured in modules.conf.
  1138. * For MySQL, this should probably be mysql/main.
  1139. */
  1140. engine = "sqlite/main"
  1141.  
  1142. /*
  1143. * An optional prefix to prepended to the name of each created table.
  1144. * Do not use the same prefix for other programs.
  1145. */
  1146. #prefix = "anope_db_"
  1147.  
  1148. /* Whether or not to import data from another database module in to SQL on startup.
  1149. * If you enable this, be sure that the database services is configured to use is
  1150. * empty and that another database module to import from is loaded before db_sql.
  1151. * After you enable this and do a database import you should disable it for
  1152. * subsequent restarts.
  1153. *
  1154. * Note that you can not import databases using db_sql_live. If you want to import
  1155. * databases and use db_sql_live you should import them using db_sql, then shut down
  1156. * and start services with db_sql_live.
  1157. */
  1158. import = false
  1159. }
  1160.  
  1161. /*
  1162. * db_redis.
  1163. *
  1164. * This module allows using Redis (http://redis.io) as a database backend.
  1165. * This module requires that m_redis is loaded and configured properly.
  1166. *
  1167. * Redis 2.8 supports keyspace notifications which allows Redis to push notifications
  1168. * to Anope about outside modifications to the database. This module supports this and
  1169. * will internally reflect any changes made to the database immediately once notified.
  1170. * See docs/REDIS for more information regarding this.
  1171. */
  1172. #module
  1173. {
  1174. name = "db_redis"
  1175.  
  1176. /*
  1177. * Redis database to use. This must be configured with m_redis.
  1178. */
  1179. engine = "redis/main"
  1180. }
  1181.  
  1182. /*
  1183. * [RECOMMENDED] Encryption modules.
  1184. *
  1185. * The encryption modules are used when dealing with passwords. This determines how
  1186. * the passwords are stored in the databases, and does not add any security as
  1187. * far as transmitting passwords over the network goes.
  1188. *
  1189. * Without any encryption modules loaded users will not be able to authenticate unless
  1190. * there is another module loaded that provides authentication checking, such as
  1191. * m_ldap_authentication or m_sql_authentication.
  1192. *
  1193. * With enc_none, passwords will be stored in plain text, allowing for passwords
  1194. * to be recovered later but it isn't secure and therefore is not recommended.
  1195. *
  1196. * The other encryption modules use one-way encryption, so the passwords can not
  1197. * be recovered later if those are used.
  1198. *
  1199. * The first encryption module loaded is the primary encryption module. All new passwords are
  1200. * encrypted by this module. Old passwords stored in another encryption method are
  1201. * automatically re-encrypted by the primary encryption module on next identify.
  1202. *
  1203. * NOTE: enc_old is Anope's previous (broken) MD5 implementation which is present in
  1204. * versions prior to Anope 1.7.17. If your databases were made using that module,
  1205. * use this and not enc_md5.
  1206. *
  1207. * NOTE: enc_sha1 relies on how the OS stores 2+ byte data internally, and is
  1208. * potentially broken when moving between 2 different OSes, such as moving from
  1209. * Linux to Windows. It is recommended that you use enc_sha256 instead if you want
  1210. * to use an SHA-based encryption. If you choose to do so, it is also recommended
  1211. * that you first try to get everyone's passwords converted to enc_sha256 before
  1212. * switching OSes by placing enc_sha256 at the beginning of the list.
  1213. *
  1214. */
  1215.  
  1216. #module { name = "enc_bcrypt" }
  1217. module { name = "enc_sha256" }
  1218. #module { name = "enc_md5" }
  1219. #module { name = "enc_sha1" }
  1220.  
  1221. /*
  1222. * When using enc_none, passwords will be stored without encryption. This isn't secure
  1223. * therefore it is not recommended.
  1224. */
  1225. #module { name = "enc_none" }
  1226.  
  1227. /*
  1228. * enc_old is Anope's previous (broken) MD5 implementation used from 1.4.x to 1.7.16.
  1229. * If your databases were made using that module, load it here to allow conversion to the primary
  1230. * encryption method.
  1231. */
  1232. #module { name = "enc_old" }
  1233.  
  1234.  
  1235. /* Extra (optional) modules. */
  1236. include
  1237. {
  1238. type = "file"
  1239. name = "modules.conf"
  1240. }
  1241.  
  1242. /*
  1243. * Chanstats module.
  1244. * Requires a MySQL Database.
  1245. */
  1246. #include
  1247. {
  1248. type = "file"
  1249. name = "chanstats.example.conf"
  1250. }
  1251.  
  1252. /*
  1253. * IRC2SQL Gateway
  1254. * This module collects data about users, channels and servers. It doesn't build stats
  1255. * itself, however, it gives you the database, it's up to you how you use it.
  1256. *
  1257. * Requires a MySQL Database and MySQL version 5.5 or higher
  1258. */
  1259. #include
  1260. {
  1261. type = "file"
  1262. name = "irc2sql.example.conf"
  1263. }
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement