WITSML Browser - Connections

Documentation > User Guide > WITSML Browser > Settings

Connections enable setting up and establishing a connection to a WITSML server. It also enables querying a server's supported version.

Connect to an Existing Connection

  • Click "Select Connection..."
  • Select existing connection
Add a Connection using Basic Authentication

  • Click "Select Connection..."
  • Select "(Add New Connection)"
  • Enter the following
    • Name - a unique name for this connection
    • URL - web address of the WITSML server
    • User Name - name of user
    • Password - password of user
    • Optionally check "Pre-Authenticate" to send the Authorization header with every web request
  • Click "Test" to test the connection
  • Click "OK" to save and connect
Add a Connection using JSON Web Token (JWT)

  • Click "Select Connection..."
  • Select "(Add New Connection)"
  • Click "Bearer"
  • Enter the following
    • Name - a unique name for this connection
    • URL - web address of the WITSML server
    • Optionally click on [...] button next to the Bearer authentication option to retrieve a JSON Web Token from a Token Provider Service
    • Optionally check "Pre-Authenticate" to send the Authorization header with every web request
  • Enter token in JWT box
  • Click "Test" to test the connection
  • Click "OK" to save and connect
Retrieve a JSON Web Token (JWT) from a Token Provider Service

  • Click on [...] button next to the Bearer authentication option
  • Enter the following
    • Name - a unique name for this connection
    • URL - web address of the WITSML server
    • User Name - name of user
    • Password - password of user
    • Optionally check "Pre-Authenticate" to send the Authorization header with every web request
  • Click "Test" to test the connection
  • Click "OK" to retrieve JSON Web Token
Add Proxy Authentication

  • Click "Proxy" to add a proxy to use for the connection
  • Enter the following
    • Host - the hostname or IP address of the proxy server
    • Port - the port number used by the proxy server for client connections
    • User Name - name of user
    • Password - password of user
    • Optionally check "Use Default Credentials" to use the current windows proxy user credentials
  • Click "Test" to test the connection
  • Click "OK" to save and connect
Select Security Protocols

  • Click "Security" to select security protocols
  • Select from the following
    • TLS 1.2 - Transport Layer Security protocol defined in RFC 5246 in August 2008
    • TLS 1.1 - Transport Layer Security protocol defined in RFC 4346 in April 2006
    • TLS 1.0 - Transport Layer Security protocol defined in RFC 2246 in January 1999
    • SSL 3.0 - Secure Sockets Layer protocol
    • Optionally check "Accept Invalid Certificates" to accept all server certificates regardless of validity
  • Click "Test" to test the connection
  • Click "OK" to save and connect
Edit a Connection
  • Click "Select Connection..."
  • Click "edit" for the connection you would like to edit.
  • Update the connection
  • Click "Test" to test the connection
  • Click "OK" to save and connect
Delete a Connection
  • Click "Select Connection..."
  • Click "delete" for the connection you would like to delete.
  • Click "OK" when prompted "Are you sure you want to delete the connection?"
Select a Version

After connecting to a WITSML server, all supported versions will be listed with the most current version selected by default. To select another version, follows these steps.

  • Click Version drop-down
  • Select a version

The Results tab will display the server capabilities of the selected version.

Documentation > User Guide > WITSML Browser > Settings