To get started, first you must be using the Enterprise Edition. You must also be logged in as an administrator.

Now click on the Configuration tab, and select "Authentication Settings".

If there is no record, click "+" to add the record.

Here you will see some configuration options, along with the script area.

• Custom Auth Enabled: This must be set to Yes for the script to be active.
• Login Prompt: Optional. This changes the text displayed to the user when they login.
• Login Username Label: Optional. This changes the label for the Username field in the login page.
• Login Button label: optional. This changes the Login button.
• Custom Auth Script: This is where the authentication script is placed.
• Post Auth Script: This is a script that will run after the user has logged in, and the user record is created. You can use this to perform additional actions such as setting up user groups.

Note: if there are any errors in the authentication script, you may not be able to login (the script error will be displayed to the user). As such be careful when creating the script. However you can always login as the admin user. This will let you login, but display any script errors in the systemlog.aspx page.