Anonymous: add another example & add notice about...

...this plugin not meant for identifying even if it's possible and tell
how the identifying should happen.
This commit is contained in:
Mikaela Suomalainen 2014-06-08 13:37:59 +03:00
parent 56f8d54583
commit f44cc389a9

View File

@ -1,4 +1,59 @@
Anonymous allows you to send messages anonymously as the bot. If
supybot.plugins.Anonymous.allowPrivateTarget is True, you can send messages in query too.
`supybot.plugins.Anonymous.allowPrivateTarget` is `True`, you can send
messages in query too.
One usage example is to identify the bot with NickServ if it fails to identify for some reason.
## Usage examples
### Identifying to NickServ
One usage example is to identify the bot with NickServ if it fails to
identify for some reason.
However this isn't recommended unless you don't use CertFP.
#### SASL
```
@config networks.<network>.sasl.username NSACCOUNTNAME
@config networks.<network>.sasl.password NSPASSWORD
```
Next time when your bot connects it should identify before connecting with
SASL.
#### CertFP
For help with generating the certificate [please see this page.](https://mkaysi.github.io/pages/external/identifying.html#certfp)
When you have generated the certificate tell the bot to use it by either
of thse two commands (or both). The first tells the bot to use the
certificate everywhere and the second only on one network. If you run
the first, the second isn't necressary unless you have multiple
certificates.
```
@config protocols.irc.certfile /home/username/bot/bot.pem
@config networks.<network>.certfile /home/username/bot/bot.pem
```
### Proving that you are the owner.
When you ask for cloak/vhost for your bot, the network operators will
often ask you to prove that you own the bot. You can do this for example
with the following method:
```
@load Anonymous
@config plugins.anonymous.requirecapability owner
@config plugins.anonymous.allowprivatetarget True
@anonymous say <operator nick> Hi, my owner is <your nick> :)
```
This
* Loads the plugin.
* Makes the plugin require that you are the owner
* If anyone could send private messages as the bot, they could also
access network services.
* Allows sending private messages
* Sends message `Hi, my owner is <your nick> :)` to `operator nick`.
* Note that you won't see the messages that are sent to the bot.