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.