Enportal/old/provisioning quick start

Revision as of 06:51, 17 July 2014 by imported>Jason.nicholls
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This page is intended for a first-time user of enPortal. It provides concise examples of how to implement basic provisioning of enPortal. For a complete reference for provisioning content to users in an organization, see Provisioning.

This document assumes that you have successfully completed the enPortal installation. If you are provisioning AppBoard content, this document also assumes that you have successfully completed the AppBoard Getting Started guide to create some sample AppBoard content.


What is Provisioning?

For a User to log in to enPortal and view content, an Administrator must first create the User in the system and then assign appropriate content to that User. Provisioning is the means of configuring these assignments through the administrative interface.


Summary of Steps

The following are the high-level steps to complete in order to provision content to a User:

  1. Log in as Administrator
  2. Create a Domain
  3. Create a User
  4. Create a Role
  5. Assign User to Role
  6. Assign Content to Role
  7. Login as User to Validate Assignment


Log in as Administrator

You must log in as an administrator to configure provisioning.

In this section, you will log in as an administrator.

  1. In a supported browser, go to the enPortal login page. This will typically be a URL such as http://enportalhost:8080/.
  2. Enter the default administrator credentials:
    1. User Name: administrator
    2. Password: administrator
    3. Domain: System
  3. Click the Login button
  4. Go to the enPortal home page. This will typically be a URL such as http://enportalhost:8080/enportal/home


Create a Domain

A Domain is a group of one or more Users.

In this section, you will create a new Domain called "Edgetech".

  1. Mouse over the Provisioning tab and click Users to show the Domain Explorer.
  2. Right-click on the Domains label and select New Domain.
  3. In the New Domain Name box, enter "Edgetech".
  4. Click Save.
  5. Observe that a new Domain "Edgetech" has been created.

Create a User

A User is an individual with unique credentials for logging into enPortal and viewing assigned content.

In this section, you will create a new User.

  1. Right-click on the label for the new "Edgetech" Domain and select New User.
  2. Enter the following to create a new user:
    1. New User Name: John Davis
    2. Password: portal
    3. Confirm Password: portal
  3. Do not check the Lock Account box or enter a Lock Reason.
  4. Click Save.
  5. Observe that a new user "John Davis" has been created.


Template-tip.png
If you are using enPortal for the first time, this may be a good time to modify administrative access to the system. You can change the default password for the "administrator" User (located under the "System" Domain) to a more secure password. You can also create another administrative User, if desired. It is recommended to have at least one User, besides "administrator", with portalAdministration Role privileges, so that you are not completely locked out of the system if you forget the password for "administrator".


Create a Role

A Role is a mechanism used to organize the provisioning of content and permissions. Roles are the primary basis by which capabilities are managed, preferences are stored, and content is assigned and secured.

In this section, you will create a new Role.

  1. Mouse over the Provisioning tab and click Roles to show the Provisioning panel.
  2. Click on the Actions button and select New Role.
  3. In the New Role Name box, enter "Manager".
  4. Click Save.
  5. Observe that a new role "Manager" has been created.

Assign User to Role

In this section, you will assign a User to a Role.

  1. On the Roles page, select the "Manager" Role in the Provisioning panel
  2. Click on the Users tab in the right panel
  3. Click the Assign button to browse for a User or Domain to assign to the new role. A User Selection window will be launched.
  4. Under the "Edgetech" Domain, select "John Davis" and click Ok to assign him to the "Manager" Role and close the window. The Users tab will now show "John Davis" in the right panel, indicating that he is assigned to the currently selected ("Manager") Role.


Template-note.png
If you assign a Domain to a Role, all current and future Users in that Domain will be assigned to that Role.


Template-tip.png
If you created a new User that you want to have administration capabilities, you can assign full administration privileges to that user by assigning the User to the "portalAdministration" role.

Create Content

You must create channels in enPortal that display the content that you want to assign to each Role. You then assign these channels to the appropriate Role, so that any User who logs in, with that Role assigned, will see the content.

In this section, you will create a channel containing an AppBoard visualization, and then assign that channel to the "Manager" Role. Note: this step assumes that you have completed the Getting Started Tutorial and created an AppBoard Stack to be assigned. The same procedure would apply for assigning other types of channels, including PIM channels, to a Role.

Perform the following steps to create a Channel containing an AppBoard Stack:


  1. Mouse over the Provisioning tab and click Content.
  2. Click on the Actions button and select New Subfolder
  3. For the name of the Viewset (subfolder), enter "USA_States" and press Enter. The new "USA_States" Folder is displayed in the Viewset list.
  4. Right-click on "USA_States" and select New Channel.
  5. For Channel Name, enter "USA_States_Visualization".
  6. Under Channel Types, select Appboard.
  7. Click Next.
  8. A list of AppBoard stacks will be displayed. Check the Display box next to the stack names "USA_States_Stack"
  9. Click Save. Observe that the channel "USA_States_Visualization" is now listed under the "USA_States" Folder when you refresh the Content panel.

Assign Content to Role

Now that you have created a channel in enPortal displaying your AppBoard Stack, you will need to assign this channel to the appropriate Role.

In this section, you will assign the "USA_States_Visualization" channel to the "Manager" Role.

  1. Click the Refresh button on the browser to update the caching of content.
  2. Mouse over the Provisioning tab and click Roles to show the Provisioning panel.
  3. Click the "Manager" Role. Observe a list of assignable content in the Content panel.
  4. Check the box next to the "USA_States_Visualization" channel to assign that channel to the "Manager" Role.
  5. Click Save.


Template-note.png
You typically will not want to assign any of the "Admin" content to a non-administrator User. However, you are able to do so if desired. For example, if you click the box next to "AppBoard", this will assign the AppBoard Builder to the Manager Role and anyone in that Role could then log in and build their own visualizations.

Login as User to Validate Assignment

In this section, you will log in to enPortal as the new User John Davis and confirm that the appropriate content is displayed based on the assignments you have made.

  1. Click Logout to log out of enPortal as administrator. The login page is displayed.
  2. Enter the credentials for John Davis:
    1. User Name: John Davis
    2. Password: portal
    3. Domain: Edgetech
  3. Click the Login button
  4. Observe that the USA_States AppBoard visualization is displayed, which you assigned to John's Role ("Manager").