1 |image2017-10-27_15-56-53.png|
3 ONAP Portal for Administrators
4 ==============================
9 The ONAP Portal platform integrates different ONAP applications into a
10 central core. The Portal platform provides common management services
11 and connectivity, while the applications run separately.
13 From the Portal, users access applications. Administrators onboard and
14 manage applications and widgets, and manage user access.
16 The Portal SDK for application developers includes bundled tools,
17 technologies, and built-in capabilities such as services, APIs, and UI
18 controls. Existing applications can migrate to the Portal with the
19 provided APIs and libraries. See `ONAP Portal SDK
20 Documentation <http://onap.readthedocs.io/en/latest/submodules/portal.git/docs/tutorials/index.html>`__\.
25 Access the ONAP Portal using Mozilla Firefox or Google Chrome(win/mac)
26 at the provided URL. For example: `https://<hostname:port>/ONAPPORTAL/login.html`.
28 Access the ONAP portal via the 8989 LoadBalancer documented `here <https://onap.readthedocs.io/en/latest/submodules/oom.git/docs/oom_user_guide.html#accessing-the-onap-portal-using-oom-and-a-kubernetes-cluster>`__
30 From the Portal, users access applications directly or by function using
35 - `Applications in the Portal`
37 - `Application Catalog`
42 The Portal displays different menus for the following functions:
54 Each application also defines a distinct set of user roles. See *Users* .
60 From the ONAP Portal, administrators:
62 - access the same functionality accessible to users (see `ONAP Portal
63 for users <#PAGE_1018759>`__)
65 - manage users and application admins
67 - onboard applications and widgets
69 - edit the functional menu
71 Administrators see the following menu when accessing the ONAP Portal:
73 |image2017-10-27_14-14-37.png|
75 Left menu descriptions:
82 Use the Admins section to:
84 |image2017-10-27_14-17-0.png|
86 View or search for application admins
87 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
89 #. From the ONAP Portal Home, click Admins in the left menu.
91 #. View or search for admins:
93 - The Admins table shows all admins in alphabetical order by first
94 name. Select an application from the dropdown list to view admins for
97 - Search for an admin by entering a full or partial search term in the
98 search box. Search by first name, last name, or user ID. Searches are
101 - Filter further using a combination of the applications dropdown and
104 Add an application admin
105 ~~~~~~~~~~~~~~~~~~~~~~~~
107 #. From the ONAP Portal Home, click Admins in the left menu.
109 #. Click Add Admin.The New Admin window displays.
111 #. Enter any combination of the user's first name, last name in the
112 search field and click Search.Note: A minimum of three characters is
115 #. Select the user from the results and click Next.
117 |image2017-10-27_14-23-38.png|
119 #. Select an application from the dropdown list.
121 |image2017-10-27_14-26-38.png|
125 The user can administer and manage users for the applications listed in
128 Modify application admin privileges
129 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
131 #. From the ONAP Portal Home, click Admins in the left menu.
133 #. Search for an admin and then select one by clicking the row in the
134 Admins table (see `View or search for application admins`.
136 #. Modify the admin's application privileges:
138 - Add an application to the Administrates list by selecting it from the
141 - Delete an application from the Administrates list by clicking the
144 |image2017-10-27_14-30-33.png| .
148 Delete an application admin
149 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
151 To delete an application admin completely, first remove access for each
154 #. From the ONAP Portal Home, click Admins in the left menu.
156 #. Search for a name and then select one by clicking the row in the
157 Admins table (see `View or search for application admins`.
159 #. Click the trash icon
161 |image2017-10-27_14-30-51.png| and click OK to confirm for each
162 application in the Administrates list.
166 The application Admin is removed from the table. The Admin is only
167 removed from the Admins table when they have no application access.
173 Use the Users section to:
175 |image2017-10-27_14-35-46.png|
177 View or search for users
178 ~~~~~~~~~~~~~~~~~~~~~~~~
180 #. From ONAP Portal Home, click Users in the left menu.
182 #. Select an application from the dropdown list.
184 #. Enter a full or partial first name, last, name, user ID, or role in
185 the search box; or click the column header to sort that column in
186 alphabetical or reverse alphabetical order.
191 Portal admins can add or manage users for any application. Application
192 admins can only add and manage users for their specific applications.
194 #. From ONAP Portal Home, click Users in the left menu.
198 #. The New User window displays.
200 #. Search for or add a new user:
202 - To search for a user, enter the user's complete first name, last
203 name, or user ID and click search.
205 - To add a new user, click New User, fill in the user details, and
206 click Add New User. The new user appears in the results list.
208 #. Select the user from the results and click Next.
210 |image2017-10-27_14-41-13.png|
212 #. Select a role from the dropdown lists for each application required
217 The user can access the applications with the roles listed in the Users
220 Modify users and roles
221 ~~~~~~~~~~~~~~~~~~~~~~
223 #. From ONAP Portal Home, click Users in the left menu.
225 #. Select an application from the dropdown, search for a user, and
226 select one by clicking the row in the Users table. The user's access
229 |image2017-10-27_15-21-13.png|
231 #. Modify the user's role for each application:
233 - Add or change a user role by selecting or clearing the role from the
236 - Remove all the user's roles for an application by clicking the trash
239 |ep_trash_icon.png| .
246 To delete a user completely, remove access for each application.
248 #. From the ONAP Portal Home, click Users in the left menu.
250 #. Select an application from the dropdown, search for a user, then
251 click the row in the Users table to select (see `View or search for
253 The user's access and roles display.
255 #. Click the trash icon
257 |ep_trash_icon.png| beside an application and click OK to confirm.
261 The User is removed from the applications. The User is only removed from
262 the Users table when they have no application access.
267 Use the Portal Admins section to:
269 |image2017-10-27_15-24-5.png|
271 View or search for Portal Admins
272 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
274 #. From ONAP Portal Home, click Portal Admins in the left menu.
276 #. Enter a full or partial first name, last, name, or ATTUID in the
277 search box, or click the sorting arrows in any column to sort that
278 column in alphabetical or reverse alphabetical order.
283 Only Portal Admins can add or delete other Portal Admins.
285 #. From the ONAP Portal Home, click Portal Admins in the left menu.
287 #. Click Add Portal Admin. The Add New Portal Admin window displays.
289 #. Search for or add a new user:
291 - To search for a user, enter the user's complete first name, last
292 name, or user ID and click search.
294 - To add a new user, click New User, fill in the user details, and
295 click Add New User. The new user appears in the results list.
297 #. Select the user from the results and click Save.
299 The user is listed in the Portal Admins table and can manage users and
302 Delete a Portal Admin
303 ~~~~~~~~~~~~~~~~~~~~~
305 Only Portal Admins can add or delete other Portal Admins.
307 #. From ONAP Portal Home, click Portal Admins in the left menu.
309 #. Search for or scroll to a name in the Portal Admins table and click
310 the trash icon in the Delete column.
312 #. Click OK to confirm.
314 The Portal Admin is removed from the table.
316 Application Onboarding
317 ----------------------
319 Use the Application Onboarding section to:
321 |image2017-10-27_15-27-1.png|
323 Add an application to the Portal
324 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
326 #. From the ONAP Portal Home, click Application Onboarding in the left
331 #. The Application Details window displays.
333 |image2017-10-27_15-28-31.png|
335 4. Fill out the fields as described in the table:
337 +---------------------------+------------------------------------------+
338 | **Hyperlink only | Select to add an application with a URL |
339 | application** | only. |
340 +===========================+==========================================+
341 | **Application name** | Application name to display in the |
343 +---------------------------+------------------------------------------+
344 | **URL** | Application landing page for |
345 | | hyperlink-only applications. |
346 +---------------------------+------------------------------------------+
347 | **REST API URL** | [Optional] The endpoint for RESTful API |
349 +---------------------------+------------------------------------------+
350 | **Username** | The username for the RESTful API calls. |
351 | | Default = Default |
352 +---------------------------+------------------------------------------+
353 | **Password** | Password for the RESTful API call. |
354 | | Default = AppPassword!1 |
355 +---------------------------+------------------------------------------+
356 | **Name Space** | Namespace value when Application |
357 | | registered in AAF. |
358 +---------------------------+------------------------------------------+
359 | **Communication Inbox** | Do not fill out. Populated by the |
361 +---------------------------+------------------------------------------+
362 | **Communication Key** | Do not fill out. Populated by the |
364 +---------------------------+------------------------------------------+
365 | **Communication Secret** | Do not fill out. Populated by the |
367 +---------------------------+------------------------------------------+
368 | **Upload image** | Click Browse to select the application |
369 | | image to display in the ONAP Portal. |
370 +---------------------------+------------------------------------------+
371 | **Allow guest access** | Select to allow access for users not |
372 | | listed as Users or Admins. |
373 +---------------------------+------------------------------------------+
374 | **Active** | Select to make the application active. |
375 +---------------------------+------------------------------------------+
376 | **Centralized** | Indicate this application is using AAF |
377 | | for centralized role management. |
378 +---------------------------+------------------------------------------+
382 The application appears in the Applications section and in the
383 Application Onboarding table. The Portal Admin receives an email with
384 Communications details.
386 6. Add the application URL to the appropriate Manage menu items:
388 #. Click Edit Functional Menu in the left menu.
390 #. Expand the Manage menu to find the correct items.
392 #. Right-click an item and select Edit.
394 |ep_editmenu_edit.png|
396 #. In the URL field, enter the server URL of the new application and
399 Collect and forward application communication details
400 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
402 The Portal administrator forwards communications details and a list of
403 servers to the application developer. The application developer adds the
404 details to the portal-properties file located in \\<app web
405 directory>/WEB-INF/classes.
407 **Prerequisites:** *Add an application to the Portal*
409 #. Collect the following details and send them to the application
412 +----------------------------------------+-----------------------------+
413 | Key-value pair | Obtain from |
414 +========================================+=============================+
415 | redirect_url = ** /** | The redirect URL defined |
416 | /process_csp | as ** /** /process_csp. |
417 +----------------------------------------+-----------------------------+
419 #. Request that the application developer:
421 #. Add the key-value pairs above to the portal.properties file located
422 in ** /WEB-INF/classes.
424 #. Add the key-value pair shared_context_rest_url = ** to the
425 system.properties file located in the ** /WEB-INF/conf directory.
427 #. Restart the application
429 Delete an application from the Portal
430 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
432 #. From the ONAP Portal Home, click Widget Onboarding in the left menu.
434 #. Search for or scroll to an application in the table and click the
437 |ep_trash_icon.png| in the Delete column.
439 #. Click OK to confirm.
441 The application is removed from the Portal.
446 Use the Widget Onboarding section to:
448 |image2017-10-27_15-51-18.png|
450 Add an application widget to the Portal
451 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
453 #. From ONAP Portal Home, click Widget Onboarding in the left menu.
457 The Widget Details window displays.
459 |image2017-10-27_15-52-28.png|
461 3. Fill out the fields as described in the following table.
463 +------------------+---------------------------------------------------+
464 | **Application | Select from a dropdown list of onboarded |
465 | Name** | applications. |
466 +==================+===================================================+
467 | **Widget Name** | The name for the widget that appears in the |
468 | | Widgets section of the Portal. |
469 +------------------+---------------------------------------------------+
470 | **Width, | Automatically populated fields. |
472 +------------------+---------------------------------------------------+
473 | **URL** | Widget landing page. |
474 +------------------+---------------------------------------------------+
478 The widget appears in the Widgets section of the Portal. Users with
479 permissions to the widget's application can access the widget.
481 Remove a widget from the Portal
482 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
484 #. From ONAP Portal Home, click Widget Onboarding in the left menu.
486 #. Search for or scroll to a widget in the table and click the trash
489 |ep_trash_icon.png| in the Delete column.
491 #. Click OK to confirm.
493 The widget is removed from the Portal.
498 Edit or rearrange the ONAP Portal functional menus in the Edit
499 Functional Menu section.
501 |image2017-10-31_11-12-22.png|
503 ONAP Portal menus have 4 levels. The menu levels correspond to how and
504 where the menu items appear in the Portal UI.
506 |image2017-10-31_10-49-27.png|
508 Use the Edit Functional Menu section to:
513 #. From ONAP Portal Home, click Edit Functional Menu in the left menu.
515 #. Use the arrows to expand the menu, then right-click on the intended
516 parent menu item and select Add.
518 |image2017-10-31_11-16-14.png|
520 #. Enter a title for the menu item, then enter a URL or select the
521 application to link to from the App dropdown list.
525 #. Click Regenerate Menu to finalize the changes and update the menu.
530 #. From the ONAP Portal Home, click Edit Functional Menu in the left
533 #. Use the arrows to expand the menu, then right-click on the menu item
536 #. Make changes to the title, URL, or application and click Continue.
538 #. Click Regenerate Menu to finalize the changes and update the menu.
540 |image2017-10-31_11-21-2.png|
545 #. From ONAP Portal Home, click Edit Functional Menu in the left menu.
547 #. Use the arrows to expand the menu.
549 #. Click and drag a menu item to move it.A blue line appears to indicate
550 where the menu item will move. A blue box indicates the moved item
551 will be a child of that item.
553 |image2017-10-31_11-23-15.png|
555 #. Click Regenerate Menu to finalize the changes and update the menu.
560 A menu item with children cannot be deleted. Delete all child menu items
563 #. From ONAP Portal Home, click Edit Functional Menu in the left menu.
565 #. Use the arrows to expand the menu, then right-click on the menu item
570 #. Click Regenerate Menu to finalize the changes and update the menu.
572 Portal Microservices Onboarding
573 -------------------------------
575 From left menu Microservice Onboarding section:
577 |image2017-10-31_11-29-12.png|
579 Add a microservice widget to the Portal
580 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
582 #. From ONAP Portal Home, click Microservice Onboarding in the left
585 #. Click Add Microservice.
587 The Microservice Details window displays.
589 |image2017-10-31_11-34-8.png|
591 3. Fill out the fields as described in the following table.
593 +---------------------------------+------------------------------------+
594 | **Field** | Explanation |
595 +=================================+====================================+
596 | **Microservice Name** | The name for the microservice that |
597 | | appears in the Microservice |
598 | | section of the Portal. |
599 +---------------------------------+------------------------------------+
600 | **Microservice Description** | Describe what the microservice |
602 +---------------------------------+------------------------------------+
603 | **Application Name** | Select from a dropdown list of |
604 | | onboarded applications. |
605 +---------------------------------+------------------------------------+
606 | **Microservice End Point URL** | Enter Microservice URL |
607 +---------------------------------+------------------------------------+
608 | **Security Type** | Select from dropdown for |
609 | | Authentication Method |
610 +---------------------------------+------------------------------------+
611 | **Add User Parameter** | Enter parameter key and value if |
612 | | applicable to microservice end |
614 +---------------------------------+------------------------------------+
615 | **Active** | Active check/uncheck to show/hide |
616 | | the microservice |
617 +---------------------------------+------------------------------------+
621 The microservice appears in the Microservices section of the Portal.
622 Users with permissions to the Microservice application can access the
625 Remove a microservice from the Portal
626 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
628 #. From ONAP Portal Home, click Microservice Onboarding in the left
631 #. Search for or scroll to a microservice in the table and click the
634 |ep_trash_icon.png| in the Delete column.
636 #. Click OK to confirm.
638 The mocroservice is removed from the Portal.
640 .. |image2017-10-27_15-56-53.png| image:: attachments/16004343_image2017-10-27_15-56-53.png
641 .. |image2017-12-5_15-8-37.png| image:: attachments/20086820_image2017-12-5_15-8-37.png
642 .. |image2017-10-27_14-14-37.png| image:: attachments/16004284_image2017-10-27_14-14-37.png
643 .. |image2017-10-27_14-17-0.png| image:: attachments/16004288_image2017-10-27_14-17-0.png
644 .. |image2017-10-27_14-23-38.png| image:: attachments/16004295_image2017-10-27_14-23-38.png
645 .. |image2017-10-27_14-26-38.png| image:: attachments/16004297_image2017-10-27_14-26-38.png
646 .. |image2017-10-27_14-30-33.png| image:: attachments/16004301_image2017-10-27_14-30-33.png
647 .. |image2017-10-27_14-30-51.png| image:: attachments/16004303_image2017-10-27_14-30-51.png
648 .. |image2017-10-27_14-35-46.png| image:: attachments/16004306_image2017-10-27_14-35-46.png
649 .. |image2017-10-27_14-41-13.png| image:: attachments/16004309_image2017-10-27_14-41-13.png
650 .. |image2017-10-27_15-21-13.png| image:: attachments/16004321_image2017-10-27_15-21-13.png
651 .. |ep_trash_icon.png| image:: attachments/1018932_ep_trash_icon.png
652 .. |image2017-10-27_15-24-5.png| image:: attachments/16004324_image2017-10-27_15-24-5.png
653 .. |image2017-10-27_15-27-1.png| image:: attachments/16004327_image2017-10-27_15-27-1.png
654 .. |image2017-10-27_15-28-31.png| image:: attachments/16004329_image2017-10-27_15-28-31.png
655 .. |ep_editmenu_edit.png| image:: attachments/1018942_ep_editmenu_edit.png
656 .. |image2017-10-27_15-51-18.png| image:: attachments/16004338_image2017-10-27_15-51-18.png
657 .. |image2017-10-27_15-52-28.png| image:: attachments/16004340_image2017-10-27_15-52-28.png
658 .. |image2017-10-31_11-12-22.png| image:: attachments/16004934_image2017-10-31_11-12-22.png
659 .. |image2017-10-31_10-49-27.png| image:: attachments/16004915_image2017-10-31_10-49-27.png
660 .. |image2017-10-31_11-16-14.png| image:: attachments/16004936_image2017-10-31_11-16-14.png
661 .. |image2017-10-31_11-21-2.png| image:: attachments/16004943_image2017-10-31_11-21-2.png
662 .. |image2017-10-31_11-23-15.png| image:: attachments/16004944_image2017-10-31_11-23-15.png
663 .. |image2017-10-31_11-29-12.png| image:: attachments/16004954_image2017-10-31_11-29-12.png
664 .. |image2017-10-31_11-34-8.png| image:: attachments/16004962_image2017-10-31_11-34-8.png