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
  • Introduction
  • 1.0 - Registering on Azure Portal
  • 2.0 - Configuring App Permission
  • 3.0 Additional setup to enable Multi Factor Authentication (MFA) logins

Was this helpful?

Export as PDF
  1. Innova ICP API Guides

Registering an OAuth App on Azure

Covers registration and configuration of an OAuth App on Microsoft Azure Portal

PreviousInnova ICP API GuidesNextRegistering an OAuth App on Okta

Last updated 1 year ago

Was this helpful?

Introduction

It is possible to register an OAuth app for the Microsoft Graph API from the . This document covers the steps required to register an app on the Azure Active Directory and configure permissions for it.

Input all data as per this document. Naming conventions are critical for this function to work successfully!

1.0 - Registering on Azure Portal

1. Go to the Microsoft Azure Portal home page at .

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

3. In the side menu, select Azure Active Directory.

4. In the Azure Active Directory window, click on App Registrations and then select New Registration.

5. In the Register an Application screen, enter the following information:

  • Name: ICPAPI

  • Supported Account Types: Accounts in this organizational directory only

Under the Redirect URL (optional section) enter the following:

  • Select a Platform: Web

  • Sign-On URL: Not required

Then click on the Register button at the bottom of the page.

6. On the newly created Overview page for the app take a copy of the Application (client) ID and the Directory (tenant) ID. Hover over each code and select the Copy to Clipboard option when it appears. Save these IDs in a secure location.

7. Create a new Client Secret: On the left of the page click on Certificates & Secrets. Then click on Client Secrets and New Client Secret.

8. In the window that opens on the right, enter the following:

  • Name (description): ICPAPI_Handshake

  • Expires: Choose an expiry date that suits you.

Click Add- A new Client Secret will be generated for you. This will be the only time you will see the Client Secret Value, so you better copy it to a secured location otherwise you won't be able to retrieve it again! Click on the Copy to Clipboard icon to the right of the Client Secret Value to copy it.

2.0 - Configuring App Permission

Note: These steps require the user to have admin permissions in their organisation’s Azure Portal.

If the user has navigated away from the App Overview page, they can return to it by clicking on the icon in the top left of the page to open the side menu. Then select Azure Active Directory. In the Azure Active Directory select App registrations from the menu on the left and then select ICPAPI from the list.

1. From the App Overview page, select API Permissions and then Add a Permission.

2. In the window that opens on the right, click on Microsoft Graph.

3. Click on Delegated Permissions. To select a permission, search for it in the search bar and then click on the check box to the left of its name. Select these two permissions:

  • User.Read.All

  • Application.Read.All

Click on the Add Permissions button to add the selected permissions.

4. In the API Permissions window, click on Grant admin consent for Innova Drilling & Intervention.

5. In the menu on the left, click on Expose an API and then Add a Scope

6. In the window that opens on the right, click on Save and Continue.

7. On the next page enter the following information and then click on Add Scope:

  • Scope name: allow_user

  • Who can consent: Admins and users

  • The display name and description entries are optional. Enter a name/description that you want admins and users to see when the consent to the scope later.

  • State: Enabled.

8. In the menu on the left click on API Permissions and then Add a permission.

9. In the window that opens on the right, select My APIs and then click on your App/API.

10. Select the scope you just created by ticking the check box next to it, and then click on Add Permissions.

3.0 Additional setup to enable Multi Factor Authentication (MFA) logins

If your organization wishes to have MFA logins turned on for the Innova Web Portal, Mobile App and Well Seeker Pro server database logins, then they must first follow the below steps within Azure Active Directory. In addition to these steps, the system admin will require to turn on MFA for the organization, or for individual users within Azure Active Directory. For that process the user should refer to Azure Active Directory documentation.

1. Once logged on to Azure Active Directory select Home > App registration > ICPAPI > Authentication.

2. Use the call back URI for the single page web app. In the Single-page application section add the below URIs by selecting Add URI.

  • https://www.icpwebportal.com

  • https://icpwebportal.com

  • https://eu.icpwebportal.com

3. In the Mobile and desktop applications section ensure that the URI below is available, if not add it. Check the selection box to select it.

  • https://login.microsoftonline.com/common/oauth2/nativeclient

4. In the Mobile and desktop applications section add the below URI.

  • com.icds-innova-dan://auth

5. Scroll down to the Implicit grant and hybrid flows section. This is to turn on access tokens for authorization endpoint. Select the check boxes for the Access tokens and ID tokens options.

6. Select the Expose an API section.

7. Select Add a scope and input the below details and then select Add scope.

  • Scope Name: icpapi_read

  • Who can consent: Admins and users

  • Admin consent display name: Read icp api

  • User consent display name: icpapi read

  • State: Enabled

https://portal.azure.com