Nickserv
Contents |
Nickserv Frequently asked questions may answer your question
Nickserv is one of the parts that come with the anope services packages. Nickserv is soley for dealing with nicknames and related commands. The version of Nickserv SwiftIRC is using has been vastly changed from the basic commands that came from anope to help with nickname security.
/ns help is the command that will list all of the available options and setting for nickserv.
Please note nicknames that are not used will be automatically deleted after 60 days.
Help Video (how to register a nickname)
Help Video: Registering a nickname
Register - Resend - Confirm - Cancel
Register is one of the most important commands for nickserv. It registers your nickname with nickserv so that you can be given access in channels and to secure the nickname for your own use.
/ns register password password email@address email@address
You have to type your chosen password twice and your email address twice to ensure you have not made any typing errors,
/ns register SwiftPassword123 SwiftPassword123 SwiftEmail@SwiftIRC.net SwiftEmail@SwiftIRC.net [19:28:21] -NickServ- A passcode has been sent to SwiftEmail@SwiftIRC.net, please type /msg NickServ confirm <passcode> to complete registration
If your email address turned out to be wrong or inaccessible after all, you can choose to cancel the registration and re-register it. Make sure you're on the nickname you tried to register when typing this command.
/ns cancel password
If after waiting for a few minutes you do not receive your email with the confirm code in you can type the below command to resend the email.
/ns resend
When you have received your email with the code in you can confirm your nickname registration
/ns confirm code
/ns confirm QHMO0c5WI [19:36:02] -NickServ- Nickname SwiftUser registered under your account: *User@*.swiftexample.com
After completing these commands your nickname is registered.
Group - Glist
This command groups your nicknames together so that they share the same access and passwords. You may have upto 5 nicknames in each group, The best way to group a nickname is to change to the new nickname first (ideally one that is not registered) then type the command to group it to your registered nickname with the command below.
/ns group mainnick mainpassword
The reason for using a non registered nickname to group is because the nickname that is joining the group would loose all of its access if it was a registered nickname and gain the access from the main group,
Always check before you group a nickname to make sure you do not lose the access you want to keep!
The second command is used to list your grouped nicknames.
/ns glist
Identify
This command is used to identify yourself as the owner of your nickname, to enable you to receive the access and privileges that the nickname has. It will also enable you to join channels that have set the channel mode +R (see channel modes).
/ns id password
Access
This command is used to set access for you nickname, If you want to use the /ns set kill immed, you need to add your host to the access list to identify yourself with nickserv,
If you connect from more than one host address you will need to add each different host to the access list.
/ns access add host@name
You can use * as a wildcard in your command,
/ns access add *@*swiftexample.com
In the above example the full host address is @Swift-D1FF2A60.swiftexample.com and I have replaced anything that is likely to change with the wildcard * this will mean that anyone using swiftexample.com could use my nickname, for that reason I recommend also using the ident which is the part of your host before the @ sign.
User@Swift-D1FF2A60.swiftexample.com
so the entry I would add to the access list would be
/ns access add User@*swiftexample.com
There are 2 other commands within this group to help you manage your nickserv access list, these are as follows.
/ns access list
Which lists all of the hosts added to your access list.
/ns access del entry
which will remove an entry from your access list.
Set
There are many options you can set for nickserv with the set command, below is listed the syntax of the command followed by a short explanation of each command.
/ns set option parameter
Display
This command enables you to change the display nickname of your group (main nickname).
/ns set display nickname
Password
This command allows you to change your nickname's password.
/ns set password oldpassword newpassword newpassword
/ns set password SwiftPassword123 SwiftPassword111 SwiftPassword111
The above example would change my current password (SwiftPassword123) to the new password (SwiftPassword111). You have to repeat the new password to ensure you have not made any spelling mistakes.
If you do not remember your old password you will need to use the /ns resetpass command also listed on this page.
Language
This option changes which language nickserv replies to you in the options are listed below
/ns set language number 1) English 2) Français (French) 3) Deutsch (German) 4) Italiano (Italian) 5) Português (Portuguese) 6) Español (Spanish) 7) Türkçe (Turkish) 8) Catala (Catalan) 9) ÅëëçíéêÜ (Greek) 10) Nederlands (Dutch) 11) Ðóññêèé (Russian) 12) Magyar (Hungarian) 13) Polski (Polish)
/ns set language 1 This would set my default language to english
Url
This command allows you to set a URL link to be associated to your nickname
/ns set URL website
/ns set URL http://swiftirc.net/
This command is used to change the email address associated to the nickname. It is important to keep this updated incase you forget you nickserv password and need to reset it.
/ns set email password newemail@address newemail@address
/ns set email SwiftPassword123 SwiftEmail@SwiftIRC.net SwiftEmail@SwiftIRC.net
You need to type your new email address twice to ensure you have not made any typing errors.
Icq
This command allows you to associate an ICQ number with your nickname.
/ns set ICQ number
Greet
This command allows you to set a personal greet for your nickname you may add coloured text to the greet aswell (see colours for help with the colour code commands)
/ns set greet text-here
/ns set greet I'm a user of SwiftIRC
You can also delete your current greet with.
/ns set greet
Kill
The kill command will help secure your nickname by setting various options to change your nickname to unknown if you do not identify with nickserv in the correct way and times set by this option.
/ns set kill option
The options are as follows
on = you have 60 seconds to identify your nickname or nickserv changes your nickname to unknown.
quick = you have 20 seconds to identify your nickname before nickserv changes it to unknown.
immed = with this option you MUST have an access for your host with the /ns access command, nickserv will change your nickname to unknown immediately without being warned first or given a chance to change nicknames.
off = you will no longer change anyone using your nickname to unknown.
Secure
This option turns nickserv's secure setting on or off for your nickname. If secure is turned on you must enter your password even if your host address is on the access list before you are identified. However if your host address is on the access list nickserv will not change your nickname to unknown.
/ns set secure option
/ns set secure on /ns set secure off
Private
This setting allows you to prevent your nickname from showing up on the nickserv list, from using this command /ns list
/ns set private on /ns set private off
Hide
This command allows you to set which information people can see when they use the /ns info yournick command.
/ns set hide option parameter
the options are as follows
- status
- usermask
- quit
All of the above options use a simple on or off parameter.
/ns set hide email on /ns set hide email off
Msg
This option may not be enabled on our services.
Autoop
This last option is to change setting that makes nickserv automatically give you your access in a channel if you are on the channels access list,
/ns set autoop parameter
The only parameters are on or off.
/ns set autoop on /ns set autoop off
Drop
This command is to drop or remove a nickname from the nickserv database. It will remove the registration of it and the nickname will lose all access and channels it had access on. To drop a nickname the easiest is to be on the nickname and identified (see identify on this page) or on another nickname within the same group (see group for more help with grouping nicknames).
By dropping a nickname you are making it free for anyone else to register it.
/ns drop nickname
Recover - Release
Help Video: [Release and recover a nickname]
These 2 commands work together, If you have not set kill on your nickname or turned kill off and someone else is using your registered nickname you can recover it with the following commands.
/ns recover nickname password
After typing that command, nickserv will change the user's nickname to unknown and will not let anyone use the nickname until you have typed the next command.
/ns release nickname password
After using BOTH commands you will be able to change to your registered nickname and identify in the normal way.
Ghost
This command is used if you have pinged out or disconnected from the server but your identified nickname is still on the network. Nickserv will kill your ghost so that you are able to use your registered nickname again.
/ns ghost nickname password
Please note you can only ghost an identified nickname.
Alist
This command is very useful it allows you to see what access you have and what channels, There are mainly 2 commands used here and i will explain the differences between them.
The first command and most commonly used,
/ns alist
This command will list all channels with access levels from 1-9999,
Info
This command is used to see information about a nickname,
/ns info nickname
The response you get will either tell you the nickname is not registered or will give you some information about the nicknames shown in the below examples
/ns info SwiftUser [11:15:50] -NickServ- Nick SwiftUser isn't registered.
In the above example the nickname mytest is not a registered nickname,
/ns info SwiftUser [11:17:52] -NickServ- SwiftUser is User of SwiftIRC [11:17:52] -NickServ- Time registered: Apr 11 19:20:47 2008 UTC [11:17:53] -NickServ- Last seen time: Feb 11 03:09:07 2009 UTC [11:17:53] -NickServ- Last quit message: Connection reset by peer
In the above example you can see when the nickname was registered and when the nickname was last used on SwiftIRC network, and the last quit message.
/ns info SwiftUser [11:18:44] -NickServ- SwiftUser is User of SwiftIRC [11:18:44] -NickServ- SwiftUser is currently online. [11:18:44] -NickServ- Time registered: Jul 31 15:25:56 2008 UTC [11:18:44] -NickServ- Last quit message: Ping timeout
In this example you can see the user is online and has identifed their nickname, It still shows when the nickname was registered and the last quit message.
There is one extra command that you can use for your own nickname only. This command is used to check more of your own personal nickserv settings.
/ns info nickname all
/ns info SwiftUser all [11:24:20] -NickServ- SwiftUser is User from SwiftIRC [11:24:20] -NickServ- Is online from: User@Swift-D1FF2A60.swiftexample.com [11:24:20] -NickServ- Time registered: Oct 15 13:04:30 2006 UTC [11:24:20] -NickServ- Last quit message: Ping timeout [11:24:20] -NickServ- E-mail address: SwiftEmail@SwiftIRC.net [11:24:20] -NickServ- Greet message: I'm a user of SwiftIRC [11:24:20] -NickServ- Options: Protection, Security, Private
As you can see in the above example, it shows you far more information about the settings that you personally have made using various other nickserv commands listed on this page.
Logout
This command is used to logout your identified nickname. It just reverses the /ns identify command.
/ns logout
Status
This command informs you of the status of a given nickname. There are 4 possible replies each listed below with an explanation,
/ns status nickname
/ns status hidden [12:56:30] -NickServ- STATUS SwiftUser 3
the number at the end refers to the status of the nickname and is explained below
0 - no such user online or the nickname is not registered
1 - user not recognized as nickname's owner ( not identifed )
2 - user recognized as owner via access list only (has set /ns access )
3 - user recognized as owner via password identification
Update
This command is used to update the status of a registered and identified nickname. It updates your channel access, checks for new messages from memoserv and activates your vhost if you are lucky enough to have one.
/ns update
Resetpass - Confirmreset - Resendreset
These 2 commands are used to identify your nickname when you have forgotten your password. They allow you to reset your password. After resetting your password you can change it to a more personal password with /ns set command (see /ns set on this page).
/ns resetpass nickname email@address
If you have no received the email or the passcode doesn't work properly, you may use the resendreset code to resend the passcode for the password reset.
/ns resendreset nickname
You will be sent an email with a confirm code to enter. This code must be entered to confirm that you want to reset your password.
/ns confirmreset code
After completing the above 2 commands correctly you will be sent a new password to identify your nickname with. After you have identified with your new password you may change your password as explained in /ns set.
