feat(client-workspaces-web): WorkSpaces Secure Browser now enables Ad…

…ministrators to view and manage end-user browsing sessions via Session Management APIs.
aws · Sep 19, 2024 · 7913a4b · 7913a4b
1 parent 0b63507
commit 7913a4b
Show file tree

Hide file tree

Showing 14 changed files with 1,586 additions and 165 deletions.
diff --git a/clients/client-workspaces-web/README.md b/clients/client-workspaces-web/README.md
@@ -6,12 +6,13 @@
 
 AWS SDK for JavaScript WorkSpacesWeb Client for Node.js, Browser and React Native.
 
-<p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built specifically to facilitate
-secure, web-based workloads. WorkSpaces Secure Browser makes it easy for customers to safely provide
-their employees with access to internal websites and SaaS web applications without the
-administrative burden of appliances or specialized client software. WorkSpaces Secure Browser provides
-simple policy tools tailored for user interactions, while offloading common tasks like
-capacity management, scaling, and maintaining browser images.</p>
+<p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built
+specifically to facilitate secure, web-based workloads. WorkSpaces Secure Browser makes it
+easy for customers to safely provide their employees with access to internal websites and
+SaaS web applications without the administrative burden of appliances or specialized client
+software. WorkSpaces Secure Browser provides simple policy tools tailored for user
+interactions, while offloading common tasks like capacity management, scaling, and
+maintaining browser images.</p>
 
 ## Installing
 
@@ -431,6 +432,14 @@ DisassociateUserSettings
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/DisassociateUserSettingsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/DisassociateUserSettingsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/DisassociateUserSettingsCommandOutput/)
 
+</details>
+<details>
+<summary>
+ExpireSession
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/ExpireSessionCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ExpireSessionCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ExpireSessionCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -479,6 +488,14 @@ GetPortalServiceProviderMetadata
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/GetPortalServiceProviderMetadataCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/GetPortalServiceProviderMetadataCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/GetPortalServiceProviderMetadataCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetSession
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/GetSessionCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/GetSessionCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/GetSessionCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -551,6 +568,14 @@ ListPortals
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/ListPortalsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ListPortalsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ListPortalsCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListSessions
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/ListSessionsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ListSessionsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ListSessionsCommandOutput/)
+
 </details>
 <details>
 <summary>

diff --git a/clients/client-workspaces-web/src/WorkSpacesWeb.ts b/clients/client-workspaces-web/src/WorkSpacesWeb.ts
@@ -142,6 +142,11 @@ import {
  DisassociateUserSettingsCommandInput,
  DisassociateUserSettingsCommandOutput,
 } from "./commands/DisassociateUserSettingsCommand";
+import {
+ ExpireSessionCommand,
+ ExpireSessionCommandInput,
+ ExpireSessionCommandOutput,
+} from "./commands/ExpireSessionCommand";
 import {
  GetBrowserSettingsCommand,
  GetBrowserSettingsCommandInput,
@@ -168,6 +173,7 @@ import {
  GetPortalServiceProviderMetadataCommandInput,
  GetPortalServiceProviderMetadataCommandOutput,
 } from "./commands/GetPortalServiceProviderMetadataCommand";
+import { GetSessionCommand, GetSessionCommandInput, GetSessionCommandOutput } from "./commands/GetSessionCommand";
 import {
  GetTrustStoreCertificateCommand,
  GetTrustStoreCertificateCommandInput,
@@ -209,6 +215,11 @@ import {
  ListNetworkSettingsCommandOutput,
 } from "./commands/ListNetworkSettingsCommand";
 import { ListPortalsCommand, ListPortalsCommandInput, ListPortalsCommandOutput } from "./commands/ListPortalsCommand";
+import {
+ ListSessionsCommand,
+ ListSessionsCommandInput,
+ ListSessionsCommandOutput,
+} from "./commands/ListSessionsCommand";
 import {
  ListTagsForResourceCommand,
  ListTagsForResourceCommandInput,
@@ -311,12 +322,14 @@ const commands = {
  DisassociateTrustStoreCommand,
  DisassociateUserAccessLoggingSettingsCommand,
  DisassociateUserSettingsCommand,
+ ExpireSessionCommand,
  GetBrowserSettingsCommand,
  GetIdentityProviderCommand,
  GetIpAccessSettingsCommand,
  GetNetworkSettingsCommand,
  GetPortalCommand,
  GetPortalServiceProviderMetadataCommand,
+ GetSessionCommand,
  GetTrustStoreCommand,
  GetTrustStoreCertificateCommand,
  GetUserAccessLoggingSettingsCommand,
@@ -326,6 +339,7 @@ const commands = {
  ListIpAccessSettingsCommand,
  ListNetworkSettingsCommand,
  ListPortalsCommand,
+ ListSessionsCommand,
  ListTagsForResourceCommand,
  ListTrustStoreCertificatesCommand,
  ListTrustStoresCommand,
@@ -809,6 +823,17 @@ export interface WorkSpacesWeb {
  cb: (err: any, data?: DisassociateUserSettingsCommandOutput) => void
  ): void;
 
+ /**
+ * @see {@link ExpireSessionCommand}
+ */
+ expireSession(args: ExpireSessionCommandInput, options?: __HttpHandlerOptions): Promise<ExpireSessionCommandOutput>;
+ expireSession(args: ExpireSessionCommandInput, cb: (err: any, data?: ExpireSessionCommandOutput) => void): void;
+ expireSession(
+ args: ExpireSessionCommandInput,
+ options: __HttpHandlerOptions,
+ cb: (err: any, data?: ExpireSessionCommandOutput) => void
+ ): void;
+
  /**
  * @see {@link GetBrowserSettingsCommand}
  */
@@ -905,6 +930,17 @@ export interface WorkSpacesWeb {
  cb: (err: any, data?: GetPortalServiceProviderMetadataCommandOutput) => void
  ): void;
 
+ /**
+ * @see {@link GetSessionCommand}
+ */
+ getSession(args: GetSessionCommandInput, options?: __HttpHandlerOptions): Promise<GetSessionCommandOutput>;
+ getSession(args: GetSessionCommandInput, cb: (err: any, data?: GetSessionCommandOutput) => void): void;
+ getSession(
+ args: GetSessionCommandInput,
+ options: __HttpHandlerOptions,
+ cb: (err: any, data?: GetSessionCommandOutput) => void
+ ): void;
+
  /**
  * @see {@link GetTrustStoreCommand}
  */
@@ -1047,6 +1083,17 @@ export interface WorkSpacesWeb {
  cb: (err: any, data?: ListPortalsCommandOutput) => void
  ): void;
 
+ /**
+ * @see {@link ListSessionsCommand}
+ */
+ listSessions(args: ListSessionsCommandInput, options?: __HttpHandlerOptions): Promise<ListSessionsCommandOutput>;
+ listSessions(args: ListSessionsCommandInput, cb: (err: any, data?: ListSessionsCommandOutput) => void): void;
+ listSessions(
+ args: ListSessionsCommandInput,
+ options: __HttpHandlerOptions,
+ cb: (err: any, data?: ListSessionsCommandOutput) => void
+ ): void;
+
  /**
  * @see {@link ListTagsForResourceCommand}
  */
@@ -1286,12 +1333,13 @@ export interface WorkSpacesWeb {
 }
 
 /**
- * <p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built specifically to facilitate
- * secure, web-based workloads. WorkSpaces Secure Browser makes it easy for customers to safely provide
- * their employees with access to internal websites and SaaS web applications without the
- * administrative burden of appliances or specialized client software. WorkSpaces Secure Browser provides
- * simple policy tools tailored for user interactions, while offloading common tasks like
- * capacity management, scaling, and maintaining browser images.</p>
+ * <p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built
+ * specifically to facilitate secure, web-based workloads. WorkSpaces Secure Browser makes it
+ * easy for customers to safely provide their employees with access to internal websites and
+ * SaaS web applications without the administrative burden of appliances or specialized client
+ * software. WorkSpaces Secure Browser provides simple policy tools tailored for user
+ * interactions, while offloading common tasks like capacity management, scaling, and
+ * maintaining browser images.</p>
  * @public
  */
 export class WorkSpacesWeb extends WorkSpacesWebClient implements WorkSpacesWeb {}

diff --git a/clients/client-workspaces-web/src/WorkSpacesWebClient.ts b/clients/client-workspaces-web/src/WorkSpacesWebClient.ts
@@ -147,6 +147,7 @@ import {
  DisassociateUserSettingsCommandInput,
  DisassociateUserSettingsCommandOutput,
 } from "./commands/DisassociateUserSettingsCommand";
+import { ExpireSessionCommandInput, ExpireSessionCommandOutput } from "./commands/ExpireSessionCommand";
 import { GetBrowserSettingsCommandInput, GetBrowserSettingsCommandOutput } from "./commands/GetBrowserSettingsCommand";
 import {
  GetIdentityProviderCommandInput,
@@ -162,6 +163,7 @@ import {
  GetPortalServiceProviderMetadataCommandInput,
  GetPortalServiceProviderMetadataCommandOutput,
 } from "./commands/GetPortalServiceProviderMetadataCommand";
+import { GetSessionCommandInput, GetSessionCommandOutput } from "./commands/GetSessionCommand";
 import {
  GetTrustStoreCertificateCommandInput,
  GetTrustStoreCertificateCommandOutput,
@@ -189,6 +191,7 @@ import {
  ListNetworkSettingsCommandOutput,
 } from "./commands/ListNetworkSettingsCommand";
 import { ListPortalsCommandInput, ListPortalsCommandOutput } from "./commands/ListPortalsCommand";
+import { ListSessionsCommandInput, ListSessionsCommandOutput } from "./commands/ListSessionsCommand";
 import {
  ListTagsForResourceCommandInput,
  ListTagsForResourceCommandOutput,
@@ -271,12 +274,14 @@ export type ServiceInputTypes =
  | DisassociateTrustStoreCommandInput
  | DisassociateUserAccessLoggingSettingsCommandInput
  | DisassociateUserSettingsCommandInput
+ | ExpireSessionCommandInput
  | GetBrowserSettingsCommandInput
  | GetIdentityProviderCommandInput
  | GetIpAccessSettingsCommandInput
  | GetNetworkSettingsCommandInput
  | GetPortalCommandInput
  | GetPortalServiceProviderMetadataCommandInput
+ | GetSessionCommandInput
  | GetTrustStoreCertificateCommandInput
  | GetTrustStoreCommandInput
  | GetUserAccessLoggingSettingsCommandInput
@@ -286,6 +291,7 @@ export type ServiceInputTypes =
  | ListIpAccessSettingsCommandInput
  | ListNetworkSettingsCommandInput
  | ListPortalsCommandInput
+ | ListSessionsCommandInput
  | ListTagsForResourceCommandInput
  | ListTrustStoreCertificatesCommandInput
  | ListTrustStoresCommandInput
@@ -334,12 +340,14 @@ export type ServiceOutputTypes =
  | DisassociateTrustStoreCommandOutput
  | DisassociateUserAccessLoggingSettingsCommandOutput
  | DisassociateUserSettingsCommandOutput
+ | ExpireSessionCommandOutput
  | GetBrowserSettingsCommandOutput
  | GetIdentityProviderCommandOutput
  | GetIpAccessSettingsCommandOutput
  | GetNetworkSettingsCommandOutput
  | GetPortalCommandOutput
  | GetPortalServiceProviderMetadataCommandOutput
+ | GetSessionCommandOutput
  | GetTrustStoreCertificateCommandOutput
  | GetTrustStoreCommandOutput
  | GetUserAccessLoggingSettingsCommandOutput
@@ -349,6 +357,7 @@ export type ServiceOutputTypes =
  | ListIpAccessSettingsCommandOutput
  | ListNetworkSettingsCommandOutput
  | ListPortalsCommandOutput
+ | ListSessionsCommandOutput
  | ListTagsForResourceCommandOutput
  | ListTrustStoreCertificatesCommandOutput
  | ListTrustStoresCommandOutput
@@ -537,12 +546,13 @@ export type WorkSpacesWebClientResolvedConfigType = __SmithyResolvedConfiguratio
 export interface WorkSpacesWebClientResolvedConfig extends WorkSpacesWebClientResolvedConfigType {}
 
 /**
- * <p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built specifically to facilitate
- * secure, web-based workloads. WorkSpaces Secure Browser makes it easy for customers to safely provide
- * their employees with access to internal websites and SaaS web applications without the
- * administrative burden of appliances or specialized client software. WorkSpaces Secure Browser provides
- * simple policy tools tailored for user interactions, while offloading common tasks like
- * capacity management, scaling, and maintaining browser images.</p>
+ * <p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built
+ * specifically to facilitate secure, web-based workloads. WorkSpaces Secure Browser makes it
+ * easy for customers to safely provide their employees with access to internal websites and
+ * SaaS web applications without the administrative burden of appliances or specialized client
+ * software. WorkSpaces Secure Browser provides simple policy tools tailored for user
+ * interactions, while offloading common tasks like capacity management, scaling, and
+ * maintaining browser images.</p>
  * @public
  */
 export class WorkSpacesWebClient extends __Client<

diff --git a/clients/client-workspaces-web/src/commands/CreateUserAccessLoggingSettingsCommand.ts b/clients/client-workspaces-web/src/commands/CreateUserAccessLoggingSettingsCommand.ts
@@ -37,7 +37,8 @@ export interface CreateUserAccessLoggingSettingsCommandOutput
  __MetadataBearer {}
 
 /**
- * <p>Creates a user access logging settings resource that can be associated with a web portal.</p>
+ * <p>Creates a user access logging settings resource that can be associated with a web
+ * portal.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript