Difference between revisions of "Nick Registration"

From freenode wiki
Jump to: navigation, search
m (Protected "Nick Registration" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
NickServ allows you to register a nickname and prevent others from using it. The following commands allow for registration and maintenance of nicknames; to use them, type /msg NickServ command. For more information on a specific command, type
[[NickServ]] allows you to register a nickname and prevent others from using it. The following commands allow for registration and maintenance of nicknames; to use them, type /msg NickServ command. For more information on a specific command, type /msg NickServ HELP command. <br/>
 
== ACCESS ==
 
Modifies or displays the access list for your nick.  This is the list of addresses which will be automatically recognized by NickServ as allowed to use the nick.  If you want to use the nick from a different address, you need to send an IDENTIFY command to make NickServ recognize you. Services Operators may provide a nick to modify other users' access lists.
 
Syntax:
ACCESS ADD [nickname] mask
ACCESS DEL [nickname] mask
ACCESS LIST [nickname]
 
 
Examples:
 
ACCESS ADD anyone@*.bepeg.com
Allows access to the user, anyone, from any machine in the bepeg.com domain.
 
ACCESS DEL anyone@*.bepeg.com
Reverses the previous command.
 
ACCESS LIST
Displays the current access list.
 
 
== AJOIN ==
Syntax:
AJOIN ADD [nickname] channel [key]
AJOIN DEL [nickname] channel
AJOIN LIST [nickname]
This command manages your auto-join list. When you identify you will automatically join the channels on your auto-join list.
'''Services Operators may provide a nick to modify other users' auto-join lists.'''
 
     
== ALIST ==
Syntax:
ALIST [nickname]
 
Lists all channels you have access to.
 
Channels that have the NOEXPIRE option set will be prefixed with an exclamation mark. The nickname parameter is limited to Services Operators
 
 
== CERT ==
Syntax:
CERT ADD [nickname] [fingerprint]
CERT DEL [nickname] [fingerprint]
CERT LIST [nickname]
 
Modifies or displays the certificate list for your nick.
If you connect to IRC and provide a client certificate with a matching fingerprint in the cert list, you will be automatically identified to services. Services Operators may provide a nick to modify other users' certificate lists.
 
 
Examples:
 
CERT ADD
Adds your current fingerprint to the certificate list and automatically identify you when you connect to IRC using this fingerprint.
 
CERT DEL <fingerprint>
Removes the fingerprint <fingerprint> from your certificate list.
       
CERT LIST
Displays the current certificate list.
 
 
== CONFIRM ==
Syntax:
CONFIRM passcode
 
This command is used by several commands as a way to confirm changes made to your account.
 
This is most commonly used to confirm your email address once you register or change it.
 
This is also used after the RESETPASS command has been used to force identify you to your nick so you may change your password.
Additionally, Services Operators with the nickserv/confirm permission can replace passcode with a users nick to force validate them.
 
 
== DROP ==
Syntax:
DROP nickname
 
Drops the given nick from the database. Once your nickname is dropped you may lose all of your access and channels that you may own. Any other user will be able to gain control of
this nick.
'''As a Services Operator, you may drop any nick.'''
 
 
== GLIST ==
Syntax:
GLIST [nickname]
 
Without a parameter, lists all nicknames that are in your group.
 
With a parameter, lists all nicknames that are in the group of the given nick. Specifying a nick is limited to Services Operators.
 
 
== GROUP ==
Syntax:
GROUP [target] [password]
 
This command makes your nickname join the target nickname's group. The password is the password of the target nickname.
 
Joining a group will allow you to share your configuration, memos, and channel privileges with all the nicknames in the group, and much more!
 
A group exists as long as it is useful. This means that even if a nick of the group is dropped, you won't lose the shared things described above, as long as there is at least one nick remaining in the group.
 
You may be able to use this command even if you have not registered your nick yet. If your nick is already registered, you'll need to identify yourself before using this command.
 
It is recommended to use this command with a non-registered nick because it will be registered automatically when using this command. You may use it with a registered nick (to change your group) only if your network administrators allowed it.
 
You can only be in one group at a time. Group merging is not possible.
 
'''Note: all the nicknames of a group have the same password.'''
 
 
== IDENTIFY ==
Syntax:
IDENTIFY [account] password
 
Tells NickServ that you are really the owner of this nick.  Many commands require you to authenticate yourself with this command before you use them.  The password should be the same one you sent with the REGISTER command.
 
 
== INFO ==
Syntax:
INFO [nickname]
 
Displays information about the given nickname, such as the nick's owner, last seen address and time, and nick options. If no nick is given, and you are identified, your account name is used, else your current nickname is used.
 
 
== LIST ==
Syntax:
LIST pattern [SUSPENDED] [NOEXPIRE] [UNCONFIRMED]
 
Lists all registered nicknames which match the given pattern, in nick!user@host format.  Nicks with the PRIVATE option set will only be displayed to Services Operators with the proper access.  Nicks with the NOEXPIRE option set will have a ! prefixed to the nickname for Services Operators to see.
 
'''Note that a preceding '#' specifies a range.'''
 
If the SUSPENDED, UNCONFIRMED, or NOEXPIRE options are given, only nicks which, respectively, are SUSPENDED, UNCONFIRMED, or have the NOEXPIRE flag set will be displayed. If multiple options are
given, all nicks matching at least one option will be displayed. Note that these options are limited to Services Operators.
 
 
Examples:
 
LIST *!joeuser@foo.com
Lists all registered nicks owned by joeuser@foo.com.
 
LIST *Bot*!*@*
Lists all registered nicks with Bot in their names (case insensitive).
 
LIST * NOEXPIRE
Lists all registered nicks that have been set to not expire.
 
LIST #51-100
Lists all registered nicks within the given range (51-100).
 
Regex matches are also supported using the regex/pcre engine. Enclose your pattern in // if this is desired.
 
 
== LOGOUT ==
Syntax:
LOGOUT [nickname] [REVALIDATE]
 
Without a parameter, reverses the effect of the IDENTIFY command, i.e. makes you not recognized as the real owner of the nick anymore. Note, however, that you won't be asked to reidentify yourself.
 
With a parameter, does the same for the given nick. If you specify REVALIDATE as well, Services will ask the given nick to re-identify. This is limited to Services Operators.
 
 
== RECOVER ==
Syntax:
RECOVER nickname [password]
 
Recovers your nick from another user or from services. If services are currently holding your nick, the hold will be released. If another user is holding your nick and is identified they will be killed (similar to the old GHOST command). If they are not identified they will be forced off of the nick.
 


== REGISTER ==
== REGISTER ==
Syntax:
Syntax:<br/>
  REGISTER password email
  REGISTER password email<br/>
 
Registers your nickname in the NickServ database. Once your nick is registered, you can use the SET and ACCESS commands to configure your nick's settings as you like them. Make sure you remember the password you use when registering - you'll need it to make changes to your nick later. (Note that case matters! ANOPE, Anope, and anope are all different passwords!)
 
Guidelines on choosing passwords:
 
Passwords should not be easily guessable. For example, using your real name as a password is a bad idea. Using your nickname as a password is a much worse idea ;) and, in fact, NickServ will not allow it. Also, short passwords are vulnerable to trial-and-error searches, so you should choose a password at least 5 characters long. Finally, the space character cannot be used in passwords.
 
This command also creates a new group for your nickname, that will allow you to register other nicks later sharing the same configuration, the same set of memos and the same channel privileges.
 
 
== RESEND ==
Syntax:
RESEND
 
This command will resend you the registration confirmation email.
 
 
== RESETPASS ==
Syntax:
RESETPASS nickname email
 
Sends a passcode to the nickname with instructions on how to reset their password.  Email must be the email address associated to the nickname.
 
== SET ==
Syntax:
SET option parameters
 
Sets various nickname options. option can be one of:
* SET AUTOOP    Sets whether services should set channel status modes on you automatically.
* SET DISPLAY    Set the display of your group in Services
* SET EMAIL      Associate an E-mail address with your nickname
* SET GREET      Associate a greet message with your nickname
* SET HIDE      Hide certain pieces of nickname information
* SET KEEPMODES  Enable or disable keep modes
* SET KILL      Turn protection on or off
* SET LANGUAGE  Set the language Services will use when messaging you
* SET PASSWORD  Set your nickname password
* SET PRIVATE    Prevent the nickname from appearing in the LIST command
* SET SECURE    Turn nickname security on or off
* SET URL        Associate a URL with your account
Type /msg NickServ HELP SET option for more information on a specific option.


Registers your nickname in the NickServ database. Once your nick is registered, you can use the SET and ACCESS commands to configure your nick's settings as you like them. Make sure you remember the password you use when registering - you'll need it to make changes to your nick later. (Note that case matters! ANOPE, Anope, and anope are all different passwords!)<br/>
==='''Guidelines on choosing passwords:'''===


== STATUS ==
Passwords should not be easily guessable. For example, using your real name as a password is a bad idea. Using your nickname as a password is a much worse idea ;) and, in fact, NickServ will not allow it. Also, short passwords are vulnerable to trial-and-error searches, so you should choose a password at least 5 characters long. Finally, the space character cannot be used in passwords.<br/>
Syntax:
STATUS [nickname]


Returns whether the user using the given nickname is recognized as the owner of the nickname. The response has this format:
==='''Group Nicks'''===


nickname status-code account
This command also creates a new group for your nickname, that will allow you to register other nicks later sharing the same configuration, the same set of memos, and the same channel privileges.<br/>


where nickname is the nickname sent with the command, status-code is one of the following, and account is the account they are logged in as.
Syntax:<br/>
GROUP [target] [password]<br/>


* 0 - no such user online or nickname not registered
This command makes your nickname join the target nickname's group. The password is the password of the target nickname.<br/>
* 1 - user not recognized as nickname's owner
* 2 - user recognized as owner via access list only
* 3 - user recognized as owner via password identification


If no nickname is given, your status will be returned.
Joining a group will allow you to share your configuration, memos, and channel privileges with all the nicknames in the group, and much more!<br/>


== UNGROUP ==
A group exists as long as it is useful. This means that even if a nick of the group is dropped, you won't lose the shared things described above, as long as there is at least one nick remaining in the group.<br/>
Syntax:
UNGROUP [nick]


You may be able to use this command even if you have not registered your nick yet. If your nick is already registered, you'll need to identify yourself before using this command.<br/>


This command ungroups your nick, or if given, the specificed nick, from the group it is in. The ungrouped nick keeps its registration time, password, email, greet, language, and url. Everything else is reset. You may not ungroup yourself if there is only one nick in your group.
It is recommended to use this command with a non-registered nick because it will be registered automatically when using this command. You may use it with a registered nick (to change your group) only if your network administrators allowed it.<br/>


== UPDATE ==
You can only be in one group at a time. Group merging is not possible.<br/>
Syntax:
UPDATE


Updates your current status, i.e. it checks for new memos, sets needed channel modes and updates your vhost and your userflags (lastseentime, etc).
'''Note: all the nicknames of a group have the same password.'''<br/>

Latest revision as of 00:55, 29 April 2022

NickServ allows you to register a nickname and prevent others from using it. The following commands allow for registration and maintenance of nicknames; to use them, type /msg NickServ command. For more information on a specific command, type /msg NickServ HELP command.

REGISTER

Syntax:

REGISTER password email

Registers your nickname in the NickServ database. Once your nick is registered, you can use the SET and ACCESS commands to configure your nick's settings as you like them. Make sure you remember the password you use when registering - you'll need it to make changes to your nick later. (Note that case matters! ANOPE, Anope, and anope are all different passwords!)

Guidelines on choosing passwords:

Passwords should not be easily guessable. For example, using your real name as a password is a bad idea. Using your nickname as a password is a much worse idea ;) and, in fact, NickServ will not allow it. Also, short passwords are vulnerable to trial-and-error searches, so you should choose a password at least 5 characters long. Finally, the space character cannot be used in passwords.

Group Nicks

This command also creates a new group for your nickname, that will allow you to register other nicks later sharing the same configuration, the same set of memos, and the same channel privileges.

Syntax:

GROUP [target] [password]

This command makes your nickname join the target nickname's group. The password is the password of the target nickname.

Joining a group will allow you to share your configuration, memos, and channel privileges with all the nicknames in the group, and much more!

A group exists as long as it is useful. This means that even if a nick of the group is dropped, you won't lose the shared things described above, as long as there is at least one nick remaining in the group.

You may be able to use this command even if you have not registered your nick yet. If your nick is already registered, you'll need to identify yourself before using this command.

It is recommended to use this command with a non-registered nick because it will be registered automatically when using this command. You may use it with a registered nick (to change your group) only if your network administrators allowed it.

You can only be in one group at a time. Group merging is not possible.

Note: all the nicknames of a group have the same password.