Implement PAM gateway commands (#242)

Author: ukumar-ks

KeeperSdk/package-lock.json

@@ -24,7 +24,8 @@
         "prepublishOnly": "npm run build"
     },
     "dependencies": {
-        "@keeper-security/keeperapi": "18.1.0",
+        "@keeper-security/keeperapi": "18.1.1",
+        "@keeper-security/secrets-manager-core": "^17.5.0",
         "asmcrypto.js": "^2.3.2",
         "ts-node": "^10.7.0",
         "typescript": "^4.6.3"

KeeperSdk/package.json

@@ -277,7 +277,7 @@ export {
     UserActionStatus,
     UserActionSkipReason,
 } from './users/actionUser'
-
+export { AliasOperation } from './users/aliasUser'
 export {
     formatAddTeamResult,
     renderAddTeamAsciiTable,

KeeperSdk/src/api.ts

@@ -56,6 +56,7 @@ export {
     AuditReportErrorCode,
     ActionReportErrorCode,
     PasswordReportErrorCode,
+    PamErrorCode,
     KEEPER_PUBLIC_HOSTS,
     isBoolean,
     isString,
@@ -852,6 +853,78 @@ export type {
     NsfResolvedShareRecipient,
 } from './nestedShareFolders'
 
+export {
+    PamManager,
+    GatewayManager,
+    listGateways,
+    formatGatewaysTable,
+    renderGatewaysAsciiTable,
+    formatGatewaysJson,
+    formatGatewaysOutput,
+    createGateway,
+    editGateway,
+    removeGateway,
+    setGatewayMaxInstances,
+    GatewayListFormat,
+    GatewayStatus,
+    GatewayConfigInitFormat,
+    KSM_APP_RECORD_VERSION,
+    SUPPORTED_KSM_APP_RECORD_VERSIONS,
+    APP_NOT_ACCESSIBLE_LABEL,
+    KSM_CLIENT_ID_MESSAGE,
+    DEFAULT_GATEWAY_TOKEN_EXPIRES_IN_MIN,
+    MAX_GATEWAY_TOKEN_EXPIRES_IN_MIN,
+    MIN_GATEWAY_MAX_INSTANCES,
+    MAX_GATEWAY_MAX_INSTANCES,
+    EMPTY_GATEWAYS_MESSAGE,
+    GATEWAY_LIST_DEFAULT_HEADERS,
+    GATEWAY_LIST_VERBOSE_HEADERS,
+    getKeeperRouterBaseUrl,
+    webSafeUidFromBytes,
+    controllerUidsEqual,
+    toFiniteNumber,
+    formatTimestampMs,
+    parseGatewayVersionString,
+    getKsmApplicationDisplayInfo,
+    resolveKsmApplication,
+    getKeeperRegionAbbreviation,
+    formatGatewayOneTimeToken,
+    findEnterpriseGatewayByUidOrName,
+    requireEnterpriseGatewayByUidOrName,
+    fetchEnterprisePamControllers,
+    groupOnlineGatewaysByControllerUid,
+    isKeeperRouterConnectionError,
+} from './pam'
+export type {
+    ListGatewaysOptions,
+    GatewayCounts,
+    GatewayOsMetadata,
+    GatewayVersionParts,
+    GatewayPoolInstance,
+    GatewayListRow,
+    GatewayConnectivityStatus,
+    ListGatewaysResult,
+    FormattedGatewaysTable,
+    FormatGatewaysTableOptions,
+    RenderGatewaysAsciiTableOptions,
+    GatewayListFormatInput,
+    GatewayConfigInitFormatInput,
+    KsmApplicationDisplayInfo,
+    ResolvedKsmApplication,
+    CreateGatewayInput,
+    CreateGatewayResult,
+    EditGatewayInput,
+    EditGatewayResult,
+    RemoveGatewayInput,
+    RemoveGatewayResult,
+    SetGatewayMaxInstancesInput,
+    SetGatewayMaxInstancesResult,
+    GatewayJsonPoolInstance,
+    GatewayJsonEntry,
+    GatewaysJsonPayload,
+    KsmAppRecordVersion,
+} from './pam'
+
 export type {
     DRecord,
     DRecordMetadata,

KeeperSdk/src/index.ts

@@ -0,0 +1,74 @@
+import type { Auth } from '@keeper-security/keeperapi'
+import type { InMemoryStorage } from '../storage/InMemoryStorage'
+import { GatewayManager } from './gateway/GatewayManager'
+import type {
+    CreateGatewayInput,
+    CreateGatewayResult,
+    EditGatewayInput,
+    EditGatewayResult,
+    FormatGatewaysTableOptions,
+    FormattedGatewaysTable,
+    ListGatewaysOptions,
+    ListGatewaysResult,
+    RemoveGatewayInput,
+    RemoveGatewayResult,
+    RenderGatewaysAsciiTableOptions,
+    SetGatewayMaxInstancesInput,
+    SetGatewayMaxInstancesResult,
+} from './gateway/gatewayTypes'
+
+export type AuthProvider = () => Auth
+
+export class PamManager {
+    private readonly gatewayManager: GatewayManager
+
+    constructor(storage: InMemoryStorage, authProvider: AuthProvider) {
+        this.gatewayManager = new GatewayManager(storage, authProvider)
+    }
+
+    public getGatewayManager(): GatewayManager {
+        return this.gatewayManager
+    }
+
+    public async listGateways(options: ListGatewaysOptions = {}): Promise<ListGatewaysResult> {
+        return this.gatewayManager.listGateways(options)
+    }
+
+    public async createGateway(input: CreateGatewayInput): Promise<CreateGatewayResult> {
+        return this.gatewayManager.createGateway(input)
+    }
+
+    public async editGateway(input: EditGatewayInput): Promise<EditGatewayResult> {
+        return this.gatewayManager.editGateway(input)
+    }
+
+    public async removeGateway(input: RemoveGatewayInput): Promise<RemoveGatewayResult> {
+        return this.gatewayManager.removeGateway(input)
+    }
+
+    public async setGatewayMaxInstances(input: SetGatewayMaxInstancesInput): Promise<SetGatewayMaxInstancesResult> {
+        return this.gatewayManager.setGatewayMaxInstances(input)
+    }
+
+    public formatGatewaysTable(
+        result: ListGatewaysResult,
+        options: FormatGatewaysTableOptions = {}
+    ): FormattedGatewaysTable {
+        return this.gatewayManager.formatGatewaysTable(result, options)
+    }
+
+    public renderGatewaysAsciiTable(
+        table: FormattedGatewaysTable,
+        options: RenderGatewaysAsciiTableOptions = {}
+    ): string {
+        return this.gatewayManager.renderGatewaysAsciiTable(table, options)
+    }
+
+    public formatGatewaysJson(result: ListGatewaysResult, options: ListGatewaysOptions = {}): string {
+        return this.gatewayManager.formatGatewaysJson(result, options)
+    }
+
+    public formatGatewaysOutput(result: ListGatewaysResult, options: ListGatewaysOptions = {}): string {
+        return this.gatewayManager.formatGatewaysOutput(result, options)
+    }
+}