From ClueWiki

ClueNet accounts have different strata of privileges. First you need to get a basic account which doesn't have any privileges at all, then you need to fulfill certain requirements which will give you certain privileges, like shell access on some servers.

Let's start with getting a basic account.

Contents 1 Getting a Basic account 1.1 Web Interface 1.2 Shell Interface 2 Getting Shell access 3 Old Stuff 3.1 Overview of Getting a Shell Account 3.2 Creating the Basic Account 3.3 Upgrading your Account to have SSH Access

Getting a Basic account

Before you sign up, you need this:

• A vouch code from an existing user with the ability to vouch.
• A registered nick on the ClueIRC network.
• 150 CluePoints.

To get a vouch code, simply go to our IRC channel (#clueirc) and ask for one. Please note that you won't get one right away, you need to be there and prove that you are going to continue to be active.

You also need a registered nick. To do this, simply register with PHPserv. If you don't know how to do this, type /msg PHPserv help in your IRC client. PHPserv will message you back with general help. For more information on ClueIRC Services, read the IRC Services page.

The last thing you need is 150 "CluePoints". CluePoints are given by DaVinci, see that page and the page on Clueful Chatting to get more info on how to get those points. However, the basics are: Speak normal English (no 1337 or h4xx0r sp34k), start all sentences with a capital (upper-case) letter, capitalize the personal pronoun ("I" instead of "i"), and end your sentences with a full stop. Even if you don't speak very good English, those rules should be quite easy to follow.

Because the ClueNet account system is now built upon remctl API calls and LDAP, you could do everything without ssh or a web browser, but we aren't going to go through that here. Go to the ClueAPI page for more info on that.

In this guide we'll go through two types of sign-up interfaces; one web interface and one shell interface. Choose the one you feel most comfortable with.

Web Interface

The web interface is currently down. This section will be updated when the web interface gets back up.

Shell Interface

To access the shell interface, just type ssh acctshell@rhombus.cluenet.org Rhombus does not exist any longer, please ask on IRC for more help. in your favorite terminal. When you are asked to enter a password, enter 'acctshell' (without the single quotes). Since you don't have an account yet, enter "new" when prompted for an username. You are then given the list of things you need before signing up, which should be the same as the one above (don't worry about it saying you need a verified email address, as it will be verified during the sign-up process), just press enter to continue.

You are then asked to enter your email address and if you have gotten a verification code. If you haven't, one will be sent to you and should arrive within 10-15 minutes or so (remember to check your spam folder). You should then enter the verification code you got.

The program will now check if you have fulfilled all the requirements. You will be notified which you haven't fulfilled (if any), just make sure you fulfill them and try again.

The next thing you will be asked for is your username. This should be in all lower-case letters and numbers (the first one should be a letter) and should not contain any "illegal words". Just enter an username, if it isn't allowed it will just ask you to enter a new one.

The program should now have enough info to create your account, just press enter and you will get an email with your password.

When you get the email, just go to the acctshell again (ssh acctshell@rhombus.cluenet.org, password 'acctshell') and enter your username and password instead of "new".

Now you should change your password. Enter "passwd" in the acctshell to start the password changer command. This will ask you for your old password (the one you got in the mail), and your new password (which you need to enter twice to avoid typos) (note that none of the passwords will show up, so if nothing seems to happen when entering your password, this is completely normal).

That's it. You now have a ClueNet basic account. You might think "what can I do with a basic account?". The answer is... Well, not too much. You can login to the wiki, and some other services. Just look around in the wiki to figure what you can do.

Getting Shell access

As said earlier, to get shell access you need to fulfill certain requirements. These change from server to server, but they mostly stay the same.

To apply for shell access, let's first see what requirements you need.

Start by logging into the acctshell (ssh acctshell@rhombus.cluenet.org, password 'acctshell'), which is the only version being able to do this at the moment.

To see all the privileges possible to get, enter listallprivileges (or lap). This should print a long list. The ones ending in :shellaccess are probably the ones you are the most interested in at the moment. The first part is the name of the server this privilege applies to (the _misc privileges doesn't apply to any server in particular).

As an example, let's say you want to apply for shellaccess on the server "sine". To see what the requirements for that privilege is, enter listrequirements sine:shellaccess (or lr sine:shellaccess). This should print out a list of requirements and the score you need on them. The list may seem cryptic at first, but don't worry, it's actually quite easy. At the time this guide was written, the command outputted this:

acctshell> listrequirements sine:shellaccess
Privilege to list services for: sine:shellaccess
A score of at least 75 on basicshellquestions.
A score of at least 75 on basicmiscquestions.
A score of at least 75 on  aboutmeessay.
A score of at least 75 on shellusageessay.
A score of at least 50 on communitycontributeessay.
A score of at least 40 on blankspaceessay.
A score of at least 100 on tosquestions.
A score of at least 300 on cluepoints.

The requirements have some naming conventions:

• Requirements ending in "questions" are multiple questions, some are multiple-choice questions, some you need to answer with one sentence or so.
• Requirements ending in "essay" are essays, ie. you need to write a couple of paragraphs (how long you should write depends on the requirement).
• The other ones should be fairly self-explanatory.

If you want a description on the requirements, type listallrequirements (or lar).

You'll notice that most of those requirements exist on most of the shellaccess privileges, although the score they require may change.

So, let's start getting shell access on sine (if you want to get access on another server, just enter some other requirements instead).

The first requirement on the list is "basicshellquestions". To respond to it, enter respond basicshellquestions (or r basicshellquestions). Just keep on pressing enter and read the instructions. When you get to a question, like "1. Which Cluenet servers do you plan on primarily using?", enter your response, followed by enter. Just keep on doing this until you have answered all the questions. If this is a multiple-question quiz, the program will ask you if you want to get your answers scored right away (which you probably want to do). If you answer yes, the answers will be scored and you'll get to know your score there and then. If the requirement isn't one that can be scored by a computer, other members need to vote on your response. Not everyone can do this, but if you ask kindly on ClueIRC, someone will probably be there to do it (or they will take a note to do it later). But do not ask too often, as this will annoy people and they will be less likely to vote on your response.

There's also one other major type of requirements; essays. The response on an essay should be longer than the questions requirements. Generally 3-5 paragraphs. The acctshell will tell you the length you should write.

Let's say you have responded to a requirement and want to know what the status on it is (what people have voted, if and what their feedback is, etc.). To do this you could do one of two things. To view the status of a single requirement, type votestatus <requirement> (or vs <requirement>). To get the status on all requirements, type allvotestatus (or avs). The result may look something like this:

acctshell> vs basicmiscquestions
Requirement to check vote status for: basicmiscquestions
You currently have 7 votes.
These votes have the scores: 95, 85, 100, 100, 100, 100, 85.
The current average of these votes is 95, however this may not be your actual score (use the checkscore command).
The minimum number of votes that you need for this requirement is 4 before your score shows up as non-zero.

4 users have left you feedback on this response.
The feedback, in no particular order:
- Good response.
- Nice and clear with lots of detail.
- 1=2, for sufficiently large values of 1.
- Nice response.

As it says, you should use the checkscore command to check the score on a requirement. So let's check my score on that requirement.

acctshell> checkscore basicmiscquestions
Requirement to check score on: basicmiscquestions
Your score on your basicmiscquestions is: 95

The required score for the sine:shellaccess privilege was 75, so I fullfilled that requirement. Now, let's see how the rest of the requirements for that privilege is going.

acctshell> privilegerequirementstatus sine:shellaccess
Privilege to check requirement status for: sine:shellaccess
Requirement: basicshellquestions   Minimum score: 75   Your current score: 90   Requirement fulfilled: Yes
Requirement: basicmiscquestions   Minimum score: 75   Your current score: 95   Requirement fulfilled: Yes
Requirement: shellusageessay   Minimum score: 75   You have not responded to this requirement yet
Requirement: communitycontributeessay   Minimum score: 50   You have not responded to this requirement yet
Requirement: blankspaceessay   Minimum score: 40   You have not responded to this requirement yet
Requirement: tosquestions   Minimum score: 100   Your current score: 100   Requirement fulfilled: Yes
Requirement: cluepoints   Minimum score: 300   Your current score: 38769   Requirement fulfilled: Yes

Anyway, when all of the requirements are fulfilled you get the privilege by running the command getprivilege <privilege> (or gp <privilege>).

Congratulations! You now know how to get shellaccess. If you have any questions, don't hesitate to ask anyone on IRC for help. We don't bite as long as you're following the rules.

Old Stuff

This is legacy stuff from the old acctshell.

Overview of Getting a Shell Account

See below for more detailed information.

1. Create a basic account
   • Apply for one via the Cluenet Account Shell
   • Ask someone on IRC to activate it
2. Get 500 CluePoints with the DaVinci Bot using Clueful Chatting on IRC
   • Read the the two links above for information about this
3. Apply for shell access
   • Write up answers to the questions in the SSH Access Application Form
   • Set your LDAP clueIrcNick attribute via the Cluenet Account Shell
   • Use the Cluenet Account Shell to apply for SSH access and fill in your answers to the application form questions
4. Get people on IRC to review your application and vote on it
   • At least 4 votes are required to get a shell account
   • At least 80% of votes must be positive
5. Ask an administrator to approve your application

Creating the Basic Account

Basic accounts can be created through the Cluenet Account Shell interface. Connect to the Cluenet Account Shell interface (following the instructions on that page to do so) and select the SignUp option from the menu.

You will be asked to enter your email address to verify that you can receive your password after you have signed up. Don't worry, we won't spam you. After you enter your email, you will be sent a verification code. When you receive the verification code, select the Verify option from the Cluenet Account Shell main menu. Enter your email address exactly as you entered it last time (it is case sensitive) and the verification code that you were given.

You will then be asked if you wish to continue with the signup process. Read the notice that it gives you, and select Yes if you would like to continue. You will then be asked to select a username. Usernames are checked with fuzzy matching against existing network and system usernames to prevent impersonation and local username conflicts.

After you select a username, your initial password will be generated for you. Remember this password! It will not be valid until the account is activated, but it will not be given to you again. Write it down if you have to, but it's not recoverable because passwords are hashed. You will be given the option to have the password emailed to you for your records, and you can select Yes if you'd like.

To get the account activated, you will have to join ClueIRC and ask a user with a clueAuthorizedAbility of createacct (click link to see who) to activate your account. There should be no additional requirements. Once someone activates your account, you will be able to log in to the wiki, forum, and other web services. If you would like shell access to the Cluenet servers, continue reading for instructions on that step of the signup process.

Upgrading your Account to have SSH Access

Because SSH access has many more security implications than forum or wiki access, the process for obtaining shell access is more complicated. After you have your basic account, you will be able to apply for SSH access. After you submit your SSH application, users will be given the ability to vote on it, and to give you personal feedback. You will be given the ability to view your current votes and feedback. You will also be able to edit your application form.

The requirements for SSH access are as follows:

• At least 4 total votes.
• At least 80% of votes are to accept.
• At least one administrator approval.
• At least 500 CluePoints (See DaVinci and Clueful Chatting).

If your application does not succeed within one month, it will be deleted. You can also ask an administrator to delete your application before this if you get many reject votes and would like to try again without waiting.

To start the application for an SSH account, log in to the Cluenet Account Shell with your username and password and select the ApplySSH option from the menu. You will be asked if you want to create a new application. If you select Yes, the requirements for approval will be listed, and you will be allowed to proceed.

You will then be asked to fill out the application form. Because substantial answers are expected, it is recommended that you write your responses beforehand and paste them into the application form. The questions are available here. People vote based largely on the quality of the application, so make sure you put some effort into it.

After you hit Control-x, then hit y and ENTER (in response to the messages at the bottom of the editor) to save your application form, you will be asked for final confirmation to submit your application. Once you submit your application, it will be made available to users to vote on.

You can edit your application and view the current number of votes (and feedback) by selecting the ApplySSH item from the main menu again. If the application is accepted or deleted, you will be sent a notification email. When all the requirements are satisfied, the account will automatically be upgraded.