+ All Categories
Home > Documents >  · Web viewUser Interfaces. This document does not drill down in to the specific layout and...

 · Web viewUser Interfaces. This document does not drill down in to the specific layout and...

Date post: 10-Jan-2020
Category:
Upload: others
View: 0 times
Download: 0 times
Share this document with a friend
45
GeNS System Requirements 26 September 2016 Document 16 Service Requirements Specifications IPPC ePhyto GeNS v0.1Draft Confidential - Client 42638.92
Transcript
Page 1:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

GeNS System Requirements 26 September 2016Document 16

Service Requirements SpecificationsIPPC ePhyto GeNS

v0.1DraftConfidential - Client

26/09/2016

Page 2:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

Table of ContentsDOCUMENT PROFILE...............................................................................................5DOCUMENT LOCATION............................................................................................5REVISION HISTORY..................................................................................................5DISTRIBUTION...........................................................................................................51. INTRODUCTION..................................................................................................6

1.1 Purpose................................................................................................................................61.2 Intended Audience and Reading Suggestions.....................................................................61.3 References...........................................................................................................................6

2. OVERALL DESCRIPTION...................................................................................72.1 Service Operational Requirements.....................................................................................72.2 Product Perspective.............................................................................................................72.3 Product Functions...............................................................................................................82.4 Design and Implementation Constraints...........................................................................112.5 User Documentation.........................................................................................................112.6 Assumptions and Dependencies.......................................................................................12

3. EXTERNAL INTERFACE REQUIREMENTS.....................................................133.1 User Interfaces..................................................................................................................133.2 Hardware Interfaces..........................................................................................................143.3 Software Interfaces...........................................................................................................153.4 Communications Interfaces..............................................................................................15

4. SYSTEM FEATURES.........................................................................................164.1 User Authentication..........................................................................................................16

4.1.1 Description and Priority..........................................................................................164.1.2 Stimulus/Response Sequences................................................................................164.1.3 Requirements..........................................................................................................16

4.2 Forgot Password................................................................................................................164.2.1 Description and Priority..........................................................................................164.2.2 Stimulus/Response Sequences................................................................................164.2.3 Requirements..........................................................................................................17

4.3 Modify Password..............................................................................................................174.3.1 Description and Priority..........................................................................................174.3.2 Stimulus/Response Sequences................................................................................174.3.3 Requirements..........................................................................................................17

4.4 Manage GeNS Users.........................................................................................................174.4.1 Description and Priority..........................................................................................174.4.2 Stimulus/Response Sequences................................................................................174.4.3 Requirements..........................................................................................................18

4.5 Manage Companies...........................................................................................................184.5.1 Description and Priority..........................................................................................184.5.2 Stimulus/Response Sequences................................................................................184.5.3 Requirements..........................................................................................................18

4.6 Manage Lookups...............................................................................................................19

Confidential - Client Page 2 of 34 26/09/2016

Page 3:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

4.6.1 Description and Priority..........................................................................................194.6.2 Stimulus/Response Sequences................................................................................194.6.3 Requirements..........................................................................................................19

4.7 Create ePhyto....................................................................................................................204.7.1 Description and Priority..........................................................................................204.7.2 Stimulus/Response Sequences................................................................................204.7.3 Requirements..........................................................................................................20

4.8 Apply for Certificate.........................................................................................................214.8.1 Description and Priority..........................................................................................214.8.2 Stimulus/Response Sequences................................................................................214.8.3 Requirements..........................................................................................................21

4.9 Issue ePhyto Certificate....................................................................................................214.9.1 Description and Priority..........................................................................................214.9.2 Stimulus/Response Sequences................................................................................214.9.3 Requirements..........................................................................................................22

4.10 Re-Issue ePhyto Certificate...............................................................................................224.10.1 Description and Priority..........................................................................................224.10.2 Stimulus/Response Sequences................................................................................224.10.3 Requirements..........................................................................................................22

4.11 Cancel ePhyto Certificate.................................................................................................234.11.1 Description and Priority..........................................................................................234.11.2 Stimulus/Response Sequences................................................................................234.11.3 Requirements..........................................................................................................23

4.12 View Import Certificates...................................................................................................234.12.1 Description and Priority..........................................................................................234.12.2 Stimulus/Response Sequences................................................................................234.12.3 Requirements..........................................................................................................23

4.13 Print ePhyto Certificate.....................................................................................................244.13.1 Description and Priority..........................................................................................244.13.2 Stimulus/Response Sequences................................................................................244.13.3 Requirements..........................................................................................................24

4.14 Archive Import Certificate................................................................................................244.14.1 Description and Priority..........................................................................................244.14.2 Stimulus/Response Sequences................................................................................244.14.3 Requirements..........................................................................................................24

4.15 View Usage Statistics.......................................................................................................244.15.1 Description and Priority..........................................................................................244.15.2 Stimulus/Response Sequences................................................................................244.15.3 Requirements..........................................................................................................24

5. OTHER NON-FUNCTIONAL REQUIREMENTS................................................265.1 Performance Requirements...............................................................................................265.2 Safety Requirements.........................................................................................................275.3 Security Requirements......................................................................................................275.4 Software Quality Attributes..............................................................................................295.5 Availability Requirements................................................................................................295.6 Data Life-cycle Requirements........................................................................................295.7 Business Rules..................................................................................................................30

Confidential - Client Page 3 of 34 26/09/2016

Page 4:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

6. OTHER REQUIREMENTS.................................................................................317. APPENDIX A: GLOSSARY...............................................................................328. APPENDIX B: ANALYSIS MODELS.................................................................33

Confidential - Client Page 4 of 34 26/09/2016

Page 5:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

Document Profile

Author: ICC

Owner: UNICC

Client: FAO-IPPC

Document Number:

Document LocationThis document is only valid on the day it was printed.

The source of the document is the IPPC Project Site (https://project.unicc.org).

Revision HistoryDate of next revision: N/A

Version: Who: What: When:0.1 Gianluca Nuzzo Initial Draft 15/09/20160.1Draft Shashank Rai Multiple changes/additions 26/09/2016

DistributionThis document has been distributed to:

Name Title Date of Issue VersionIPPC GeNS Requirements

Specification v0.1 Draft

26/09/2016 0.1 DRAFT

Confidential - Client Page 5 of 34 26/09/2016

Page 6:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

1. Introduction1.1 PurposeThe purpose of this document is to formally specify the requirements for the Generic ePhyto National System (GeNS) – a standalone application that will enable the NPPO of any country (and exporters within that country) to create and exchange ePhyto certificates, if the country does not have an IT system capable of doing so. The document will describe all the technical components of the GeNS without going into the details of the applied ePhyto standards, agreements between countries, release and implementation details.The GeNS will produce electronic Phytosanitary Certificates (ePhyto) in accordance with ISPM 12 (including Appendix 1).

1.2 Intended Audience and Reading SuggestionsThis document will serve as an unambiguous and common understanding of the Requirements in order to avoid any possible misinterpretation that might exist with reference to the system’s requirements between the Project Technical Committee and the ICC but also available for :

- Stakeholders- System Business Analyst- System Architect- Quality Assurance Team- Software Developers

It is strongly suggested to read documentation published under the FAO/IPPC ePhyto site https://www.ippc.int/en/ephyto/ see more on the reference section of this document.

1.3 ReferencesA Global ePhyto Feasibility Study

ePhyto Hub - Frequently Asked Questions

Global ePhyto Solution

Codes And Schemas

ePhyto Certificates ISPM 12

Confidential - Client Page 6 of 34 26/09/2016

Page 7:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

2. Overall Description2.1 Service Operational RequirementsThis section lists some key operational requirements of the GeNS; and the remainder of this document describes the technical requirements for building the service.The GeNS system should be capable of being deployed in two different modes of operation:

a) Stand-alone mode : Any NPPO with the required ICT capabilities should be able to setup (with technical assistance of ICC) and operate the GeNS independently. In this mode, the software provider (for example ICC) should deliver application ‘bug fix’ and feature enhancements services. Request for enhancements will be submitted to IPPC and upon their approval the software provider will update the system. The NPPO will be eligible to receive such updates. The service and the associated ICT infrastructure will be managed and operated by the NPPO.

b) Central Hosted mode : The service will be operated by ICC running the software in its UN jurisdiction based data centres. As part of the ‘on-boarding’ process, working with the IPPC, ICC will provide access to any NPPO.

The functional and non-functional requirements for both ‘modes of operation’ are almost same and are elaborated in this document. If there are any differences in the requirements, these have been highlighted.For the ‘Central Hosted mode’; ICC service should include:

a) 24/7 (round-the-clock) Service Desk to provide assistance in technical matters only. Specifics of how to access the Service Desk will be established during the project implementation. The SD will interact with the NPPO itself and not directly with any in-country company (exporter).

b) NPPO On-boarding process : Upon request of the IPPC Secretariat, ICC will ‘on-board’ a NPPO to use the GeNS. A detailed procedure will be established during project implementation. ICC will liaise with the NPPO nominated technical focal point for this process.

c) Service Level Agreements (SLAs): ICC will ensure that the GeNS operates on agreed Service Levels and intervene as and when necessary to uphold these Service Levels. Some key SLAs have been identified in this document as ‘Non-functional requirements’.

d) Operational Procedures : As part of the project implementation, ICC will work with the IPPC to establish operational procedures for change management, monitoring & reporting as well as incident & problem handling in line with industry best-practices conforming to ISO 20000 (commonly known as ITIL).

e) Service Security : ICC will ensure security of the service during operations; specifically on protecting the sensitive NPPO data.

For the ‘Standalone mode’; ICC service should include:a) 24/7 (round-the-clock) Service Desk to provide support for software related issues.b) Technical assistance for setting up and deployment of the GeNS at the NPPO

infrastructure.c) Software patch and release management.d) Technical assistance for the NPPO during major software upgrades.

Confidential - Client Page 7 of 34 26/09/2016

RAI Shashank, 26/09/16,
This is a suggesstion. ICC is open to providing support for exporters. However, if NPPOs can support the in-country exporters; it will be cost-effective.
Page 8:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

2.2 Product PerspectiveThe Generic ePhyto National System (GeNS) is a web application that will provide basic functionalities to NPPO and exporters of countries which don’t have IT systems capable of issuing and receiving standardized ePhyto certificates. The system will also provide a standardized process for creating and, by using the IPPC ePhyto HUB, for exchanging ePhyto certificates.

2.3 Product FunctionsThe following is a list of main modules and related functionalities needed by the HUB. These are further elaborated in Section 4: System Features.

Component Use Case/functionality

Description

Users Management Application module providing authentication and authorization of the end user in the system as well as administrative users management functionalities.There are 3 administrator roles in the system:GeNS Administrator: To manage the entire GeNS system (including adding NPPOs in central mode). This role will be handled by IPPC/ICC (exact breakdown to be determined during project implementation). In a standalone system this will be handled by the NPPO running GeNS.NPPO Administrator: To manage the activities at the NPPO level (including adding Company to the system).Company Administrator: To manage the activities at a particular company (exporter) level.

Maintain Users list Create, Read, Update and Delete (CRUD)1 functionalities to manage user records

Send User validation mail

Functionality to validate user's email

Generate temporary password

Functionality to help new user to create a password of his/her choice after logging in for first time, using a temporary password.For Administrative user, it will also ask password reset security questions.

Modify User Password

Functionality delegated to user for changing the current password. For administrative users, it will also ask answers to security questions.

Assign roles to users

Functionality to assign roles to users. Assignment of roles are restricted based on role level of administrator (GeNS, NPPO, Company)

1 Create, Read, Update and Delete Operations in a system

Confidential - Client Page 8 of 34 26/09/2016

Page 9:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

Log In Functionality to validate users provided credentials and provide the session identity with assigned roles to access the system

Maintain national list of companies

CRUD functionalities to manage company records

Lookups Management Application module providing functionalities to maintain data lookups used by the system.

Maintain list of Countries

GeNS administrator CRUD operations to update the list of countries and indicate if it has a Plant Protection Organization and phytosanitary requirements

Maintain list of package types

GeNS administrator CRUD operations to update the list of packages types referenced in the ePhyto data entry

Maintain list of conveyance

GeNS administrator CRUD operations to update the list of conveyance types referenced in the ePhyto data entry (e.g.: boat, road, truck, rail…)

Maintain list of commodities

GeNS administrator CRUD operations to update the list of commodities referenced in the ePhyto data entry

Maintain list of Scientific Names

Automated process for downloading and updating the list from EPPO services

Maintain list of additional declarations standard texts

NPPO administrator CRUD operations to update the list of default additional declarations standard texts to help the ePhyto data entry

Maintain list of treatment types

GeNS administrator CRUD operations to update the list of treatment types referenced in the ePhyto data entry

Maintain list of active ingredients

GeNS administrator CRUD operations to update the list of chemicals referenced in the ePhyto treatments data entry

Maintain list of unit of measures

GeNS administrator CRUD operations to update the list of unit of measures referenced in the ePhyto data entry (Including concentration, temperature, dosage, duration…)

Maintain list of Partner Companies

Company Administrator CRUD operations to update the list of partner companies, his/her organization is trading with.

ePhyto Management Application module providing all functionalities for creating, opening receiving and sending ePhyto certificates. The authorization of any user to carry out these operations will depend on roles assigned to them.

Confidential - Client Page 9 of 34 26/09/2016

Page 10:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

Create ePhyto Functionality/wizard for creating an ePhyto draft compliant with the ISPM12 Appendix 1 document

Apply for Certification

Functionality for the company user to submit the draft ePhyto to the NPPO officers for review and issuance

Cancel pending Application

Functionality for the company user to cancel the draft ePhyto sent to the NPPO officers for review and issuance but not yet processed by the NPPO. The result will be a draft ePhyto

Edit ePhyto functionality to change the content of an ePhyto that is not issued or submitted to be issued by the NPPO

Delete draft ePhyto

Functionality to remove the draft ePhyto from the system

Search exporting certificates

Functionality to search for an ePhyto including dates, statuses, destination countries

View ePhyto Functionality to view the ePhytoReject ePhyto Functionality to allow the NPPO Officer to send the

ePhyto back to the Company UserIssue ePhyto Lock the ephyto and start the sending procedure using

the communication with the HUB. The GeNS will support both PULL and PUSH options.

Pull status of the ePhyto delivery

System internal process that pulls information from the HUB on the delivery status of the certificates

View ePhyto under delivery

System view for NPPO Officer to review the delivery status of the issued ePhyto

Re-issue ePhyto failed delivery

Functionality for the NPPO Officer to re-issue a certificate that failed the delivery

Create ePhyto as Copy

Functionality that can be used to speed up the data entry or to be used when changing the ePhyto for re-export. It will ensure the copy has new and unique identifier.

Cancel Issue ePhyto

Functionality to mark the issued ePhyto as cancelled and communicate the certificate through the HUB to the importing NPPO (if it was successfully delivered to the importing NPPO)

Receive certificates for import

System internal web service functionality to regularly receive certificates that are pending delivery, pushed from the HUB for the country NPPO (PUSH from HUB)

Pull certificates for import

System internal functionality to regularly import certificates that are pending delivery in the HUB for the country NPPO (PULL from HUB)

Search importing certificates

View and filter certificates for imported consignments received from the HUB

Confidential - Client Page 10 of 34 26/09/2016

Page 11:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

Print ePhyto System functionality to export the ePhyto into PDF/A to be paper printed

Usage dashboard Functionality to report usage indicators like (number of issued and received certificates during a defined period)

Pending Actions An area of screen to indicate if the user has any specific pending actions (such as Company user to view a rejected certificate or for an NPPO Officer to process a certificate application).

2.4 Design and Implementation Constraints

Description RationaleNFRQ-62 Data sent to the HUB by the GeNS

application is very sensitive and must be securely encrypted.

The data relates to trade between countries and thus, is highly confidential for each country. The service should be built in a manner that it is completely transparent and highly secure to provide assurance to countries about correct handling of their data. Following HUB Specification the communication will be done using Transport Layer Security (TLS- commonly referred to as SSL)

PCRQ-73 The system should be implemented operating system that is : Trusted, Maintainable, Patched and Supported by the Vendor

The underlying platform on top of which the HUB resides should prevent from security threats, maintainability and support issues

PCRQ-63 The system must be built in a form that can be deployed to country data centres without any additional changes (Standalone Mode)

if a country NPPO decide to implement the system on their premises for any technical or non-technical reason the application can be easily configured without the need of specific changes

NFRQ-65 Web application bandwidth and communication must be optimized to be used on a low bandwidth and satellite link

Some of the countries and companies office may not have a good internet connection. The system should optimize bandwidth consumption and client-server chattering

NFRQ-61 The GeNS application will communicate using the ePhyto HUB, no direct point to point specific connection will be implemented

The system should be de-coupled from the communication mechanisms

2.5 User DocumentationThe GeNS system should be embraced and implemented by countries and their offices and companies. Manuals of the GeNS should be technically completed and up to date, with 100% coverage of all the usage scenario and possible alternative flows.

The following products should be released:

Confidential - Client Page 11 of 34 26/09/2016

RAI Shashank, 23/09/16,
Highlight – system will only give a PDF/A document. Any special printing must be done by NPPO (security paper etc). This also implies that the PDF will be completely self-contained as an archive file.
Page 12:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

a) Manuals on using the GeNS system for each role

For the Pilot phase, these manuals will be released in ‘English’ language only. ICC should work to release the manuals in other languages subsequently.

2.6 Assumptions and DependenciesThe GeNS system will be developed to use the ePhyto HUB; thus, the assumption is that the HUB will be up and running at least for testing the communication before the development of the GeNS communication modules.

Confidential - Client Page 12 of 34 26/09/2016

RAI Shashank, 23/09/16,
Highlight and confirm. There were discussions for releasing initial documents in Spanish as well.
Page 13:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

3. External Interface Requirements

3.1 User Interfaces

This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will be designed using wireframes. However, the GeNS must follow these interface requirements:NFRQ-56: The system interface must allow for optional translationsNFRQ-64: The user interface must be compatible with the widest range of browser versions and operating systems. It should at minimum be compatible with three most commonly used web browsers as well as major desktop operating systems – MS Windows and Apple OSX.NFRQ-66: The User Interface must allow for Internationalization and Globalization. The system will be in English language for the pilot phase.NFRQ-67: Colours and eventual Symbols of the User interface should respect global cultural valuesNFRQ-68: The system user interface design will be consistentNFRQ-69: The system user interface must allow for keyboard navigation and shortcutsNFRQ-77: Subject to constrains NFRQ-65 (design for low bandwidth); the GeNS should have ‘responsive UI’.NFRQ-78: Subject to constrains of NFRQ-65 (design for low bandwidth); the GeNS should have a modern web-UI. A majority of users are already familiar with different web-applications (used for either personal or work purpose). Thus, a familiar layout (use of specific icons or placement of menu items) will reduce the learning effort and make adoption easier. The UI should:

Reduce the learning curve of a new user. Uses the vocabulary and knowledge of the user. Follow basic design principles: contrast (obviousness), repetition (consistency), alignment

(appearance), and proximity (grouping).Listed below are the main functional User Interface components:

- Common Area o Main View Port: main application responsive-area. Providing the main static

components for session context information and navigation of functionalities.o Login: Login form to authenticate and grant authorization to userso Reset Password: form to reset passwordo Modify Password: User contextual windows to change password, only available to

authenticated users.o Navigational Menu: Navigation menu to open modules and specific functionalities

based on the roles assigned to the authenticated usero Online Help: Static guide to help users in using the system

- Administrative Area o Users Management: list all users, based on the country and role assigned to the

authenticated administrator. Company administrators will only see users with the company user role of their company, NPPO Administrators will be able to see only user of their country. The view will be composed of predefined filters and visualizations and give a free text search tool to be able to quickly find users.

Confidential - Client Page 13 of 34 26/09/2016

RAI Shashank, 26/09/16,
Same issue as the User Manuals
Page 14:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

o Create/Edit User: Windows to create or modify an existing user. Based on the role of the authenticated user the roles that can be assigned will be filtered, as well as other information like company and country.

o Company Management: list and search for company records of the country. This view is available to NPPO Users

o Create/Edit Company Record: NPPO Officer will be able to create company records and assign them Company Administrators

- Lookups Management : Available to GeNS administrators and NPPO Administrators to optionally translate lookups in their specific language

o For each of the lookups the system must have a list/search interface to be able to view and open existing records and a Create/Edit window to perform modifications based on the assigned role :

Countries Package Types Conveyances Commodities Scientific Names Additional Declarations Treatment Types Active Ingredients Unit of Measures

o One look up for the Company Administrators to manage partner company information.

- ePhyto Management o ePhyto for Export: list and search for company/national ePhyto created in the system;

based on the role the system will filter the view, propose pre-compiled filters and visualizations as well as provide a free text search tool. The view will also show the delivery status (Pulled from the HUB) to mark ePhytos pending delivery or with delivery errors.

o Create/Edit ePhyto: Window to view, create or edit an ePhyto. Based on the role and status of the ePhyto, the system will provide editing functionalities and available workflow actions like Apply for certification, Cancel, Delete, Print, Issue, and Reject.

Additional windows will be used to drive the data entry (e.g.: adding additional declarations or treatments) and confirm user actions

o ePhyto for Import: list and search for national ePhyto received from the HUB. The system will filter the view based on the assigned country, propose pre-compiled filters and visualizations as well as provide a free text search tool.

o Pending Action – a part of the UI screen that shows any events that require user to take an action (such as NPPO Officer to act on certificate applications or company user to view rejected applications).

o Reporting dashboard: view with statistical indicators on the issued and received ePhyto certificates. The view may also contain a list of pre-build reports not yet defined.

Confidential - Client Page 14 of 34 26/09/2016

RAI Shashank, 26/09/16,
Discuss in La Plata meeting
Page 15:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

3.2 Hardware Interfaces

As a web-technology based application, the GeNS does not have any specific hardware requirements. Intend use of the application does not warrant any interfaces with specialised hardware such as bar-code scanners etc. The application will run on a modern server Operating System Platform; thus, supporting mainstream x86 hardware.

3.3 Software Interfaces

The GeNS system should be implemented using platform operating systems that are: Trusted, Maintainable, Patched and Supported by Vendors, this is to make sure that the underlying platform on top of which the GeNS resides should prevent from security threats, maintainability and support issues.The GeNS must also communicate with the ePhyto HUB, following the Web Service specification language (WSDL) and operating procedures defined by the HUB.

3.4 Communications Interfaces

The GeNS will communicate using HTTPS/TLS and SOAP protocol, using client and server X.509 certificates to authenticate over the secure channel.This also applies to the HUB’s “PUSH” web service to receive the ePhyto messages; where the GeNS will use a server TLS certificate.

Confidential - Client Page 15 of 34 26/09/2016

Page 16:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

4. System FeaturesNote: System features listed in this document are given a unique identifier (example NFRQ-15 below in section 4.1.3). These identifiers correspond to entries in a separate ICC internal document: ‘Traceability Matrix’. ICC will use the Traceability Matrix to track service development during the project. The identifiers have been left in this document for linking the Requirements document to this Matrix. Please refer to Appendix A: Glossary for further details.

4.1 User Authentication4.1.1 Description and PriorityUser access to the system will be verified by a set of credentials maintained by the user. The identity of the user is related to his/her email address, while the password will be generated for the first access (temporary password will expire in 24 hours) and immediately changed by the user upon accessing the system for the first time. Password will be kept secure using industry best practices (reference: OWASP2)4.1.2 Stimulus/Response SequencesThe user will access the GeNS website (standalone or central hosted) via the HTTPS protocol. The system will validate existing session and propose the login action window. At this point the user can invoke optionally the “Forgot Password” Procedure (defined below). If the user sends his/her credentials, the application will validate them (the password on the encryption basis) and if successful return the session identity completed with the assigned roles and country/company details. If the login is not successful the system will not grant access to the system, and issue a generic warning to the user about incorrect set of credentials.The result of the authentication will provide a valid identity to continue the system operations and therefore, giving the default viewport.

4.1.3 RequirementsNFRQ-15: The system must be able to work over HTTPS protecting the communication between clients and GeNS ServerFCRQ-16: The system must provide secure internal authenticationNFRQ-17: The system will securely store passwords for validation.NFRQ-70: The system must maintain access logPIRQ-55: The system could provide some password policy

4.2 Forgot Password4.2.1 Description and PriorityThe user can optionally ask the system to help in resetting the password. As part of on-boarding process, GeNS, NPPO and Company administrators will be required to set-up ‘security questions’. Password reset procedure will include providing correct answers to these questions.4.2.2 Stimulus/Response SequencesThe user can invoke the “Forgot Password” Procedure from the login page, as consequence of the failing login actions. The system will request the user to validate the registered mail and (for

2 https://www.owasp.org/index.php/Password_Storage_Cheat_Sheet

Confidential - Client Page 16 of 34 26/09/2016

Page 17:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

administrators) answer the security questions. An email will be generated and sent to the user. The user will validate the email, by following a unique web address. The system will generate a password and send it to the user’s email. The user will be able to login the system. The system will request to change the password immediately. Password policy controls may be applied. The system will provide the session identity context accordingly to allow the user to continue working.

4.2.3 RequirementsNFRQ-15: The system must be able to work over HTTPS protecting the communication between clients and GeNS ServerFCRQ-16: The system must provide secure internal authenticationNFRQ-17: The system will securely store passwords for validationFCRQ-18: The system will provide functionalities for re-setting the password using the user registered email for validating the identityFCRQ-19: The user should be able to modify the password in useNFRQ-20: All modifications to System's user accounts (including all roles) will be logged PIRQ-55: The system could provide some password policy

4.3 Modify Password4.3.1 Description and PriorityThe user can optionally change the password.4.3.2 Stimulus/Response SequencesThe system allows users to change their password, using a dedicated window. The user will need to insert the old password and confirm the new one. Password policy controls may be applied. The system will store the new password accordingly.

4.3.3 RequirementsNFRQ-15: The system must be able to work over HTTPS protecting the communication between clients and GeNS ServerFCRQ-16: The system must provide secure internal authenticationNFRQ-17: The system will securely store passwords for validationFCRQ-19: The user should be able to modify the password in useNFRQ-20: All modifications to System's user accounts (including all roles) will be logged PIRQ-55: The system could provide some password policy

4.4 Manage GeNS Users4.4.1 Description and PriorityThe system provides functionalities to insert, edit, remove and de-activate users based on the assigned administrative roles.4.4.2 Stimulus/Response SequencesThe GeNS Administrator can create a new user assigning the role of NPPO Administrator and providing the Country for which he/she will be the administrator.The system will send a welcome email message to the NPPO Administrator and also the procedure for re-setting the password. The temporary password will be provided via phone or SMS. As part of the

Confidential - Client Page 17 of 34 26/09/2016

Page 18:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

NPPO Administrator setup; the administrator will have to provide answer to ‘password reset’ security questions as well.The GeNS Administrator can open an existing NPPO Administrator, edit the email or any other information or disable the access.The NPPO Administrator can create new users for the country he/she is working on. Assign the following roles (NPPO Administrator, NPPO Officer, and Company Administrator). The Country will be inherited from the administrator context. The assignment of the Company Administrator role will need the selection of the relative company registered for the country, the system will propose the existing companies, as well the creation of a new Company (described below).The NPPO Administrator can open an existing NPPO user or Company Administrator, edit the information or disable the access.The Company Administrator will be able to create, view, edit and disable access of Company Users. The role, country, company of the created/modified user will be inherited from the Company Administrator.Users of the GeNS will be then administered by three different administrative roles at the level of respectively GeNS, NPPO and Company.

4.4.3 RequirementsPDRQ-6: GeNS Administrator must be able to configure the country to use the GeNS system (e.g.: insert the first NPPO Administrator). The configuration to interact with the HUB (PUSH/PULL) are setup by the GeNS administrator.PDRQ-7: GeNS NPPO Administrator must be able to configure and manage the access permissions and country configuration parametersPDRQ-8: Company Administrator manage and update the company details with the NPPO and manage the company usersPDRQ-10: NPPO Officers are the main users of the system having to deal with the review, approval and issuance of ePhytosNFRQ-20: All modifications to System's user accounts (including all roles) will be loggedFCRQ-33: The Country NPPO Administrator must be able to maintain the list of NPPO Officers and accountFCRQ-37: The Company administrator must be able to maintain the list of company users

4.5 Manage Companies4.5.1 Description and PriorityThe system provides functionalities for the NPPO administrator to insert, edit, remove and de-activate companies 4.5.2 Stimulus/Response SequencesThe NPPO Administrator can create, edit, and disable company records for the country he/she is working on. Assign the Company Administrator if already registered as user or create a new user using the functionalities described above.The system will store company information.

4.5.3 Requirements

Confidential - Client Page 18 of 34 26/09/2016

Page 19:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

PDRQ-8: Company Administrator manage and update the company details with the NPPO and manage the company usersFCRQ-34: The NPPO Administrator must be able to maintain the list of companies in the systemFCRQ-35: The NPPO administrator must be able to maintain only Companies registered under the NPPO CountryFCRQ-36: The NPPO Administrator must be able to register the Company AdministratorNFRQ-71: All modifications to Company records must be logged

4.6 Manage Lookups4.6.1 Description and PriorityThe system provides functionalities to insert, edit, and remove records used to facilitate data entry.4.6.2 Stimulus/Response SequencesThe GeNS administrator will be able to insert, edit, and remove entries used to support data entry like the following:

Countries Package Types Conveyances Commodities Scientific Names Additional Declarations templates Treatment Types Unit of Measures

Each of the lookup entities may have different set of attributes and source of information (e.g.: XML Schema, Excel). The GeNS administrator will be able to change the data without the need of a new system release.The GeNS Administrator and the NPPO Administrator will be able to translate entries in one of the available languages of the system. The system will provide such translated entries if the user switch the user interface language. If the entry is not translated the English version will be used.

The Company Administrator will be able to insert, edit and remove entries regarding the ‘partner’ companies; his/her company deals with as source or destination for import or export certificate. The Company Administrator will be able to insert partners companies with Country, Name, Addresses, Commodities, Contact Information.The system will store company information and relationships.

4.6.3 RequirementsFCRQ-21: The GeNS administrator must be able to administer all the "Master data" lookupsNFRQ-22: All modifications to System's lookups will be logged and versionedFCRQ-27: The system will provide functionalities to guide the Company User or the NPPO Officer through the preparation of the ePhytoFCRQ-32: The GeNS administrator must be able to configure the running parameters of the Country NPPOFCRQ-42: The Company User must be able to view and edit the relationship with other companies providing commodities for certification

Confidential - Client Page 19 of 34 26/09/2016

Page 20:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

FCRQ-43: The Company user must be able to maintain the list of approved sources by adding changing and deleting importer recordsPIRQ-54: The system could have a functionality for NPPO administrator to translate lookups in the original languageNFRQ-71: All modifications to Company records must be logged

4.7 Create ePhyto4.7.1 Description and PriorityThe system provides functionalities to create ePhyto certificates providing user guided data entry windows in line with the ISPM12 Appendix 1 definition.4.7.2 Stimulus/Response SequencesThe Company User can create a new ePhyto draft using the functionalities exposed in the ePhyto management views. The system will automatically populate fields pertaining to the user context (e.g.: Country, Exporting Company) and propose where applicable lookups entries (searchable drop down lists) to enter the information of the ePhyto. The interface will have all the sections of the certificate as specified in the ISPM12 Appendix 1, store the information in the system in order to facilitate searches, reports, printing and creation of the required electronic format to be sent through the HUB. With each new ePhyto, the system will create draft records. Draft ePhyto can be removed or sent to the NPPO Officer using the Apply action described below.This exact feature is also available for NPPO Officer. The system will allow the NPPO Officer to select any company and prepare the certificate on their behalf.The system will also allow to create an ePhyto certificate as a copy of an existing record. The certificate will be refreshed in the status, dates and created as a new one.

4.7.3 RequirementsPDRQ-1: Data entry for export certificationPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytosFCRQ-23: The system must allow for the preparation of the ePhyto certificateNFRQ-24: The system will log all modifications of the certificateFCRQ-27: The system will provide functionalities to guide the Company User or the NPPO Officer through the preparation of the ePhytoFCRQ-30: The system will allow Company Users to see certificates pertaining only to their companyFCRQ-39: The system must provide Company Users the functionalities to create ePhyto certificatesFCRQ-44: The NPPO Officer must be able to create an ePhyto application on behalf of a CompanyFCRQ-57: The system should propose existing records of exporters and (optionally) consignees in the ePhyto input fieldsFCRQ-59: The ePhyto packages will be multi entry defined by the quantity type and a set of distinguishing marksFCRQ-60: The ePhyto must follow the ISPM12 Appendix 1 definitionFCRQ-74: The system must allow Company Users and NPPO Officers to create a new certificate as copy

4.8 Apply for Certificate

Confidential - Client Page 20 of 34 26/09/2016

Page 21:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

4.8.1 Description and PriorityThe system provides functionalities to submit the ePhyto certificates to the NPPO Officers for their review and subsequent issuance.4.8.2 Stimulus/Response SequencesThe Company User can find and open an ePhyto draft using the functionalities exposed in the ePhyto management views. The Company User can “Apply” for the certificate issuance. The system will perform data validation, store modification and lock the editing of the certificate, change the status to Pending Review and log all the actions. The system will notify the action to the relative Country NPPO Officers. The Company User can optionally revert the action by cancelling the application, the system will change back the status to draft and allow editing and re-submit of the application.This exact feature is also available for NPPO Officer. The system will allow the NPPO Officer to apply for the certificate as if he/she is the original document creator.

4.8.3 RequirementsPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytosNFRQ-24: The system will log all modifications of the certificateFCRQ-28: The Company user must be able to apply for the certificateFCRQ-29: The Company user must be able cancel the application that is pending NPPO reviewFCRQ-30: The system will allow Company Users to see certificates pertaining only to their companyFCRQ-40: The system must provide Company Users functionalities to search and view all certificates that have been entered for the CompanyFCRQ-41: The NPPO Officer must be able to cancel a pending certificateFCRQ-57: The system should propose existing records of exporters and (optionally) consignees in the ePhyto input fieldsFCRQ-59: The ePhyto packages will be multi entry defined by the quantity type and a set of distinguishing marksFCRQ-60: The ePhyto must follow the ISPM12 Appendix 1 definition

4.9 Issue ePhyto Certificate4.9.1 Description and PriorityThe system provides functionalities to search, view, edit, reject or issue ePhyto certificates.4.9.2 Stimulus/Response SequencesThe NPPO Officer can look for and open a pending ePhyto using the functionalities exposed in the ePhyto management views. The NPPO Officer can view and edit (including adding the necessary administrative information) the ePhyto and can either:

‘save as draft’ issue mark ‘changes required’ or reject

the certificate. Once the NPPO Officer edits or takes any action on an ePhyto certificate, the applying company cannot modify or withdraw it, unless ‘released’ by the same NPPO Officer or NPPO Administrator.

Confidential - Client Page 21 of 34 26/09/2016

RAI Shashank, 26/09/16,
Confirm- can the company still withdraw application?
Page 22:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

In case of ‘save as draft’, the system will lock the certificate and only allow the same NPPO Officer (or NPPO Administrator) to update it and take further action.In case of ‘Issuance’, the system will perform data validation, store any modifications and queue the certificate for delivery to the HUB. In case certificate is marked as ‘changes required’, the system will change the status of the certificate as ‘Changes required’. The original applicant (which can be Company User or another NPPO Officer), will get a notification. He/she can log into the system to make necessary changes to this certificate. In case of ‘Rejection’, the original applicant will get a message (email) that the certificate has been rejected.The sending of the ePhyto to the HUB will follow HUB specifications and related WSDL. The delivering status of the ePhyto will be monitored through the HUB services (see Re-Issue of delivery failed certificates below).

4.9.3 RequirementsPDRQ-3: Issuance/authorization of an ePhytoPDRQ-4: Sending and receiving ePhytoPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytosNFRQ-24: The system will log all modifications of the certificateFCRQ-45: The NPPO Officer must be able to work on the certificate and amend it before issuingFCRQ-46: The NPPO Officer must be able to reject the certificate and send it back to be amended by the Company userFCRQ-50: The NPPO Officer must be able to issue the certificate, sending it to the HUB for deliveryFCRQ-57: The system should propose existing records of exporters and (optionally) consignees in the ePhyto input fieldsFCRQ-59: The ePhyto packages will be multi entry defined by the quantity type and a set of distinguishing marksFCRQ-60: The ePhyto must follow the ISPM12 Appendix 1 definition

4.10 Re-Issue ePhyto Certificate4.10.1 Description and PriorityThe system provides functionalities to view delivery failed certificates, open the document and re-issue it.4.10.2 Stimulus/Response SequencesThe NPPO Officer can find and open certificate with a ‘delivery failed’ status using the functionalities exposed in the ePhyto management views. The system will expose the same functionalities and workflow described in the 4.9 Issue ePhyto Certificate feature.The delivery status of the certificates is periodically pulled from the HUB; which marks certificates that have reached the retry threshold (queue expiration time) configured for the destination NPPO as ‘delivery failed’.

4.10.3 RequirementsPDRQ-3: Issuance/authorization of an ePhytoPDRQ-4: Sending and receiving ePhytoPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytosNFRQ-24: The system will log all modifications of the certificate

Confidential - Client Page 22 of 34 26/09/2016

Page 23:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

FCRQ-45: The NPPO Officer must be able to work on the certificate and amend it before issuingFCRQ-46: The NPPO Officer must be able to reject the certificate and send it back to be amended by the Company userFCRQ-50: The NPPO Officer must be able to issue the certificate, sending it to the HUB for deliveryFCRQ-51: The NPPO Officer must be able to view the status of the delivery

4.11 Cancel ePhyto Certificate4.11.1 Description and PriorityThe system provides functionalities to view issued certificates, open the document and cancel it.4.11.2 Stimulus/Response SequencesThe NPPO Officer can find and open a certificate that has been issued using the functionalities exposed in the ePhyto management views. The NPPO Inspector can cancel the Issued ePhyto, also providing a reason for his/her decision. The system will update the ePhyto status as cancelled. The cancellation of the Issued ePhyto will be communicated to the destination NPPO if the certificate has already been delivered. The system will store all modifications and allow only the creation of a new certificate as copy.

4.11.3 RequirementsPDRQ-4: Sending and receiving ePhytoPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytosNFRQ-24: The system will log all modifications of the certificateFCRQ-47: The NPPO Officer must be able to search and view issued certificatesFCRQ-52: The NPPO Officer must be able to cancel an issued certificate

4.12 View Import Certificates4.12.1 Description and PriorityThe system provides functionalities to view received certificates for import (and its status), open the document and print it.4.12.2 Stimulus/Response SequencesThe NPPO Officer can search and find all received ePhyto certificates using the functionalities exposed in the ePhyto management. The NPPO Officer can open the Received ePhyto and print it (see 4.13). The system will regularly pull or receive through push, import consignments certificates updating the status of certificated that are eventually cancelled from the NPPO of origin.

4.12.3 RequirementsPDRQ-4: Sending and receiving ePhytoPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytosFCRQ-48: The NPPO Officer must be able to search and view certificates for imported consignmentsFCRQ-49: The system will pull certificates for import from the HUB on a regular basis

4.13 Print ePhyto Certificate

Confidential - Client Page 23 of 34 26/09/2016

RAI Shashank, 26/09/16,
Confirm in meeting: The company users/admins do not see import certificates addressed to them.
Page 24:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

4.13.1 Description and PriorityThe system provides functionalities to export the ePhyto certificate in PDF/A format to be able to send it to the printer, store and send paper and digital version of the compiled document. 4.13.2 Stimulus/Response SequencesThe NPPO Officer can open the ePhyto and select to print the document. The system will produce a PDF/A version of the document using an abstract template that will allow for further changes of format, fields inclusion without the need of releasing a new version of the system.

4.13.3 RequirementsPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytosFCRQ-25: The system must allow for printing the certificate to be able to include the paper format to the exporting documentsNFRQ-26: The system should implement the printing functionality using templates that can eventually be modified by the Country NPPO to address their formatting needsFCRQ-60: The ePhyto must follow the ISPM12 Appendix 1 definition

4.14 Archive Import Certificate4.14.1 Description and PriorityThe system provides functionalities to view received certificates for import, open and or archive them.4.14.2 Stimulus/Response SequencesThe NPPO Officer can search and find all the ePhyto certificates received by the country, using the functionalities exposed in the ePhyto management. The NPPO Officer can open the Received ePhyto and in addition to the rest of the functionalities can mark the document as Archived. The system will store the change in status of the certificate and move it from default to archived views to reduce the working document list. The reverse operation should also be feasible (moving from archived to default working area).

4.14.3 RequirementsPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytosFCRQ-48: The NPPO Officer must be able to search and view certificates for imported consignmentsFCRQ-72: The NPPO Officer must be able to archive the received certificate for imported consignment

4.15 View Usage Statistics4.15.1 Description and PriorityThe system provides functionalities to view information related to number of certificates by type (import/export) company, partner country, status, commodity and time frame.4.15.2 Stimulus/Response SequencesThe NPPO Officer will be able to export statistical data from the system in the excel format (CSV). Such exports can be further used to prepare ad-hoc reports.

4.15.3 RequirementsPDRQ-5: Storing, Viewing, Reporting and Printing of the sent and received ePhytos

Confidential - Client Page 24 of 34 26/09/2016

RAI Shashank, 26/09/16,
Question: Do Company Admins get access to usage statistics pertaining to their company?
RAI Shashank, 26/09/16,
Consider ‘bulk’ printing- selecting multiple certificates and exporting as PDF/A files for next version.
Page 25:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

FCRQ-53: The NPPO Officer must be able to run reports on number of certificates issues and received

Confidential - Client Page 25 of 34 26/09/2016

Page 26:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

5. Other Non-functional Requirements5.1 Performance RequirementsThe system response time must be in average with any standard web application keeping the usability of the system in line with the following definition:0.1 second is about the limit for having the user feel that the system is reacting instantaneously, meaning that no special feedback is necessary except to display the result.1 second is about the limit for the user's flow of thought to stay uninterrupted, even though the user will notice the delay. Normally, no special feedback is necessary during delays of more than 0.1 but less than 1.0 second, but the user does lose the feeling of operating directly on the data.10 seconds is about the limit for keeping the user's attention focused on the dialogue. For longer delays, users will want to perform other tasks while waiting for the computer to finish, so they should be given feedback indicating when the computer expects to be done. Feedback during the delay is especially important if the response time is likely to be highly variable, since users will then not know what to expect.

Some actions in the system will be asynchronously executed (e.g. HUB communication), in such cases the system will be responding immediately.

Additional reported requirements:

Description RationaleNFRQ-65 Web application bandwidth and

communication must be optimized to be used on a low bandwidth and satellite link

Some of the countries and companies office may not have a good internet connection. The system should optimize bandwidth consumption and client-server chattering

NFRQ-79 Subject to cost-benefit analysis, use of Content Delivery Network (CDN) should be considered

CDN allow content from websites to be delivered to end-users from servers closet to users’ geographic location; thus, improving the overall user perception of system performance.

Number of NPPOs using GeNS (Central Mode):Pilot 3

From Go-live (BaU) to next 1 year 9 (6 new NPPOs in additional to the 3 above)

Number of Users using GeNS (Central Mode):The system should be sized for following order of magnitude estimate on number of users. As the service progresses, based on the expansion, the system size should be adjusted.Pilot Phase:

User Type # Estimates

NPPO Administrators 5NPPO Officers 10

Company Administrators 50-150

Confidential - Client Page 26 of 34 26/09/2016

Page 27:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

Company Users 100-300From Go-live (BaU) to next 1 year:

User Type # Estimates

NPPO Administrators 15NPPO Officers 30

Company Administrators 150-450

Company Users 300-900

System Scalability and Architecture:As it is difficult to build the GeNS user growth and utilization model, the underlying technology stack for the GeNS system should allow for very easy horizontal and vertical scaling. The system should use modern application technology stacks (and frameworks), which provide these functionalities inherently without any code re-write or database re-design.

5.2 Safety RequirementsNo safety requirements are identified that are not covered in the Security Requirements here below.

5.3 Security RequirementsThe primary security constrain is that all NPPO data (ephyto certificates, internal company information) should be secure. Furthermore, this data can be subject to various national data protection legislations (e.g. if any European Union country were to use GeNS, the personally identifiable information of the users’ needs to be kept secure in-line with EU regulations).

Data Security during processing: ICC will ensure that the GeNS application, as part of processing, storing and transferring all data, handles all sensitive information to meet the primary security constrain; particularly the details of ePhyto certificates.

ICT operations access to the GeNS (Central Hosted Mode): ICC will ensure that all access to the GeNS system is adequately logged and monitored; including access at application developer/maintainer, Operating System, database and network levels. ICC will operate the service in compliance with internationally accepted security standard ISO 27001.

Description Rationale

NFRQ-62

Data processed, stored and transmitted by the GeNS application is very sensitive and must be adequately protected.

The data relates to trade between countries and thus, is highly confidential for each country. The service should be built in a manner that it is completely transparent and highly secure to provide assurance to countries about correct handling of their data.

NFRQ- The system must be able to work over

Confidential - Client Page 27 of 34 26/09/2016

Page 28:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

15 HTTPS protecting the communication between clients and GeNS Server

NFRQ-16

The system must provide secure internal authentication

The system will store credentials internally. The authentication and identity management will be implemented in the system, providing ad-hoc security measures, in line with OWASP recommendations and tools

NFRQ-17

The system will securely store passwords for validation

The system will not store the password in clear text

NFRQ-12

The system will allow NPPO to view and report on certificates issued or delivered only by the NPPO

NPPO’s should not be able to view certificates that do not pertain to their country.

NFRQ-75

The system should protect stored sensitive information of each country

The system should prevent from running reports or viewing sensitive information of un-authorized persons including platform and system's administrators

NFRQ-76

The use of GeNS service should not make any changes on the Users’ Personal Computer (PC); except when storing PDF files or saving different reports/ exports from the system.

NFRQ-45

The service should be given adequate security to protect it from being hacked or misused

Provide application level security:(*) Application code audit and use of application development best practices (prevent OWASP Top 10, SANS top 25 software errors)(*) Use of a Web Application firewallProvide Network level security:(*) Use of network level firewall and multi zone network.(*) Use of Intrusion detection systemProvide server level security:(*) use of anti-malware tools on server(*) ‘host hardening’ of bastion serversData Security:(*) Only very limited set of operational team will have capability to view data and applications.(*) Each access to system will be logged and an alert generated. The alert will be send to non-operational service manager.

Confidential - Client Page 28 of 34 26/09/2016

Page 29:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

5.4 Software Quality AttributesThe software should satisfy all the requirements defined in this document. The development of the application will also follow a quality plan that will include, unit, functional, and regression tests, as well as User Acceptance Tests of each single deliverable functionality/component.Some of the requirements that should be considered as key indicators are reported below:

Description RationaleNFRQ-65 Web application bandwidth and

communication must be optimized to be used on a low bandwidth and satellite link

Some of the countries and companies office may not have a good internet connection. The system should optimize bandwidth consumption and client-server chattering

NFRQ-62 Data sent to the HUB by the GeNS application is very sensitive and must be securely encrypted.

The data relates to trade between countries and thus, is highly confidential for each country. The service should be built in a manner that it is completely transparent and highly secure to provide assurance to countries about correct handling of their data. Following HUB Specification the communication will be done using Secure Socket Layer

PCRQ-63 The system must be built in a form that can be deployed to country data centres without any additional changes

if a country NPPO decide to implement the system on their premises for any technical or non-technical reason the application can be easily configured without the need of specific changes

FCRQ-60 The ePhyto must follow the ISPM12 Appendix 1 definition

The system will provide tools to produce the ePhyto in line with the agreed standard

5.5 Availability RequirementsThe system will be designed with 99% availability. This implies that the GeNS hosted at the ICC data centres can have approximately 3 days of unscheduled downtime within one calendar year.

The target availability for the Business As Usual (BaU) phase will be 99.5%; which implies that the GeNS can have approximately 44 hours of unscheduled downtime within one calendar year. Based on the experience during the Pilot phase, this can be modified.IPPC and ICC will work towards improving this metrics as part of regular service optimization.

5.6 Data Life-cycle RequirementsThe audit logs and ePhyto certificates can be stored perpetually within the GeNS system. Depending on the usage and system data growth, this decision can be revisited.

System Back-ups: For the purpose of meeting Service Availability metrics, ICC will maintain back-up copies of the live system and its data. This implies that all the information residing in the system will get backed up. All backup shall be kept in ICC datacentres (under UN jurisdiction). The backup will be kept for the duration listed below:

Confidential - Client Page 29 of 34 26/09/2016

Page 30:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

Backup schedule Backup retentionDaily backups 1 weekWeekly backups 4 weeksMonthly backups 12 months

5.7 Business RulesThere are no business rules that are not covered in the Design & Implementation Constraints.

Confidential - Client Page 30 of 34 26/09/2016

Page 31:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

6. Other RequirementsDescription Rationale

PDRQ-2 Defined exchange mechanism and a standardized UN/CEFACT schema

The system must comply with the defined standards in terms of exchange mechanism and data definition

PDRQ-11

Other Authorized users should be able to view information and input supporting documents

The system should give Basic NPPO user the ability to list existing applications add comments with attachments

PIRQ-13

For countries that can provide required ICT infrastructure, the GeNS should be designed so that in can be deployed in 'Standalone' mode in these countries.

PIRQ-14

The development of changes and fixes to the application will be published and available within the system for automatic update

To give countries hosting the GeNS the option to update their version

PCRQ-80

Use technology stack that does not incur high licensing fee

Keep the cost of solution at minimum for IPPC as well as for NPPOs deploying in 'standalone' mode

PCRQ-81

The system should be designed to run multiple tenants securely, on single solution stack. This will ensure that the total cost of the solution is low.

This will avoid deploying a dedicated instance of the system on per NPPO basis.

Confidential - Client Page 31 of 34 26/09/2016

Gianluca Nuzzo, 22/09/16,
Need clarifications on the scope of the basic user
RAI Shashank, 26/09/16,
Reference: GeNS presentation slide 6 (NPPO Roles)
Page 32:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

7. Appendix A: GlossaryNPPO: National Plant Protection OrganizationCRUD: Create, Read, Update and Delete operations

Requirement type prefixes:Code Name Description ExamplesFCRQ Functional the fundamental or essential subject matter

of the product and are measured by concrete means like data values, decision-making logic and algorithms

The Scope of the WorkThe Scope of the ProductFunctional and Data Requirements

NFRQ Non-Functional Are behavioural properties that the specified functions must have, such as performance, usability, etc. Non-functional requirements can be assigned a specific measurement.

Look and Feel RequirementsUsability and Humanity RequirementsPerformance RequirementsOperational RequirementsMaintainability and Support RequirementsSecurity RequirementsCultural and Political RequirementsLegal Requirements

PCRQ Project constraints Identify how the eventual product must fit into the world. For example the product might have to interface with or use some existing hardware, software or business practice, or it might have to fit within a defined budget or be ready by a defined date

Mandated ConstraintsNaming Conventions and DefinitionsRelevant Facts and Assumptions

PDRQ Project drivers Are the business- related forces. For example the purpose of the project is a project driver, as are all of the stakeholders – each for different reasons

The Purpose of the ProjectClient, Customer and other StakeholdersUsers of the Product

PIRQ Project Issues Define the conditions under which the project will be done. Our reason for including these as part of the requirements is to present a coherent picture of all the factors that contribute to the success or failure of the project and to illustrate how managers can use requirements as input to managing a project

Open IssuesOff-the-Shelf SolutionsNew ProblemsTasksCutoverRisksCostsUser Documentation and TrainingWaiting RoomIdeas for Solutions

Confidential - Client Page 32 of 34 26/09/2016

Page 33:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

8. Appendix B: Analysis Models

Confidential - Client Page 33 of 34 26/09/2016

Page 34:  · Web viewUser Interfaces. This document does not drill down in to the specific layout and colours for the user interface (UI). If a new system is implemented, then the UI will

Service Requirements Specifications (Version 0.1Draft)

Appendix C: To Be Determined List<Collect a numbered list of the TBD (to be determined) references that remain in the SRS so they can be tracked to closure.>

Confidential - Client Page 34 of 34 26/09/2016


Recommended