Session interface for maintaining cookie and protocol information

export
interface

  ISession

### Hierarchy

- ISession

## Index

### Properties

- authTypeOrder
- base64EncodedAuth
- basePath
- cert
- certKey
- checkServerIdentity
- hostname
- passphrase
- password
- port
- protocol
- proxy
- rejectUnauthorized
- secureProtocol
- serverCertificate
- storeCookie
- strictSSL
- tokenType
- tokenValue
- type
- user

## Properties

### Optional authTypeOrder

authTypeOrder: string[]

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:188

Specifies the order of precedence for using different authentication types in this session. The order in the array determines which credential type is preferred. The type in authTypeOrder[0] is used first, authTypeOrder[1] second, etc. Values are specified using SessConstants.AUTH_TYPE_XXX values.

The authTypeOrder property is currently controlled (hard-coded) within Zowe SDK functions. More control for Zowe consumers is anticipated in the future.

memberof

  ISession

### Optional base64EncodedAuth

base64EncodedAuth: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:94

Base 64 encoded authentication materials created by base 64 encoding: Basic :

memberof

  ISession

### Optional basePath

basePath: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:70

The base path (or first part) of the resources that we will access. It is used to specify the first part of the resource in a URL that points to any API mediation layer, gateway, or router used at a site to dispatch web requests to services that are managed by that gateway. It is pre-pended to the resource path of the underlying service. When not supplied, or is an empty string we use the the resource path of the underlying service directly.

memberof

  ISession

### Optional cert

cert: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:123

The file path to the client certificate to use for authentication

memberof

  ISession

### Optional certKey

certKey: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:130

The file path to the client certificate's key to use for authentication

memberof

  ISession

### Optional checkServerIdentity

checkServerIdentity: (host: string, cert: object) => Error | undefined

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:158

todo

memberof

  ISession

#### Type declaration

- - (host: string, cert: object): Error | undefined

  - #### Parameters

    - ##### host: string

    - ##### cert: object

    #### Returns Error | undefined

### Optional hostname

hostname: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:27

Host to get data from, not including http(s) from a URL, e.g. jsonplaceholder.typicode.com

memberof

  ISession

### Optional passphrase

passphrase: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:137

The passphrase used to access the client certificate, if in PFX format

memberof

  ISession

### Optional password

password: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:50

Password

memberof

  ISession

### Optional port

port: number

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:36

Port to obtain data from 80 is the default for http 443 is the default 443 for https

memberof

  ISession

### Optional protocol

protocol: SessConstants.HTTP_PROTOCOL_CHOICES

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:57

Currently only HTTPS is supported

memberof

  ISession

### Optional proxy

proxy: ProxyVariables

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:197

Specifies external proxy settings values will override environment variable proxy settings

memberof

  ISession

### Optional rejectUnauthorized

rejectUnauthorized: boolean

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:116

The following options map to TLS options available within the node.js TLS APIs, please see the official Node.js documentation for these fields

memberof

  ISession

### Optional secureProtocol

secureProtocol: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:165

Default is SSLv23_method

memberof

  ISession

### Optional serverCertificate

serverCertificate: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:144

todo

memberof

  ISession

### Optional storeCookie

storeCookie: boolean

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:174

Decide whether or not to store a returned cookie. Only applies to certificates for now.

memberof

  ISession

### Optional strictSSL

strictSSL: boolean

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:151

see node.js api

memberof

  ISession

### Optional tokenType

tokenType: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:101

Type of token in `tokenValue`, e.g. LTPA2

memberof

  ISession

### Optional tokenValue

tokenValue: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:108

Token value of type `tokenType`

memberof

  ISession

### Optional type

type: SessConstants.AUTH_TYPE_CHOICES

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:86

Type of authentication, none is default "none" - no authorization header is used "basic" - use basic auth for every request "bearer" - use bearer auth for every request. Indicates use token value provided. "token" - use cookie auth for every request. Indicates use token value provided and check for timeout / expiration if not token is provided, basic auth is used and the tokenType is obtained from the cookie header and stored as a token value to be used on subsequent requests

memberof

  ISession

### Optional user

user: string

- Defined in @zowe/imperative/src/rest/src/session/doc/ISession.ts:43

User name for logging in

memberof

  ISession

Generated using TypeDoc