Innova Drilling & Intervention
  • Introduction to Innova Documentation
    • Documentation Updates
  • Promotional Info & Software Overview
    • Feature Updates
      • Well Seeker Pro - BGGM Error Estimate Integration
      • Well Seeker Pro - Superior QC Integration
      • Innova App & Portal - Feature Update
    • Promotional Info
      • Innova App & Web Portal
      • Innova Technical Specification
  • Generic Documents
    • Innova Generic Documents
      • Innova Software Licensing
      • License Renewal
      • Installing Updates
  • Quick Start Guides
    • Well Seeker X Guides
      • Well Seeker X: Transition Guide
      • Well Seeker X: Installation Guide
      • Well Seeker X: How To Guide
      • Well Seeker X: Backing up a WS Db
      • Well Seeker X: Changing Datum Elevations
      • Well Seeker X: Adding an IPM
      • Well Seeker X: Local Login Guide
      • Well Seeker X: Project Ahead Guide
      • Well Seeker X: Survey Correction Integration Guide
      • Updating Well Seeker X
      • Well Seeker X: Job Startup Procedure
      • Well Seeker X: Sidetrack Guide
  • Well Seeker Pro Guides
    • Installation Guide
    • How To Guide
    • Sidetrack Guide
    • Project Ahead Guide
    • Recommended Job Startup Procedure
    • Adding A New CRS
    • Adding an IPM How To Guide
    • Backing Up A Well Seeker Database
    • Changing Datum Elevation
    • Compass Export Files & Db Naming Conventions
    • Compass IPM Issues
    • Downlink Control User Guide
    • Frequently Asked Questions
    • Geomag Model Installation Guide
    • Inclination Only IPM Guidelines
    • Innova Remote Client Setup Guide
    • Oasis Integration Guide
    • Printing A Wall Plot To PDF
    • Remote Client How to Guide
    • Rig States Guide
    • Solo Cloud Integration Guide
    • Survey Correction Integration Guide
    • Toolbars How To Guide
    • Tool Orders User Guide
    • Well Analytics How to Guide
    • WITS Setup & Remote Directional Drilling
    • Tool Rental Run Tracking Guide
    • Certified Survey Reports How To Guide
  • Innova Engineering Guides
    • Installation Guide
    • Hydraulics Module Quick Start Guide
    • Torque & Drag Quick Start Guide
    • Apparent WOB Chart
    • Casing Standoff Quick Start Guide
    • Casing Wear Prediction
    • Cementing How To Guide
    • Drill Pipe Fatigue Plot
    • Hole Cleaning Guide
    • Jar Placement Guide
    • QAQC SCC & MSA
    • SAG Quick Start Guide
  • Remote Database Guides
    • Creating an AWS Database
    • Creating an Azure Database
    • Managing an AWS Database
  • App & Portal Guides
    • Automated Bit Grading Guide
    • Oasis Integration Guide
    • Providing 3rd Party Access to Your Organizations Server Data
    • Web Portal Data Acquisition and EDR Guide
    • Web Portal Engineering Quick Start Guide
    • Web Portal - MFA Guide
  • Innova ICP API Guides
    • Registering an OAuth App on Azure
    • Registering an OAuth App on Okta
  • Manuals
  • Well Seeker Pro Manual
    • 1.0 - System Requirements
    • 2.0 - End User License Agreement
    • 3.0 - Software Overview
    • 4.0 - Getting Started
    • 5.0 - Main User Interface
    • 6.0 - Main Menu
      • 6.1 - File Menu
      • 6.2 – Edit Menu
      • 6.3 - View Menu
      • 6.4 - Tools Menu
      • 6.5 – Reports Menu
      • 6.6 - Plots Menu
      • 6.7 - Chart Properties
      • 6.8 - Context Menu
      • 6.9 - Windows Menu
      • 6.10 - Help Menu
    • 7.0 - Database Navigator
    • 8.0 - Well Seeker PRO Database Structure
    • 9.0 - Survey View
    • 10.0 - Plan View
    • 11.0 - Targets
    • 12.0 - Charts
    • 13.0 - Reporting
      • 13.1 - Activity Codes
      • 13.2 - Cost Codes
      • 13.3 - Phase Codes
      • 13.4– Daily Reporting
      • 13.5 – Drill String Editor
      • 13.6 - Tool Inventory
      • 13.7 – Shipping Addresses
      • 13.8 – Shipping Ticket
      • 13.9 – Pipe Tally
      • 13.10 – Slide Sheet
      • 13.11 – Directional Drilling Dashboard
      • 13.12 – Well Analytics
      • 13.13 – AFE Plan Designer
      • 13.14 – Daily Activity Editor
      • 13.15 – Create Bid Sheet
      • 13.16 – Export Reporting Data
      • 13.17 – Import Reporting Data
      • 13.18 – Transfer Reporting Data
      • 13.19 – In Zone %
      • 13.20 – Recover Slide Sheet from DDR
      • 13.21 – Tool Orders
    • 14.0 - Well Analytics
    • 15.0 - AFE Plan Designer
    • Appendix A – Software Licensing
    • Appendix B - Nomenclature
    • Appendix C - Acknowledgements
    • Appendix D – Error Model Description
    • Appendix E – Drill String Editor Component Properties
    • Appendix F–Slide Sheet Column Options
  • Innova Engineering Manual
    • System Requirements
    • End User License Agreement
    • 1.0 - Software Overview
    • 2.0 - Getting Started
    • 3.0 – Main User interface
    • 4.0 - Menus
    • 5.0 - Toolbars
    • 6.0 – Drill String, Well Geometry and Fluids Tab
    • 7.0 - Surveys Tab
    • 8.0 – Engineering Parameters Tab
    • 9.0 – Drilling Data Tab
    • 10.0 - Cementing Tab
    • 11.0 - Chart Results
    • 12.0 - Table Results
    • Appendix A – Software Licensing
    • Appendix B – Nomenclature
    • Appendix C – Axial and Cross Axial Magnetic Correction
    • Appendix D – Pole Strengths
    • Appendix E – Component Details
  • Innova App Manual
    • 1.0 - Introduction
    • 2.0 - App Installation
    • 3.0 - Logging In
    • 4.0 - Menus
    • 5.0 - Wells
    • 6.0 - Logistics
    • 7.0 - Analytics
    • 8.0 - Innova Admin
    • 9.0 – Well Seeker Admin
    • 10.0 - User Management
    • Appendix A – Setting Up A New User
    • 12 User Management
  • Web Portal Manual
    • 1.0 - Login
    • 3.0 - Main Interface
    • 4.0 - Wells List
    • 5.0 - Object Explorer
    • 6.0 - Well Views
      • 6.1 - Well Details
      • 6.3 - Anti Collision
      • 6.4 - Daily Reports
      • 6.5 - Inventory
      • 6.12 - Engineering Dashboard
    • 7.0 - Multiwell Dashboard
    • 9.0 - Logistics
    • 10.0 - Analytics
    • 11.0 - Database Admin Tools
      • 11.3 - Rig Names
      • 11.7 - Personnel Names
      • 11.9 - Audit Data
    • 13.0 - Error Models
    • 14.0 - Tool Orders
    • 17.0 - Data Acquisition
    • 19.0 - User Management
  • Release Notes
    • Well Seeker Pro Release Notes
    • Innova Engineering Release Notes
  • Video Guides
    • How To Videos
      • Well Seeker Pro
        • Getting Started
          • How to Install WSP
          • WSP Licensing
          • User Interface Overview
          • How to Backup a WSP Database
          • Database Tree Overview
          • Setup Files
          • Entering a Well Plan from a PDF
          • Slot Templates
          • Targets
          • How To Customize Toolbars
          • Depth Reference Change
          • Unit Sets
          • IPM File Management
          • Well Seeker Pro Update Feature
          • WSP - Company Specific Install File
        • Import / Export
          • Importing a Compass Export File
          • Exporting and Importing
        • Plots
          • Introduction to Plots
          • 3D Plot
        • Project Ahead - Multi-Nudge Tool
          • Project Ahead - Multi Nudge Tool
          • Update to Multi-Nudge Dialog
        • Anti-Collision Introduction
        • Tools
          • Geomagnetics Calculator
          • Motor Yield Calculator
          • Interpolate Dialog
          • Innova RSS Remote Client
          • RSS Downlink Control
          • Remote Data Fetch
        • Daily Reporting
          • Daily Reporting
          • Slide Sheets
          • Component Catalogue
          • Daily Activity Editor
          • Check Daily Activity Against Slide Sheet
          • DD Dashboard Introduction
          • WITS Setup
          • MWD Reporting
          • Rig States - Oscillating while Sliding
          • Choosing Phase and Activity Codes
          • Daily Reporting QA & QC
          • Recover Slide Sheet from DDR
        • Wall Plot Composer
        • Innova Remote Client
        • Downlink Control
        • Print Invoice Date Range
        • Reporting an Issue
      • Innova Engineering
        • Getting Started
          • Creating a BHA
          • Installation
          • License Files
          • User Interface Overview
          • Torque & Drag Setup
          • Hydraulics Setup
          • Reports
          • Drilling Data
          • Charts
        • Survey Correction
          • Short Collar Correction (SCC)
          • SAG
        • Engineering Tools
          • Quick Bit Hydraulics
          • Pump Data
          • Mud Calculations
          • Pipe Length Calculator
          • Component Catalogue
          • Interpolate
          • Fluid Library
          • Temperature Gradient
          • Tubular Properties Calculator
        • BHA Analysis
          • BHA Analysis
          • BHA Sensitivity Analysis
        • Casing Standoff
        • Back Calculate Friction Factors
      • Innova App
        • Innova App - Installation and Login
        • Innova App - Wells Page
        • Innova App - Well Data
        • Innova App - Side Menu
        • Innova App - User Management
        • Innova App - Analytics
        • Innova App - Logistics
        • Innova App - Chart Settings
      • Web Portal
        • Web Portal - Login
        • Web Portal - User Management
        • Web Portal - Changing Your Password
        • Web Portal - Analytics
        • Web Portal - Bulk Edit
    • Innova Online Training
      • Well Seeker Pro
        • 01 - Well Seeker Pro Introduction
        • 02 - Well Seeker Pro Database Tree Overview
        • 03 - Well Seeker Pro Database Backup and Export Files
        • 04 - Well Seeker Pro Well Planning Introduction
        • 05 - Well Seeker Pro Introduction to Anti Collision
        • 06 - Well Seeker Pro Directional Drilling Tools
        • 07 - Well Seeker Pro Daily Reporting Job Setup
        • 08 - Well Seeker Pro Daily Reporting Operations
        • 09 - Well Seeker Pro Daily Reporting End of Well
        • 10 - Well Seeker Pro Well Analytics
        • 11 - Well Seeker Pro Chart Properties
        • 12 - Well Seeker Pro Server Db Ops Video Part 1
          • 12 - Db Ops Part 1 - w/ RT Data Exchange
          • 12 - Db Ops Part 1 - w/ Data Synchronization
        • 13 - Well Seeker Pro Server Db Ops Video Part 2
        • 14 - Well Seeker Pro WITS WITSML Functionality
        • 15 - Well Seeker Pro Directional Drilling Dashboard
      • Innova Engineering
        • 01 - Innova Engineering Introduction
        • 02 - Innova Engineering Hydraulics
        • 03 - Innova Engineering Torque and Drag
        • 04 - Innova Engineering Charts & Reports
        • 05 - SCC and Magnetic Interference
        • 06 - SAG Correction
  • Technical Notes
    • High Priority
      • WS 3D Plot Issues
      • Check for Update Function
      • Data Synchronization Feature Update
      • Products & Features and User Permissions Update
      • WS 3D Chart C2C Distance Critical Update
      • Critical update for Anti-Collision in Inc Only Wells
    • Medium Priority
      • Slide Sheet Overwrite Issue
    • Low Priority
      • AC Report vs RTAC Dialog
      • Build Turn Planning Method From Vertical
      • Data Fetch Update
      • EDM Import Function Update
      • Excel Report Printing Error
      • Force Layout Reset
      • Hardware Malfunction casuing WITS related error
      • Inclination Only IPMs Sensitivity to Zero Inclination
      • IPM File Management
      • Large Well Seeker Database
      • Login Credential Management Change
      • Missing MFPlat.DLL Error
      • Missing MFC140U.DLL Error
      • Missing Microsoft Edge Update
      • Missing SQL Driver
      • Offset Selector - C2C Global Scan
      • Remote Data Fetch Icons Missing
      • Remote Data Fetch Procedural Recommendations
      • Sidetrack Reporting
      • Survey Tool BGS integration
      • Target Line Dip Angle Adjusted For Azimuth Changes
      • Third Party Survey Correction Integration
      • Troubleshooting Anti-Collision
      • Update to Multi-Nudge Projection Dialog
      • Up/Down discrepancies with Target Line Changes in 3D Laterals
      • Unit Set File Format Updated
      • Well Seeker X Failure to Open
      • Well Seeker Pro Import Function Update
      • Well Seeker Pro Change to UD LR Logic at low inclination
      • Error Ellipses at Sidetrack Depth – Well Seeker vs Compass Comparison
      • Well Seeker Pro CRS Updated Functionality
      • Well Seeker Pro - Compass EDM Erroneous Grid Convergence
      • Well Seeker Pro - Real Time Data Exchange Update
      • Well Seeker Pro - Slide Sheet Crash in v2.2.1.1
      • Well Seeker Pro - Slide Sheet Update
      • WSP & Innova Portal - Object Validation Feature
      • WSP - Solo Cloud Target Lines Update
      • WSP - Charts & WPC Improvements
      • WS - New Outlook Email Automation Unavailable
      • Well Seeker X: Displays Not Fully Visible
  • Development
    • Innova Cloud Portal (ICP) API
    • Accessing the API for Non-Programmers
Powered by GitBook
On this page
  • 1.0 - Introduction
  • 2.0 – Creating a Restricted Role
  • 3.0 – Assigning the Role to a User
  • 3.1 – Assigning to an Existing User
  • 3.2 – Creating a New User and Assigning a Role
  • 4.0 - Additional Access Tools in the Users Page
  • 4.1 – Access to Additional Operators
  • 4.1 – Well Restriction
  • 5.0 – Database Access

Was this helpful?

Export as PDF
  1. App & Portal Guides

Providing 3rd Party Access to Your Organizations Server Data

Guides a company administrator through creating a user on the Web Portal or Mobile App that is restricted to specific operators, products or features.

PreviousOasis Integration GuideNextWeb Portal Data Acquisition and EDR Guide

Last updated 5 months ago

Was this helpful?

1.0 - Introduction

Your organization may wish to give third parties permissions based access to your server database data, so that they can view progress on drilling projects etc., via the Innova Web Portal or the Innova Mobile App. To do this in a way that keeps your data secure and that respects the confidentiality of other clients, third party levels of access must be controlled.

The User Management section of the Web Portal contains options that allow you to customize the level of access for users viewing your organization’s data. Users can have their access customized in the following ways:

  • Their permission to create new data, and edit or delete existing data. Removing all permissions turns the user into a ‘view only’ user, who can view data but not edit it.

  • Their access can be restricted so that they can only view data for specific operators or wells.

  • Their access to Products & Features within the Web Portal and Mobile App can be restricted.

There are 2 different ways a third party user can be given access to a database:

  • The first way is to create a new user within your organization and assign the appropriate role to this user. In this situation, everything about this user is controlled by you as a company administrator.

  • The second way is to provide access to a user who already has login credentials for a different company. For example, an Operator may already have their own server database, where they have logins for all the appropriate members of their team. In this situation, it is possible to provide access to your companies database to one or all of these users. When doing this, the admin will assign an appropriate role and can restrict access to wells and features, but overall management of this user is controlled by their own admin.

This document will guide an admin through the process of adding a user in both of the above scenarios.

Note: To perform the steps in this guide, you must be logged into the Web Portal as a user that has Admin permission and access to the User Management feature. To check your available features and permissions, click on the icon in the top right of any page and select Profile.

2.0 – Creating a Restricted Role

User access is controlled through the creation and assignment of roles. A role is a set of user permissions that can be applied to multiple users. Follow the below steps to create a customized view only role that can then be applied to any user in your organization, and also any user from outside your organization:

  1. Click on the icon in the top left to open the main menu.

  2. In the main menu, scroll to the bottom and click on User Management, then click on Roles.

This will open the User Roles page.

  1. Create a new role by filling in the fields at the bottom of the page. Once you have filled in all three fields, the new role will be automatically added to the list. Double click on each field to edit it:

    1. In the Organization field, choose your company from the dropdown. There will only be one option available here.

    2. Enter a name for the new role in the Name field.

    3. Give your role a brief description in the Description field.

  1. Turn the new role into a view only role by toggling OFF the Admin, Edit, Delete, Create and Approve permissions. Users that are assigned a view only role will be able to view data in the portal but not make any changes to it.

  1. Restrict the operators that the new role can access by checking ON the operator(s) that you want to grant access to, while leaving the others toggled OFF. In this example, we are allowing the role to only view data related to the operator ‘Black Oil & Gold, LCC’. Click on Apply to save your settings. Note: Leaving all operators checked OFF will allow the role to access ALL operators.

  1. Choose which features the new role will have access to in the Web Portal and Mobile App by checking the checkboxes in their respective columns. Toggling on features in the Third Party column will allow users with the role to make API requests to the Innova API.

If you allow access to any features in a column, you must also check the Base feature at the top of each column.

Note: The only feature available for Well Seeker is the Base feature. Toggling this option off will prevent the user from logging into your organization’s server database via Well Seeker. This is recommended if you are setting up a viewer only user, as the permissions defined in step 4 do not apply to Well Seeker. Access to other features in Well Seeker are controlled by the user’s license and cannot be restricted via Roles. The assigned operator access will apply when the user logs into your organization’s remote server database via Well Seeker.

  1. Click on the Apply button in the Products and Features window to save your settings. Setup of the view only and operator restricted role is now complete. The next step is to assign the role to a user.

3.0 – Assigning the Role to a User

Now that the customized view only role has been created, it needs to be applied to a user.

3.1 – Assigning to an Existing User

  1. In the main menu, scroll to the bottom and click on User Management, then click on Users.

This will open the Users page.

  1. Double click in the Role column for the existing user. From the dropdown menu, select the restricted role that you created. This is why it is important to name your roles appropriately, as this list may have quite a number of options available to choose from.

  1. When the user next logs into the Web Portal or App, they will now be restricted to the operators and features permitted by their Role. They will also not have permission to make any changes to the data in the database.

3.2 – Creating a New User and Assigning a Role

  1. In the main menu, scroll to the bottom and click on User Management, then click on Users.

This will open the Users page.

  1. Create a new user by filling in the fields at the bottom of the page. Double click on each field to edit it:

    1. In the Organization field, choose your company from the dropdown. There will only be one option here.

    2. Enter an email address for the new user in the Username field. The username must be a valid email address.

    3. In the Password field, enter a temporary password. This must contain at least one uppercase letter, lowercase letter, number and symbol.

    4. In the RoleID field, select the restricted role that you created from the dropdown list.

    5. In the UnitPrefs field, select the default unit set for the new user. They can change this themselves after they log in.

  1. Before the new user creation can complete, you must toggle the Password Reset Required option on. This will force the new user to create their own password when they first log into the Web Portal. Once all of the required fields have been filled in, the new user will automatically be added to the list of users for your organization.

  1. When the user logs into the Web Portal or App, they will now be restricted to the operators and features permitted by their Role. They will also not have permission to make any changes to the data in the database.

4.0 - Additional Access Tools in the Users Page

Once a user has been assigned a role in the Users page, they can be granted access to additional operators beyond those defined by their role. They can also be restricted to specific wells, if required. To do so, follow the below steps:

4.1 – Access to Additional Operators

  1. Toggle ON operators that you want the user to be able to access. Click on Apply to save your changes. The chosen operators will be added to the permitted operators granted by the user’s role. In this example, the user’s role grants access to Black Oil & Gold, LLC, but this specific user has also been granted access to Venture E&P and Gold Resources.

  2. Click on Apply to save your changes.

4.1 – Well Restriction

  1. This will display a list of all wells contained under the operators that the user can access. The list can be filtered by typing in the search bar at the top of the list.

By default, the wells will all be toggled OFF. When this is the case, the user has access to ALL wells under the operators permitted by their role.

To restrict access for the user, toggle the wells you want them to be able to access ON. The user will now only be able to access wells that have been toggled on, and will not be able to access any wells that are toggled off.

  1. Click on Apply to save your changes.

5.0 – Database Access

The Database Access page allows the you to grant users from other organizations access to your organization's server database, using the Innova Web Portal. To grant a user access to your organization's server database, follow these instructions:

  1. In the main menu, scroll to the bottom and click on User Management, then click on Database Access.

  1. Enter a valid username from another organization into the UserName field at the bottom of the page. Note, that if the email address used here is not being used within another Organizations user management, then this process will not work.

Alternatively, you can grant access to all users registered under another organization by entering the organization's name. For example, typing Innova would grant access to all users in the Innova organization. This option removes the requirement to add lots of individual usernames, and ensures any new users are granted access automatically. Contact Innova directly to find out the correct nomenclature for any required organization.

  1. In the Organization field, select the organization that you want to grant the user access to. In most cases, you will only have your own organisation as an option here.

  1. In the RoleId field, choose the role that you wish to grant the user when they are viewing your organization.

Each row in the expanded section displays the following:

Organisation: The organisation that the user has been granted access to.

Role: The role the user has when accessing the organisation.

Access Granted By: The name of the admin in your organisation that gave the user access.

Access Granted Date: The date this user was granted access.

Once a user has been granted access to your organization’s server data, they will able to view wells from both their organization and yours on their Wells List page, when logged into the Web Portal.

Click on the icon to the left of the new role and select Operator Access.

Click on the icon to the left of the new role again and select Products & Features.

Click on the icon in the top left of the page to open the main menu.

Click on the icon in the top left to open the main menu.

In the Users page click on the icon to the left of the user, and select Operator Access.

In the Users page, click on the icon to the left of the user, and select Well Access.

Click on the icon in the top left to open the main menu.

If the user is successfully added, a row will be added to the table displaying their username and their source organisation to the page. Click on the icon to expand the user, displaying the organisation(s) that they have access to.

Delete: Clicking on the dustbin icon will revoke the user’s access to the organization.

For other pages, they can switch between their organization and yours by clicking on the icon in the top right of every page.