Redirected from User:Coreyg/mt/User Manual/Control Panel/Users and Groups
Was this page helpful?

Users and Groups

    Users and Groups

    The Users and Groups section allow you to manage users, groups, roles, and authentication integration

    Adding New Users

    =media_1219035337018.png
    1. Add a username for the user. Note: This will be a visible username to all users on the wiki so it is best not to use private information like email
    2. Add the email of the new user so that they can receive system notifications including their new login credentials
    3. If you don't type, and verify, a password for the user then the system will automatically generate one for them and send it to them in an email
    4. Specify the role that you want this user to have - See Role Management for more details on what roles are available
    5. Select the service that the user belongs to. By default the service will be Local. If you are adding users through an External Authentication service, you'll need to add them through the External Authentication interface as opposed to MindTouch's interface
    6. Add the user to a group that has been setup already. Note: You can add users to groups after they have been created through the group management interface
    7. Click add user, the user will then be email their login credentials and they will be listed in the User Management list below this form. 9) Click on this to Add Multiple Users at once

    Add Multiple Users

    =media_1219035802735.png

    To add multiple users at once do the following:

    1. Enter username and email address separated by commas with one entry per line, as seen above
    2. Select the Role that you want applied to all of the Users. Note: User roles can be changed after being added
    3. Select the Authentication method, default is Local
    4. If you specify an External Authentication Provider for the Service then you may be required to enter credentials in order for MindTouch to access it
    5. Add all of the users to a group or many groups
    6. Once you have everything configured then click the Add Multiple Users button and they will automatically be sent emails with their login credentials

    User Management

    =media_1219034422490.png

    If you'd like to view a list of all of the users click the View All link, otherwise you can enter a name, email, or keyword into the search field and find one user or set of users depending on the search. If you click View All then you will see a screen that looks like the following:

    =media_1219034687718.png

    Note that on this page you can also search for users along with editing individual users. If you want to Activate or Deactivate a User, depending on current status, you would select the user that you want to perform the action on and then select either Activate or Deactivate. This will then present the following image:

    =media_1219034895248.png

    In this case we are going to activate the user Admin. To activate click the Activate button. If you want to abort the operation then click the Cancel button.

    Adding Users to Groups

    =media_1219036101982.png

    If you didn't add users to a group when you created them you can add them to one now. Select the users that you want to addd to a group and then click Add to Groups. Then you will see the following where you can select the Group(s) that you want to add the user(s) to and then click Add to Groups.

    =media_1219036181625.png

    Change user roles

    =media_1219036310550.png

    To change the roles of user(s), select the user(s) and then click the Change roles link. This will then show the following where you can select the new role that you want to apply to the selected users. One you have selected the role click the Change roles button and the roles will be applied to the user(s)

    =media_1219036391944.png

    Group Management

    =media_1219088776235.png

    The Group management page allows you to Create, Edit, and Delete Groups. To Add a Group click the Add Groups link.

    Add Groups

    =media_1219088869546.png
    1. Add the name of the Groups you want to add, seperated by commas
    2. Select the Role that you want to associate with the groups
    3. Select the Authentication Service that this group is associated with
    4. Click Add Groups to add the groups to MindTouch

    Delete Groups

    =media_1219089099320.png

    To Delete a group, select the group(s) you want to remove and then click the Delete link. This will then bring up the following confirmation screen which you will select Delete in order to remove the group(s) from the system.

    =media_1219089197120.png

    Edit Groups

    =media_1219089236217.png

    Need to add the Edit Group page

    =media_1219682355671.png

    Change the Role of the group and then click Edit Group, otherwise click Cancel to exit the screen

    Role Management

    =media_1219089693843.png
    1. LOGIN
      The Login Attribute stipulates if a user is able to login when they reach the site. This, with READ, are the most fundamental of roles.

    2. BROWSE
      The BROWSE Attribute stipulates if a user is able to browse the hierarchy or discover content within the wiki via search.

    3. READ
      The READ Attribute stipulates if a user is able to view a page, comments, or attachments.

    4. SUBSCRIBE
      The Subscribe Attribute stipulates if a user is able to subscribe to the RSS feeds of the system which will show pages changes

    5. UPDATE
      The UPDATE Attribute stipulates if a user is able to make changes to a page or attach files in the wiki

    6. CREATE
      The CREATE Attribute stipulates if a user is able to create a New Page within the wiki

    7. DELETE
      The DELETE Attribute stipulates if a user is able to Delete an existing page within the wiki

    8. CHANGE PERMISSIONS
      The CHANGE PERMISSIONS Attribute stipulates if a user is able to Change or Add Permissions of a page

    9. CONTROL PANEL
      The CONTROL PANEL Attribute stipulates if a user has access to the Control Panel - This should only be accessible to the Admins of the wiki, use sparingly

    10. UNSAFE CONTENT
      The UNSAFE CONTENT Attribute stipulates if a user is able to add unsafe scripts or HTML into a wiki page without it being stripped out. If you want the users to be able to add some
      Unsafe Content then take a look at adding an extension for it.

    11. ADMIN
      The ADMIN Attribute stipulates if a user has Admin privledges which overrides all other permissions and restrictions. Use sparingly.

    12. To add a new Role, give the role a name, click on the permissions you want to associate with the role and then click Add Role
      Note: You cannot delete a role through the Role Management interface

    Authentication

    Any editing, creating, and management of External Authentication Services are done in this section

    Add Authentication Service

    =newauth.png

    To add an external authentication service to MindTouch click the Add Authentication Service

    =externalauth.png
    1. Click on the Authentication service that you are setting up - Note: If you select a service other than Custom, then it will prefill the fields to give you a template to customize
    2. The Description is the name that the service will be referenced as in the list of Authentication Services
    3. The Type is whether it is Native or Remote
    4. The SID is the Service Identifier that, along with the other fields, will have a default if you select any other service
    5. Configuration includes the connection values for your authentication server
    6. If there are any preferences that you need to pass to your authentication server, they would be entered in this section
    7. Once everything has been configured then click the Add Authentication Service and it will be activated and listed on the Authentication Page

    Notes about Authentication Services

    • Once the Authentication provider is added, users can login to MindTouch with their external auth username and password and MindTouch will automatically create a user locally.
    • If there is a Local user that has the same username as an External Auth user, before logging in with the external auth credentials, change the Local user's profile from Local Service to the External Auth Service.  If this isn't done, when the user logs in with their External auth credentials, it will create a username with a "1" after it to avoid conflicts. 
    • When manually adding external auth users or groups, you may have to enter external auth credentials in order for them to be added.  You will be prompted on the Add page for user and groups when you go to add one.

    Restarting and Stopping Authentication Services

    =newauth_1.png

    If you want to Restart or Stop an Authentication service, select the service and then click on the link for the action you want to perform. If you stop the service then in the Status column it will say Stopped.

    Delete an Authentication Service

    =newauth_2.png

    To Delete an Authentication Service, click the service and then Click Delete. To finalize the Delete then click Delete Authentication Providers as seen below. If you want to cancel the Delete then you can click Cancel.

    =media_1219791466266.png

    Edit an Authentication Service

    =newauth_3.png

    If you want to edit an External Authentication click the Edit link next to the External Auth Service. This will open up the following screen where you can edit the settings for the authetication service. Once you are done with the configuration click the Edit Authentication Service button.

    =media_1219791873177.png

    Set Authentication as Default

    =newauth_4.png

    You can change which authentication is set as Default so that when your users get to the login page it will be the default one checked. With a fresh install, the Local Authentication service is default. To change the default service click on the grey dot next to the service that you want to make default. This will change into a green check denoting that it is now the Default authentication service.

    Was this page helpful?
    Tag page
    You must login to post a comment.

    Copyright © 2011 MindTouch, Inc. Powered by