N service guide

Account & nickname management service

N is our account nickname services bot. It allows you to maintain your account and claim ownership of the nicknames you most commonly use.

Contents

  1. Usage
  2. Registering an account
  3. Deleting an account
  4. Authenticating
    1. AUTH
    2. AUTHCOOKIE
    3. ADDCERT
    4. DELCERT
    5. LISTCERT
    6. GHOST
    7. ADDMASK
    8. DELMASK
    9. LISTMASK
  5. Account password
  6. Changing your email address
  7. Nickname management
    1. REGNICK
    2. UNREGNICK
    3. NICKS
    4. NICKINFO
    5. RECLAIM
    6. RELEASE
  8. Account settings
    1. SET
    2. SET AUTOHIDE
    3. SET COLOR
    4. SET INFO
    5. SET MAXLOGINS
    6. SET NOOP
    7. SET PARANOID
    8. SET PRIVMSG
    9. SET RECLAIM
    10. SET TABLEWIDTH
    11. SET TRUSTED
  9. Ignore list management
    1. ADDIGNORE
    2. DELIGNORE
    3. LISTIGNORE
  10. Miscellaneous
    1. INFO
    2. USERINFO
    3. VACATION

Usage

You can communicate with N via private message, or through server-side aliases, as shown below:

  • /msg N <text>
  • /msg N@services.darenet.org <text>
  • /nickserv <text>
  • /ns <text>

For the purpose of this guide, we will be using the first method listed, as not all IRC clients readily support server-side aliases without additional setup and/or client commands; however, you can choose to use any of the above methods as they are all equivalent.

Registering an account

To create a DareNET account, vist the sign up page.

A verification link will be sent to the email address you provide, which you'll need to open/click to finish claiming your account. That's it!

Deleting an account

You can delete your account at anytime by visiting your account settings page.

Authenticating

AUTH

Syntax: /msg N AUTH [username|email] <password>

The AUTH command authenticates you with services, which is also commonly referred to as identifying or logging in.

If you are a using a nickname that is registered to your account, you only need to supply your password; otherwise, you must specify your username or email address.

AUTHCOOKIE

Syntax: /msg N AUTHCOOKIE <username>

The AUTHCOOKIE command is used to request a 'cookie', which is sent by email and can be used to authenticate.

This is often used when IRCing from a host that has not been added to your account's allowed host list.

ADDCERT

Syntax: /msg N ADDCERT [fingerprint]

The ADDCERT command is used to associate a client certificate fingerprint with your account.

If no fingerprint is given, your current client certificate fingerprint will be used.

Your client certificate fingerprints are used to automatically authenticate you to your account when connecting. For more information on this feature, check out the CertFP Authentication guide.

DELCERT

Syntax: /msg N DELCERT <fingerprint>

The DELCERT command is used to remove a client certificate fingerprint from your account.

LISTCERT

Syntax: /msg N LISTCERT

The LISTCERT command is used to list all client certificate fingerprints that are associated with your account.

GHOST

Syntax: /msg N GHOST <nick>

The GHOST command is used to disconnect an old client that's authenticated to your account.

ADDMASK

Syntax: /msg N ADDMASK [mask]

The ADDMASK command adds a user@host mask to your account's allowed hosts list.

When N's TRUSTED setting is enabled for you account, you can only authenticate when your user@host information matches a mask on your allowed hosts list.

If no mask is specified, your current user@host will be used.

DELMASK

Syntax: /msg N DELMASK <mask>

The DELMASK command removes a user@host mask from your account's allowed hosts list.

LISTMASK

Syntax: /msg N LISTMASK

The LISTMASK command lists all user@host masks on your account's allowed hosts list.

Account password

You can change your password by visiting your account settings page.

If you have forgotten your account password, you can reset it by visiting the forgot password page.

Changing your email address

You can change the email address associated with your account by visiting your account settings page.

Nickname management

REGNICK

Syntax: /msg N REGNICK

The REGNICK command registers  the nickname you're using to your account.

Tip: Nicknames that are not used for 60 days will automatically expire, allowing anyone to register them.

UNREGNICK

Syntax: /msg N UNREGNICK [nick]

The UNREGNICK command allows you to unregister a nickname that is registered to your account.

If no nickname is specified, your current nickname will be used.

Once a nickname has been unregistered, anyone is free to register to it.

NICKS

Syntax: /msg N NICKS

The NICKS command allows you to list all nicknames that are registered to your account.

NICKINFO

Syntax: /msg NICKINFO [nick]

The NICKINFO command displays registration information about the nickname specified.

Such information includes the date the nickname was registered, when it was last used and the account it belongs to.

If no nickname is specified, the nickname you're using will be used.

RECLAIM

Syntax: /msg N RECLAIM <nick>

The RECLAIM command allows you regain access to your nickname if another user is using it.

When you issue this command, the other user's nickname will be changed and N will temporarily hold your nickname to prevent them from reusing it (known as an "enforcer"). You will need to use N's RELEASE command if you'd like to use it yourself.

RELEASE

Syntax: /msg N RELEASE <nick>

The RELEASE command removes any enforcer for the nickname, allowing you to use it again.

Nickname enforces are created when someone other than you attempts to your nickname if N's RECLAIM setting is enabled for your account, or when you use the RECLAIM command, to prevent the use of it.

Account settings

SET

Syntax: /msg N SET [<option> [value]]

The SET command allows you to change your account settings.

If no value is given for an option, then the current value for it will be shown.

If no arguments are given, then the current values for all settings will be shown.

SET AUTOHIDE

Syntax: /msg N SET AUTOHIDE [ON|OFF]

The AUTOHIDE setting enables or disables automatic host hiding for your account.

If ON, any fakehost or title set for your account will be automatically applied when you authenticate.

Note: By default, all users automatically receive user mode +x (host hiding) when connecting to the network; however, if AUTOHIDE is set to OFF for your account, and you use the SASL or Login-on-Connect methods to authenticate, you will not receive user mode +x while connecting to the network and  your host will not be automatically hidden.

SET COLOR

Syntax:  /msg N SET COLOR [ON|OFF]

The COLOR setting determines how service bots, such as N, format messages sent to you.

If ON, service bots may user ctrl-codes (i.e., bold, color and under-line text) when sending you messages.

SET INFO

Syntax: /msg N SET INFO [text|*]

The INFO setting sets an informational line (also known as an infoline) for your account.

Infolines are shown when other users use the INFO command  for your account.

To remove an infoline, specify * as the text.

SET MAXLOGINS

Syntax: /msg N SET MAXLOGINS [value]

The MAXLOGINS setting defines the maximum number of clients that can be authenticated to your account at the same time.

You may specify a value between 0 and 5. A value of 0 will use the default setting.

SET NOOP

Syntax: /msg N SET NOOP [ON|OFF]

The NOOP setting determines whether you can be added to channel access lists.

When ON, users will not be able to add you to a channel's access list.

SET PARANOID

Syntax: /msg N SET PARANOID [ON|OFF]

The PARANOID setting determines whether N should send you some additional information when you authenticate.

When ON, N will show you some information about the last successful login for your account, and the number of failed attempts.

SET PRIVMSG

Syntax: /msg SET PRIVMSG [ON|OFF]

The PRIVMSG setting determines whether service bots should send their replies as a private message or notice.

By default, service bots reply using notices.

SET RECLAIM

Syntax: /msg N SET RECLAIM [ON|OFF]

The RECLAIM command enables or disables nickname enforcement for nicknames registered to your account.

When ON, N will prevent other users from using any nicknames registered to your account.

SET TABLEWIDTH

Syntax: /msg N SET TABLEWIDTH [value]

The TABLEWIDTH settings sets the width services bots should wrap table-formatted text when sending you replies.

The value may be a number between 0 and 16959. A value of 0 will use the default setting.

SET TRUSTED

Syntax: /msg N SET TRUSTED [ON|OFF]

The TRUSTED setting enables or disables use of your account's allowed host list.

When ON, you will only be allowed to authenticate to your account if your hostmask matches an entry on your allowed hosts list. In the case it doesn't match, you may have to use N's AUTHCOOKIE command to authenticate instead.

Ignore list management

ADDIGNORE

Syntax: /msg N ADDIGNORE <mask>

The ADDIGNORE adds the specified mask to your ignore list.

N automatically adds these masks to your SILENCE list on IRC.

DELIGNORE

Syntax: /msg N DELIGNORE <mask>

The DELIGNORE commands removes the specified mask from your ignore list.

N will also remove this mask from your SILENCE list on IRC.

LISTIGNORE

Syntax: /msg N LISTIGNORE

The LISTIGNORE command lists all masks on your ignore list.

Miscellaneous

INFO

Syntax: /msg N INFO [nick|*account]

The INFO command displays various information about the account specified.

If no account is specified, information about your account will be shown.

USERINFO

Syntax: /msg N USERINFO <nick>

The USERINFO command will show which account a user is authenticated to.

VACATION

Syntax: /msg N VACATION

The VACATION command  allows you indicate that you will be away from IRC for a extended period of time (e.g., going on vacation). This will prevent your nickname(s) from being expired due to inactivity.

You account will stay marked until the time you authenticate.

Should you still need assistance, stop by #Help on IRC.