Nickserv

From SwiftIRC Wiki
(Redirected from NickServ)
Jump to: navigation, search

Contents

Nickserv Frequently asked questions may answer your question

Nickserv is one of the parts that come with the Anope services packages. Nickserv is solely 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/

Email

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

  • email
  • 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.